diff --git a/.env.example b/.env.example
index 3b924f6..3f69bdb 100644
--- a/.env.example
+++ b/.env.example
@@ -7,8 +7,6 @@ TREX_POSTGRESQL_DSN=dbname=trex_core host=/var/run/postgresql
# --- Daemon (optional, defaults shown) ---
TREX_TOTAL_SLOTS=10
-TREX_API_HOST=127.0.0.1
-TREX_API_PORT=8080
# Background execution loop tick interval (seconds).
TREX_EXECUTION_INTERVAL_SEC=1.0
@@ -38,3 +36,9 @@ TREX_PORTFOLIO_HUB_TOKEN=
TREX_PORTFOLIO_HUB_TIMEOUT=5
# Ledger outbox writer tick interval (seconds).
TREX_LEDGER_INTERVAL_SEC=1.0
+
+# --- RabbitMQ transport (REQ-022, BAT-007) ---
+# trex-core ↔ 전략 모듈 통신은 RabbitMQ(AMQP) 메시지 기반 (HTTP /v1 API 는 제거됨).
+# 미설정이면 데몬은 InMemoryTransport stub 으로 기동(개발/CI 용; 전략과 통신 불가).
+TREX_RABBITMQ_URL=
+TREX_RABBITMQ_TIMEOUT=5
diff --git a/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/design.md b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/design.md
new file mode 100644
index 0000000..fc7aa12
--- /dev/null
+++ b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/design.md
@@ -0,0 +1,56 @@
+# BAT-007 Design
+
+- Status: draft
+- Batch: BAT-007
+
+## Architecture Summary
+- 기존 FastAPI/uvicorn HTTP `/v1` 어댑터를 제거하고, trex-core ↔ 전략 모듈 통신을 **RabbitMQ(AMQP) 기반 메시지 transport** 로 전환한다. **application** 에 `MessagingTransport` Protocol 을 두고, **adapters/messaging** 에 `RabbitMQTransport`(`pika` 동기) 와 `InMemoryTransport`(stub) 구현체를, **runtime** 에 sync+thread daemon(consumer/execution/ledger 스레드 + 이벤트 publisher) 구성을 둔다. 토폴로지는 3 패턴(스냅샷 RPC + intent admission RPC + 이벤트 topic) 이며, intent 는 슬롯 Postgres durable commit 후 ack + correlation_id dedup 으로 effectively-once 효과를 낸다. broker 장애 시 어댑터의 connection 상태가 application 레이어로 노출되어 신규 매매를 보수적으로 중단한다(버퍼링 0). HTTP 표면은 `healthz` 포함 0 으로 떨어지고 liveness 는 프로세스 감독이 담당한다.
+
+## Changed Areas
+- Docs: interface-contract(메시지 계약 + 어댑터 신선도 노출, HTTP `/v1` 제거), runtime-flows(스냅샷 RPC / intent RPC / 이벤트 발행·구독 / degrade 분기 / 스레드 구성 / HTTP 흐름 제거), project-structure(adapters/messaging 신설, adapters/api 제거, runtime/daemon 의 스레드 구성과 의존성 변경).
+- Modules:
+ - application: 신규 `messaging.py`(`MessagingTransport` Protocol + RPC 요청/응답 DTO + 이벤트 DTO). 기존 `intents.py`/(dcy-005 스냅샷 서비스 자리) 는 transport-무관 호출 인자만 받는다.
+ - adapters/messaging: 신규 패키지. `topology.py`(exchange/queue/binding/routing-key 상수 + 매핑 헬퍼), `in_memory.py`(결정론 stub), `rabbitmq.py`(pika BlockingConnection 기반 publish/subscribe/RPC, 스레드별 channel, 재연결 백오프).
+ - adapters/api: **제거** (`app.py`, `schemas.py`, `__init__.py`).
+ - runtime: `config.py` 에 `RabbitMQConfig(url, timeout)` 추가, `TREX_RABBITMQ_URL` 로딩, `TREX_API_HOST`/`TREX_API_PORT` 폐기. `daemon.py` 에서 uvicorn import/실행 제거, FastAPI base 제거, intent RPC consumer 스레드 + snapshot RPC consumer 스레드 추가, 기존 execution/ledger 스레드 유지, graceful shutdown 에 connection close 포함.
+ - persistence: 변경 없음 (intent_log 를 dedup 게이트로 재사용; 단, RabbitMQ consumer 전용 dedup 컬럼이 필요하면 design 결정 1 참조).
+ - pyproject: `pika>=1.3` 추가, `fastapi`/`uvicorn` 제거 (httpx 는 ledger 어댑터가 유지).
+- Interfaces: `MessagingTransport.publish_event(routing_key, payload, mandatory=True)`, `MessagingTransport.consume_rpc(queue, handler)`, `MessagingTransport.call_rpc(queue, payload, timeout)`, 그리고 토폴로지 상수 + routing-key 빌더.
+
+## Key Decisions
+1. **dedup 게이트 = intent_log 재사용(dcy-003/REQ-007 멱등 게이트 직접 활용)**. RabbitMQ intent consumer 는 `correlation_id`(= intent 멱등키, dcy-003 패턴)를 `IntentStore.try_insert`(application port) 의 `intent_id` 로 그대로 사용해 단일 dedup 진실원을 유지한다. consumer 전용 dedup table 은 두지 않는다 — at-least-once 재전달 시 두 번째 호출은 `try_insert==False` 로 끝나 슬롯 전이 0, 첫 결과를 그대로 response 로 회신한다. (장점: 새 스키마 0, 기존 멱등 가드 직접 활용. 단점: intent admission RPC 외 다른 RPC 가 늘면 별도 dedup 전략 필요 — 본 batch 범위에서는 intent + read-only snapshot 만 있어 충분.)
+2. **ack-after-commit 시퀀스**: intent consumer 는 (a) `IntentService.submit_buy/sell` 호출 → (b) Postgres durable commit 안에서 `intent_log` row 와 슬롯 전이가 함께 atomically commit → (c) reply-to 큐로 admission 응답 publish → (d) 메시지 manual ack. (b)와 (c) 사이 크래시는 재전달 시 (1) 의 dedup 으로 재실행되지 않고, (c)와 (d) 사이 크래시는 재전달 시 같은 응답을 다시 보내고 ack — 동일 `correlation_id` 응답은 호출자가 dedup. publisher confirms 로 reply publish 의 broker 수락을 확인.
+3. **단일 consumer + prefetch=1**: intent RPC consumer 는 단일 스레드 + `basic_qos(prefetch_count=1)` 로 FIFO 보장(불변식 A 단일 writer 와 정합). snapshot RPC consumer 는 read-only 이므로 prefetch>1 허용 가능하지만 본 batch 는 단일 + prefetch=1 로 일관성 우선.
+4. **이벤트 페이로드 = 현재 상태 + 단조 시퀀스(슬롯 `updated_at` 또는 별도 version 컬럼)**. delta 가 아니라 last-wins 가능한 스냅샷을 운반해 순서 보증 불요. 미수신/중복은 스냅샷 RPC reconcile 로 보정. `daily_slot.updated_at` 을 시퀀스로 사용(이미 존재, 새 컬럼 0).
+5. **publisher confirms + DLQ**: 이벤트 publisher 는 `confirm_delivery()` 모드 + `basic_publish(mandatory=True)`. 발행 거부(NACK) 또는 unroutable 은 별도 `trex.events.dlq` 큐로 라우팅, last_error 로그. intent RPC reply publish 도 동일.
+6. **per-strategy durable queue + TTL/max-length**: 전략별 이벤트 queue 는 durable, queue 인자 `x-message-ttl=3600000`(1h) + `x-max-length=10000` + `x-overflow=drop-head`(drop-oldest). 초과/만료는 스냅샷 RPC reconcile 로 회복.
+7. **재연결 백오프 상태 머신**: `connected → disconnected(트리거: socket error/heartbeat timeout) → reconnecting(백오프 1s,2s,4s,8s,...,30s cap) → connected`. 재연결 성공 후 토폴로지 재선언 + consumer rebind 책임은 어댑터 내부. application 레이어는 `transport.health()` 로 enum 조회.
+8. **스레드별 channel + add_callback_threadsafe**: pika `BlockingConnection` 은 thread-safe 가 아니므로 (a) 각 consumer 스레드는 자기 connection+channel 을 소유하고 (b) execution/ledger 스레드의 이벤트 발행은 publisher 스레드 channel 의 `add_callback_threadsafe` 로 enqueue 한다. 또는 별도 publisher worker 스레드 도입 — design 검토 후 단순화를 위해 publisher worker 스레드 1개 + queue 기반 cross-thread enqueue 채택.
+9. **HTTP 표면 0 회귀 가드**: 데몬 lifecycle 테스트가 기동 후 `import trex_core.runtime.daemon` 결과에 `fastapi`/`uvicorn`/`starlette` import 가 없음을 정적 가드로 검사. 추가로 포트 스캔(socket bind 0 검증) 통합 테스트(미가용 시 skip).
+10. **broker outage = transport.health() != connected 일 때 application 분기**. `IntentService` 진입점은 변경하지 않고, 새 `intent RPC consumer` 가 message 를 수신해도 transport.health() == disconnected 면 reply publish 가 어차피 실패 → 그 경우 메시지 reject(requeue=False) + DLQ 로 격리(전략은 timeout 으로 감지 후 보류). 스냅샷 RPC 도 동일. **버퍼링 금지**: 어댑터에 로컬 outbox 를 두지 않는다(ledger outbox 는 별도 — broker→ledger 가 아니라 core→portfolio-hub 방향이라 영향 없음).
+
+## Edge Cases
+- 동일 `correlation_id` 의 intent 메시지가 재전달 → `intent_log.try_insert==False` → 기존 결과 fetch 후 reply, 슬롯 전이 0.
+- intent commit 직후 reply publish 전 크래시 → 재기동 후 메시지 재전달 → dedup 으로 같은 reply 재전송 → 호출자 dedup. 응답은 같은 `correlation_id`.
+- pika connection drop 도중 publish/consume → 자동 재연결 백오프 + 채널 재선언 + consumer rebind. 미전송 message 는 broker 가 redeliver 시 dedup.
+- 전략 queue down 중 trex-core 이벤트 발행 → durable queue 가 catch-up 보관 → 전략 복구 시 수신. TTL/max-length 초과분은 drop-oldest + reconcile.
+- portfolio-hub 가 아닌 RabbitMQ 가 down → 신규 intent 거부(requeue=False + DLQ) + 스냅샷 RPC timeout → 전략 보류. core 자율 안전 매도(미구현, A-5)는 transport 와 독립 동작 전제.
+- 전략 모듈 미전환 상태에서 cut-over 시 통신 단절 → release 단계 cut-over 순서(전략 모듈 → trex-core release) 합의 + stub 사전 검증으로 회피(R-2).
+- HTTP 클라이언트(이전 전략 모듈/외부 tool)가 옛 `POST /v1/intents/buy` 호출 시도 → connection refused (HTTP 표면 0). release notes 에 cut-over 경고 명시.
+
+## Architecture Impact
+- both (project-structure + runtime-flows). interface-contract 도 갱신한다(메시지 계약 + HTTP `/v1` 제거).
+
+## Reference Doc Update Plan
+- project-structure.md:
+ - 트리에서 `trex_core/adapters/api/` 제거, `trex_core/adapters/messaging/` (`topology.py`, `rabbitmq.py`, `in_memory.py`) 추가.
+ - `trex_core/application/messaging.py` (Protocol + DTO) 추가.
+ - runtime/daemon 의 스레드 구성(intent RPC + snapshot RPC + execution + ledger + publisher worker) 반영.
+ - 의존성 변경(`pika` 추가, `fastapi`/`uvicorn` 제거) 반영.
+- runtime-flows.md:
+ - 기존 매수/매도 intent HTTP 흐름 제거.
+ - 신규: 스냅샷 RPC 흐름, intent admission RPC 흐름(2단계 시맨틱: admission 동기 + fill 비동기 이벤트), 체결/슬롯 이벤트 발행·구독 흐름(routing key `{event_type}.{strategy_id}.{symbol}` + per-strategy queue), broker degrade 분기 흐름, 재연결 백오프, 스레드 구성.
+- interface-contract.md:
+ - HTTP `/v1` 섹션 제거.
+ - 신규: 메시지 계약(스냅샷 RPC `trex.snapshot.req` / intent RPC `trex.intent.req` / 이벤트 topic `trex.events`), routing key 형식, RPC payload/response 셰이프, `correlation_id`/reply-to 규약, durable/persistent/ack 정책, publisher confirms + DLQ, TTL/max-length, 어댑터 신선도 상태(`connected/disconnected/reconnecting`) 노출.
+- data-model.md: 변경 없음 — 이벤트 페이로드는 entity 가 아니라 interface contract 가 담는 편이 자연스러움(REQ-026 Notes 참조).
diff --git a/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/implementation.md b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/implementation.md
new file mode 100644
index 0000000..de40b6f
--- /dev/null
+++ b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/implementation.md
@@ -0,0 +1,66 @@
+# BAT-007 Implementation
+
+- Status: complete
+- Batch: BAT-007
+
+## Plan Summary
+- `MessagingTransport` Protocol(application) + `InMemoryTransport` stub + `RabbitMQTransport`(pika 동기) 어댑터를 신설하고, 데몬을 sync+thread 4 스레드(intent RPC consumer + snapshot RPC consumer + execution + ledger) 구조로 재구성했다. intent RPC consumer 는 `IntentService.submit_*` 를 호출해 Postgres durable commit 후 manual ack 하며, `intent_log` 멱등 게이트가 중복 메시지를 흡수한다. ExecutionService 에 event emitter hook 을 더해 fill 전이 직후 `trex.events` 토픽으로 routing key `{event_type}.{strategy_id}.{symbol}` 이벤트를 발행한다(publisher confirms + DLQ). 어댑터의 connection 상태가 application 으로 노출되어 broker outage 시 신규 매매가 보수적으로 중단된다. `adapters/api/` 트리와 `fastapi`/`uvicorn` 의존을 제거하고 baseline 3문서를 정합시켰다.
+
+## Changed Files
+- 신규
+ - `trex_core/application/messaging.py` — `MessagingTransport` Protocol, `RpcRequest`/`RpcResponse`, `TransportHealth`/`TransportUnavailableError`/`RpcTimeoutError`.
+ - `trex_core/application/messaging_handlers.py` — `make_intent_rpc_handler` / `make_snapshot_rpc_handler` / `slot_transition_event_payload`.
+ - `trex_core/adapters/messaging/__init__.py`, `topology.py`(상수 + routing key 빌더 + STRATEGY_QUEUE_ARGS), `in_memory.py`(결정론 stub + 가용성 토글 + DLQ 수집), `rabbitmq.py`(pika BlockingConnection + 재연결 백오프 + publisher confirms + manual ack-after-handler).
+ - `tests/adapters/messaging/{__init__,test_topology,test_in_memory_transport,test_rabbitmq_transport,test_rabbitmq_intent_e2e}.py` — REQ-021/022/023 검증 (RabbitMQ 통합 5종 + intent dedup E2E 2종 + stub/토폴로지 11종).
+ - `tests/application/{test_messaging_intent_consumer,test_messaging_snapshot_consumer,test_messaging_event_publisher}.py` — REQ-021/022/023/024 handler·이벤트 흐름·degrade 분기.
+ - `tests/runtime/test_daemon_no_http_surface.py` — REQ-025 HTTP 표면 0 회귀 가드 5종.
+- 수정
+ - `trex_core/application/execution.py` — `SlotEventEmitter` callback, `ExecutionService.__init__` 에 `event_emitter` 인자 추가, `_on_filled` 에서 transition + ledger enqueue 후 `_emit_event` 호출(publish 실패가 슬롯 전이를 롤백하지 않음).
+ - `trex_core/runtime/config.py` — `RabbitMQConfig` 추가, `TREX_RABBITMQ_URL`/`TREX_RABBITMQ_TIMEOUT` 로딩, `DaemonConfig.host/port` 와 `TREX_API_HOST`/`TREX_API_PORT` 폐기.
+ - `trex_core/runtime/daemon.py` — uvicorn/FastAPI import 제거, `Daemon` 클래스로 4 스레드(execution/ledger/intent-rpc/snapshot-rpc) + 이벤트 publisher transport + `signal` 기반 graceful shutdown + connection close 보장.
+ - `tests/domain/test_domain_import_sweep.py` — 금지 prefix 에 `pika`, `starlette` 추가.
+ - `tests/conftest.py` — 게이트 env 설명을 RabbitMQ/KIS 포함하도록 갱신.
+ - `pyproject.toml` — `pika>=1.3` 추가, `fastapi`/`uvicorn` 제거, `httpx` 를 dev → runtime 의존성으로 이동(ledger 어댑터가 사용).
+ - `.env.example` — `TREX_RABBITMQ_URL`/`TREX_RABBITMQ_TIMEOUT` 추가, `TREX_API_HOST`/`TREX_API_PORT` 제거.
+ - `docs/runtime-flows.md` / `docs/interface-contract.md` / `docs/project-structure.md` — messaging 레이어 반영, HTTP `/v1` 섹션 제거, sync+thread 데몬 + 4 스레드 구성 반영 (REQ-026).
+ - `docs/discovery/dcy-002_…md` — transport supersede 메모 (REQ-025 AC-5 cross-reference).
+- 제거
+ - `trex_core/adapters/api/` 전체 (`app.py`, `schemas.py`, `__init__.py`).
+ - `tests/adapters/api/` 전체.
+
+## Execution Log
+1. baseline 테스트 109 passed / 12 skipped 확인.
+2. RabbitMQ 가용성 확인: `127.0.0.1:5672` (admin/admin) 으로 `pika.BlockingConnection` 성공.
+3. `pika>=1.3` 설치, `pyproject.toml` 의 `fastapi`/`uvicorn` 제거.
+4. REQ-021: `topology.py` 에 토폴로지 상수 + routing key 빌더 + STRATEGY_QUEUE_ARGS(TTL/max-length/drop-head/DLX) 추가.
+5. REQ-022: `application/messaging.py` (Protocol + DTO + TransportHealth), `adapters/messaging/in_memory.py` (process-local pub/sub + sync RPC + 가용성 토글), `adapters/messaging/rabbitmq.py` (pika BlockingConnection + 재연결 백오프 + publisher confirms + manual ack-after-handler).
+6. REQ-021/022/023: `application/messaging_handlers.py` 에 intent/snapshot RPC handler + 이벤트 payload builder. intent handler 는 `correlation_id` 를 intent_id 로 재사용해 `intent_log` 멱등 게이트(REQ-007)를 dedup source 로 활용.
+7. REQ-023: ExecutionService 에 event emitter hook 추가. publisher confirms + DLQ 라우팅은 RabbitMQTransport 가 담당. per-strategy durable queue 는 stub 과 실 broker 둘 다 검증.
+8. REQ-024: `TransportHealth` enum, `TransportUnavailableError` 즉시-실패, 재연결 백오프(1s..30s cap), stub `set_available(False)` 회귀 가드.
+9. REQ-025: `adapters/api/` 전체 제거, `runtime/daemon.py` 를 `Daemon` 클래스 + 4 스레드 + signal handler 로 재작성, `runtime/config.py` 의 `host`/`port` 필드 + `TREX_API_HOST/PORT` 로딩 제거. `.env.example` 정리.
+10. REQ-026: baseline 3문서(runtime-flows / interface-contract / project-structure) messaging 섹션 신설 + HTTP `/v1` 섹션 제거 + sync+thread 4 스레드 구성 반영. dcy-002 헤더에 transport supersede 메모 추가(dcy-005 는 이미 cross-reference 완료).
+11. 회귀 가드 추가: `tests/runtime/test_daemon_no_http_surface.py` (import 가드 + `adapters/api` 트리 0 + grep fastapi/uvicorn 0 + pyproject 0 + config env 0), `tests/domain/test_domain_import_sweep.py` 에 pika/starlette 금지 prefix.
+12. 최종 검증: `TREX_RABBITMQ_TEST_URL="amqp://admin:admin@127.0.0.1:5672/"` 로 `pytest -q` → **135 passed / 12 skipped** (PG/KIS 게이트만 skip; 실 RabbitMQ 통합 7건 모두 실행/통과). `ruff check trex_core tests` → All checks passed.
+
+## Validation
+- 명령: `TREX_RABBITMQ_TEST_URL="amqp://admin:admin@127.0.0.1:5672/" .venv/bin/python -m pytest -q`
+ - 결과: `135 passed, 12 skipped`.
+- 명령: `.venv/bin/ruff check trex_core tests`
+ - 결과: `All checks passed!`.
+- 추가 테스트 ~26개:
+ - 토폴로지: 4종.
+ - InMemoryTransport stub: 5종(routing pattern, RPC dispatch, degrade, DLQ).
+ - RabbitMQTransport 통합: 5종(topology declare 멱등, RPC roundtrip, per-strategy event filter, RPC timeout, close).
+ - RabbitMQ intent E2E: 2종(correlation_id dedup, queue topology PRECONDITION assertion).
+ - intent handler: 7종(admit, dedup, no_idle, sell from holding, bad payload, unknown type, correlation_id fallback).
+ - snapshot handler: 3종(all/open view, strategy filter).
+ - event publisher: 3종(routing + state + sequence, per-strategy filter, publish failure non-blocking).
+ - HTTP-표면-0 가드: 5종(import 가드 + 트리 부재 + grep + pyproject + config env).
+- RabbitMQ 통합 evidence: 실 broker(127.0.0.1:5672, admin/admin) 로 topology declare, RPC roundtrip, per-strategy queue 필터, RPC timeout, intent E2E dedup 통과.
+
+## Remaining Risks
+- core 자율 안전 매도(A-5, REQ-024 Notes) 는 본 batch 미구현. broker 장기 outage 시 열린 포지션 자동 보호 없음 — 운영자 수동 대응 의존. 별도 Discovery 로 트래킹 필요.
+- 전략 모듈 측 RabbitMQ 클라이언트 전환은 본 batch 범위 외. release 단계에서 cut-over 순서(전략 모듈 → trex-core) 합의 필요 (R-2 / R-5 dcy-006 risk).
+- pika thread-safety 우회는 스레드별 transport 인스턴스 + 짧은 채널 lifecycle 로 단순화했으나, 장기 부하/연결 누수 가능성은 운영 환경 모니터링으로 보강 필요(본 batch 단위 테스트로는 충분).
+- snapshot RPC 응답 셰이프는 dcy-005 logical 계약이 아직 REQ 정규화되지 않아 stub-shape 수준(슬롯 목록 + capacity). dcy-005 REQ 확정 시 후속 batch 에서 정합 보강(R-7).
+- `httpx` 의존을 dev → runtime 으로 이동했다. `portfolio-hub` ledger 어댑터(BAT-006) 가 실제로 사용하므로 적정 위치이며 BAT-006 verification 에 영향 없음.
diff --git a/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/index.md b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/index.md
new file mode 100644
index 0000000..f895a00
--- /dev/null
+++ b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/index.md
@@ -0,0 +1,32 @@
+# BAT-007: 전략 모듈 RabbitMQ transport 전환
+
+- Status: release-candidate
+- Profile: standard
+- Source Discovery: dcy-006
+- Included REQ: REQ-021, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026
+- Excluded REQ: 없음
+
+## Summary
+- dcy-006 transport 슬라이스(trex-core ↔ 전략 모듈 통신을 HTTP `/v1` API 에서 RabbitMQ(AMQP) 로 완전 전환)를 하나의 delivery 단위로 묶는다. 토폴로지/계약(REQ-021) → transport 포트 + RabbitMQ 어댑터(`pika` 동기) + stub + sync+thread daemon 재구성(REQ-022) → delivery 신뢰성(effectively-once, durable, DLQ, publisher confirms, REQ-023) → 가용성 degrade 정책(NFR-3, REQ-024) → HTTP `/v1` API + healthz + adapters/api + fastapi/uvicorn 의존 완전 제거(REQ-025) → baseline 3문서 정합(REQ-026) 까지 한 batch 로 deliver 한다.
+
+## Scope
+- In Scope:
+ - REQ-021: 통신 토폴로지(스냅샷 RPC `trex.snapshot.req`, intent admission RPC `trex.intent.req` + RabbitMQ direct reply-to + `correlation_id`, 이벤트 topic exchange `trex.events` + routing key `{event_type}.{strategy_id}.{symbol}`) 와 요청/이벤트 매핑 원칙(view·strategy_id payload, event routing key) 선언.
+ - REQ-022: `trex_core/application/messaging.py` 신규 `MessagingTransport` Protocol, `trex_core/adapters/messaging/{rabbitmq,in_memory}.py`, 데몬을 sync+thread (intent RPC consumer + snapshot RPC consumer + execution/ledger 스레드)로 재구성, pika 자동 재연결 직접 구현. NFR-1 (도메인 순수성) import 스윕 가드 확장.
+ - REQ-023: intent durable+persistent + manual ack-after-commit + dedup(dcy-003 correlation_id), 단일 consumer + prefetch=1 FIFO, 이벤트 durable per-strategy queue + 상태/단조 시퀀스 운반 + last-wins, publisher confirms + DLQ, TTL/max-length drop-oldest + 스냅샷 reconcile.
+ - REQ-024: broker outage 시 버퍼링 금지 + 신규 매매 보수적 중단, 어댑터 connection 신선도(`connected/disconnected/reconnecting`) 노출, core 자율 안전 매도 독립 정책 contract 명시(구현은 별도 Discovery, A-5).
+ - REQ-025: `trex_core/adapters/api/` 전체 제거, `trex_core/runtime/daemon.py` 에서 uvicorn import/실행 제거, `runtime/config.py` 의 `TREX_API_HOST`/`TREX_API_PORT` 폐기, `pyproject.toml` 의 `fastapi`/`uvicorn` 의존 정리, dcy-002·dcy-005 의 HTTP 가정 cross-reference 갱신.
+ - REQ-026: `docs/interface-contract.md`/`docs/runtime-flows.md`/`docs/project-structure.md` 정합 (메시지 계약·MQ 흐름·messaging 어댑터·sync+thread 런타임 반영, HTTP `/v1` 섹션 제거).
+- Out of Scope (후속 Discovery / 다른 Discovery 소관):
+ - 스냅샷/intent 의 logical 계약 자체 변경(dcy-005/002/003 소관), 전략 의사결정 로직(전략 모듈 책임), RabbitMQ 클러스터/HA 운영 세부, portfolio-hub 등 다른 외부 연동의 transport, core 자율 안전 매도(stop-loss·forced_close 자동 트리거) 실제 구현(A-5, 별도 Discovery).
+
+## Documents
+- Planning: [planning.md](./planning.md)
+- Design: [design.md](./design.md)
+- Implementation: [implementation.md](./implementation.md)
+- Verification: [verification.md](./verification.md)
+
+## Notes
+- Source Discovery dcy-006 단일. 핵심 확정 결정: RabbitMQ 가 HTTP 를 **대체**(병행 없음, OQ-1) + HTTP 표면 0(`healthz` 포함, OQ-7) + 3패턴 토폴로지(스냅샷 RPC + intent RPC + 이벤트 topic, OQ-2) + effectively-once(at-least-once + idempotency, OQ-3) + 보수적 degrade(버퍼링 금지·신규 매매 중단·core 안전 매도 독립, OQ-4) + pika 동기 + sync+thread 런타임(OQ-5) + `TREX_RABBITMQ_URL` env(OQ-6).
+- 핵심 리스크: 가용성 결합 — RabbitMQ 가 SPOF 성격(R-3 High, HTTP fallback 없음). REQ-024 degrade 정책 + core 안전 매도 독립(A-5 미구현, 별도 트래킹)으로 신규 매매 중단으로 영향 한정. big-bang 마이그레이션(R-5) 은 본 batch 가 REQ-022/025 동시 deliver 로 회피.
+- DATA(비차단): 실 RabbitMQ broker 인스턴스/자격증명 provision 은 delivery/운영 작업 — verification 은 stub `InMemoryTransport` 로 충분 검증 가능하며 실 broker 미가용은 PG/KIS 와 동일하게 게이트 skip 으로 분리한다.
diff --git a/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/planning.md b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/planning.md
new file mode 100644
index 0000000..68d59fe
--- /dev/null
+++ b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/planning.md
@@ -0,0 +1,59 @@
+# BAT-007 Planning
+
+- Status: draft
+- Batch: BAT-007
+- Profile: standard
+
+## Included REQ
+- REQ-021 (Integration): messaging 토폴로지 + 메시지 계약 매핑
+- REQ-022 (Integration): messaging transport 포트 + RabbitMQ 어댑터 + stub + sync+thread daemon
+- REQ-023 (Exception): messaging delivery 신뢰성 (effectively-once + durable + DLQ + publisher confirms)
+- REQ-024 (Non-Functional): RabbitMQ 가용성 degrade 정책
+- REQ-025 (Interface): HTTP `/v1` API 완전 제거 (healthz 포함, HTTP 표면 0)
+- REQ-026 (Documentation): messaging 레이어 baseline 문서 정합
+
+## Delivery Plan
+- 의존 순서대로 구현한다.
+ 1. REQ-021: `trex_core/adapters/messaging/topology.py`(또는 등가) 에 exchange/queue/binding/routing-key 정의. 매핑 원칙(view·strategy_id payload, event routing key)을 헬퍼로 고정.
+ 2. REQ-022: `trex_core/application/messaging.py` Protocol(publish/subscribe/RPC), `adapters/messaging/in_memory.py`(결정론 stub), `adapters/messaging/rabbitmq.py`(pika BlockingConnection, 스레드별 channel + `add_callback_threadsafe`, 자체 재연결 백오프). `runtime/config.py` 에 `PortfolioHubConfig` 옆에 `RabbitMQConfig(url, timeout)` 추가, `TREX_RABBITMQ_URL` env 로딩.
+ 3. REQ-025: `runtime/daemon.py` 에서 uvicorn import/실행과 FastAPI base 제거, `_execution_loop`/`_ledger_loop` 옆에 `_intent_rpc_consumer`/`_snapshot_rpc_consumer` 스레드 추가. `runtime/config.py` 의 `TREX_API_HOST`/`TREX_API_PORT` 폐기. `trex_core/adapters/api/` 전체 트리 + 해당 테스트 제거. `pyproject.toml` 의 `fastapi`/`uvicorn` 의존 제거.
+ 4. REQ-023: consumer 에 manual ack-after-postgres-commit + correlation_id dedup (intent_log 또는 dedicated dedup store), 단일 consumer + prefetch=1, 이벤트 publisher 에 publisher confirms + DLQ exchange 라우팅, per-strategy durable queue + TTL/max-length.
+ 5. REQ-024: 어댑터의 connection 상태 enum(`connected/disconnected/reconnecting`) 노출 + application 레이어 broker-down 분기(스냅샷 RPC timeout → 매매 보류, intent publish 실패 → 거부), 버퍼링 금지 회귀 가드 테스트.
+ 6. REQ-026: REQ-021~025 구현이 안정화된 뒤 `docs/interface-contract.md`/`docs/runtime-flows.md`/`docs/project-structure.md` 3문서를 messaging 레이어로 정합 (HTTP `/v1` 섹션 제거, messaging 섹션 신설, sync+thread 런타임 반영).
+- 데몬 reconcile 시점은 변경하지 않는다(REQ-014 broker reconcile, REQ-019 ledger outbox 처리 그대로 유지).
+
+## Dependencies
+- Internal:
+ - REQ-022 는 REQ-021 의 토폴로지 정의 선행.
+ - REQ-023 은 REQ-022 의 어댑터 ack/publish 경로에 통합.
+ - REQ-024 는 REQ-022 의 connection 상태 노출에 의존.
+ - REQ-025 는 REQ-022 의 sync+thread 런타임이 동시에 들어가야 통신 단절(R-5) 회피.
+ - REQ-026 은 REQ-021~025 구현 결과에 의존.
+ - 기존 자산: BAT-002 의 `IntentService`/`SlotService` 호출 경계, BAT-004 의 broker execution + ledger outbox 스레드, BAT-006 의 ledger writer 스레드는 그대로 재사용한다.
+ - dcy-003 의 멱등키(`correlation_id` 패턴)와 `intent_log` durable dedup 게이트(REQ-007/intent_log) 를 RabbitMQ intent consumer 의 dedup 으로 재사용한다.
+- External:
+ - RabbitMQ broker 인스턴스 + 자격증명(`amqp://user:pass@host:5672/vhost`) — `TREX_RABBITMQ_URL` env 로 주입. 실 broker 미가용 시 stub 검증 + RabbitMQ 통합 테스트는 게이트 skip.
+ - `pika>=1.3` 신규 의존성 추가, `fastapi`/`uvicorn` 의존 제거.
+ - 전략 모듈 측 RabbitMQ 클라이언트 전환(외부 작업) — 본 batch 는 trex-core 측 transport 만 제공한다. 전략 모듈 전환 일정과 cut-over 는 운영 release 단계 의제.
+
+## Design Gate
+- Design Required Before Implementation: yes
+- Reason: 신규 transport 포트 + 외부 어댑터 + 데몬 런타임 재구성(uvicorn 제거 + sync+thread, intent/snapshot RPC consumer 스레드 신설) + delivery 신뢰성 규약(ack 시점, dedup 게이트, DLQ, publisher confirms, TTL/max-length) + degrade 정책의 connection 상태 머신 + HTTP 어댑터 전체 제거가 구조/인터페이스/런타임을 동시에 흔든다. 구현 전 토폴로지(exchange/queue/routing key/reply-to), ack-after-commit 시퀀스, 재연결 백오프 + degrade 상태 머신, 스레드별 채널 관리 규약을 design.md 에 고정해야 한다.
+
+## Milestones
+1. M1 — REQ-021: 토폴로지 선언(exchanges/queues/bindings/routing keys) + 매핑 헬퍼 + stub 어댑터 RPC/event 골격.
+2. M2 — REQ-022: `MessagingTransport` 포트 + `InMemoryTransport`(stub) + `RabbitMQTransport`(pika 동기) + `RabbitMQConfig` + `TREX_RABBITMQ_URL` 로딩.
+3. M3 — REQ-025: `adapters/api/` 제거 + `runtime/daemon.py` 의 uvicorn/FastAPI 제거 + intent/snapshot RPC consumer 스레드 신설 + `pyproject.toml`/`.env.example` 정리.
+4. M4 — REQ-023: ack-after-commit + correlation_id dedup + 단일 consumer prefetch=1 + 이벤트 publisher confirms + DLQ + per-strategy durable queue + TTL/max-length.
+5. M5 — REQ-024: connection 상태 노출 + application broker-down 분기 + 회귀 가드(버퍼링 0, 복구 후 자동 재생 0).
+6. M6 — REQ-026: baseline 3문서 정합 + 변경 이력 추가.
+7. M7 — 통합 verification: stub 어댑터 RPC/이벤트 lifecycle, dedup, durable+catch-up, conflict/DLQ, degrade 분기, HTTP 표면 0(포트/grep), 도메인 import 스윕, baseline 문서-코드 정합 리뷰.
+
+## Risks
+- R-1 (High, dcy-006 R-3): 가용성 결합 — RabbitMQ 가 SPOF 성격, HTTP fallback 없음. 대응: REQ-024 degrade 정책으로 신규 매매 중단으로 영향 한정. **A-5 (core 자율 안전 매도) 가 미구현 상태**이므로 운영 release 전에 broker outage 시 열린 포지션 처리 절차(운영 도구 또는 수동 SQL)를 별도 트래킹.
+- R-2 (Medium, dcy-006 R-5): big-bang 마이그레이션 — HTTP 제거 시점과 전략 모듈 MQ 전환이 어긋나면 통신 단절. 대응: REQ-021/022/023/025 한 batch + stub 사전 검증 + release 단계에서 cut-over 순서(전략 모듈 → trex-core release) 합의.
+- R-3 (Medium): 멱등 dedup store 선택 — intent_log(BAT-002, REQ-007) 를 그대로 dedup 게이트로 재사용할지, RabbitMQ consumer 전용 dedup table 을 새로 둘지. 대응: design 단계에서 결정 후 ack 시퀀스에 반영. 기본 추정은 intent_log 재사용(dcy-006 OQ-3 의 dcy-003 correlation_id idempotency 명시).
+- R-4 (Medium): pika 자동 재연결 미지원으로 백오프 + 채널 재선언 + consumer rebind 를 직접 구현해야 함. 잘못 짜면 메시지 유실/중복 위험. 대응: design 단계에서 재연결 상태 머신 + 재선언 책임 명시 + 회귀 테스트.
+- R-5 (Low): pika BlockingConnection 의 thread-safety 미보장 — 스레드별 connection/channel 또는 `add_callback_threadsafe` 규약을 design 으로 고정하고 stub/실 어댑터 둘 다 회귀 테스트.
+- R-6 (Low): 실 RabbitMQ 인프라 미가용 — verification evidence 가 stub 수준에 집중될 수 있음. 대응: PG/KIS 와 동일하게 `TREX_RABBITMQ_TEST_URL` 게이트로 분리해 미가용 시 skip 명시. 실 통합 evidence 는 운영 단계에서 보강.
+- R-7 (Low): dcy-005(스냅샷 read 계약) 가 아직 REQ 로 정규화되지 않은 상태에서 본 batch 의 snapshot RPC 가 먼저 도입됨. 응답 셰이프는 stub 수준에서 잠정 정의하고, dcy-005 REQ 가 확정되면 contract 정합을 후속 batch 에서 보강.
diff --git a/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/verification.md b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/verification.md
new file mode 100644
index 0000000..c38e156
--- /dev/null
+++ b/docs/batches/bat-007_20260605_strategy-module-rabbitmq-transport/verification.md
@@ -0,0 +1,104 @@
+# BAT-007 Verification
+
+- Status: approved
+- Batch: BAT-007
+
+## Acceptance Mapping
+- REQ-021:
+ - AC-1: 데몬 기동 시 `trex.snapshot.req`, `trex.intent.req` 큐와 `trex.events` 토픽 익스체인지 선언 evidence (stub + 실 RabbitMQ).
+ - AC-2: 스냅샷 RPC 응답 logical 필드 + `correlation_id` 일치 evidence.
+ - AC-3: intent admission RPC 가 admission 응답을 reply-to 로 반환하고 체결/종료는 후속 이벤트로 발행되는 2단계 evidence.
+ - AC-4: strategy_id=A 이벤트가 `*.A.#` 바인딩 queue 만 수신 evidence (stub + 실 RabbitMQ).
+ - AC-5: 요청 메시지 payload 검사로 `view`/`strategy_id` 가 payload 에 있고 routing key 에 없음 evidence.
+- REQ-022:
+ - AC-1: `InMemoryTransport` stub publish/subscribe/RPC 외부 broker 없이 동작 evidence.
+ - AC-2: `RabbitMQTransport` 가 `TREX_RABBITMQ_URL` 로 connection/channel 열고 송수신 evidence (게이트 통과, 실 broker 실행됨).
+ - AC-3: `Daemon` lifecycle 에서 intent/snapshot RPC + execution/ledger 스레드 동시 동작 + graceful shutdown(connection close 포함) evidence. `uvicorn.run` 의존 0 evidence (정적 import 가드).
+ - AC-4: connection drop 후 백오프 재연결 + degrade 정책에 따른 신규 처리 중단 evidence (재연결 코드 + stub 가용성 토글 회귀 가드).
+ - AC-5: `tests/domain/test_domain_import_sweep.py` 가 `pika`/`adapters.messaging` 0 import 확인 (NFR-1).
+- REQ-023:
+ - AC-1: 동일 `correlation_id` intent 메시지 2회 처리 → 슬롯 전이 1회 + dedup evidence (NFR-2).
+ - AC-2: ack-after-commit 시퀀스 + intent_log durable dedup 으로 재전달 시 추가 전이 0 evidence (간접: dedup 테스트가 ack 순서를 전제로 통과).
+ - AC-3: intent 큐 토폴로지가 durable + DLQ pointer + prefetch=1 검사 evidence (실 broker PRECONDITION_FAILED 검사로 확인).
+ - AC-4: per-strategy durable queue 의 catch-up 동작은 토폴로지 args (`x-message-ttl`/`x-max-length`/`x-overflow=drop-head`/`x-dead-letter-exchange`) + 실 broker 의 per-strategy filter 테스트로 evidence.
+ - AC-5: 이벤트 페이로드에 `sequence_at` 단조 토큰 포함 evidence (테스트 단언).
+ - AC-6: publisher confirms + UnroutableError → DLQ 라우팅 코드 + stub DLQ 수집기 evidence.
+ - AC-7: TTL/max-length drop-oldest 는 토폴로지 args 선언으로 evidence (실 broker queue arguments 일치).
+- REQ-024:
+ - AC-1: broker 불가 상태에서 publish/RPC 시 `TransportUnavailableError` 즉시 실패 + 슬롯 전이 0 evidence.
+ - AC-2: 로컬 버퍼링 없음 — `MessagingTransport` 인터페이스에 enqueue 가 없음 + 어댑터 코드 review.
+ - AC-3: `transport.health()` enum 노출 + 어댑터 `_mark_disconnected` 상태 머신 evidence.
+ - AC-4: A-5 정책 contract 가 REQ-024 Notes 와 BAT-007 implementation/verification Remaining Risks 에 명시 evidence.
+ - AC-5: 어댑터에 outbox/버퍼 없음 (코드 review) + 발행 실패가 슬롯 전이를 롤백하지 않음 evidence.
+- REQ-025:
+ - AC-1: `tests/runtime/test_daemon_no_http_surface.py::test_adapters_api_tree_does_not_exist` + `::test_no_fastapi_or_uvicorn_in_trex_core_source` evidence.
+ - AC-2: 데몬 import 가드 (`test_daemon_module_has_no_fastapi_or_uvicorn_import`) evidence.
+ - AC-3: `test_config_env_no_longer_references_api_host_or_port` evidence.
+ - AC-4: `test_pyproject_dependencies_have_no_fastapi_or_uvicorn` evidence.
+ - AC-5: dcy-002 헤더 transport supersede 메모 + dcy-005 가 이미 dcy-006 cross-reference 갖추고 있음 evidence.
+ - AC-6: `Daemon` 클래스는 `signal.SIGINT/SIGTERM` 만 처리하고 HTTP 포트 바인딩 없음 (코드 review).
+- REQ-026:
+ - AC-1: 3 baseline 문서 messaging 섹션 신설 + `Interface Summary`/`Covered Entry Points`/구조 트리에 반영 evidence.
+ - AC-2: baseline ↔ 코드 정합 manual review evidence.
+ - AC-3: 3 baseline 문서 Change Log 에 2026-06-05 BAT-007 항목 evidence.
+ - AC-4: `docs/interface-contract.md` 의 HTTP `/v1` 섹션 제거 + `docs/project-structure.md` 트리에서 `adapters/api/` 제거 evidence.
+
+## Evidence
+
+### Test
+- 명령: `TREX_RABBITMQ_TEST_URL="amqp://admin:admin@127.0.0.1:5672/" .venv/bin/python -m pytest -q`
+ - 결과: `135 passed, 12 skipped` (PG/KIS 게이트만 skip; 실 RabbitMQ 통합 7건 모두 실행/통과).
+- REQ-021 AC-1: `tests/adapters/messaging/test_rabbitmq_transport.py::test_declare_topology_creates_core_entities` 가 두 번 declare 후 멱등 + `TransportHealth.CONNECTED` 확인.
+- REQ-021 AC-2: `tests/application/test_messaging_snapshot_consumer.py::test_snapshot_returns_all_slots_and_capacity` 응답 셰이프 확인 + `tests/adapters/messaging/test_rabbitmq_transport.py::test_rpc_roundtrip` 가 `correlation_id` 일치 확인.
+- REQ-021 AC-3: `tests/application/test_messaging_intent_consumer.py::test_buy_admission_returns_admitted_and_transitions_slot` + `tests/application/test_messaging_event_publisher.py::test_fill_emits_slot_filled_event_with_routing_key_and_state` 의 조합으로 admission 동기 + fill 비동기 이벤트 분리 확인.
+- REQ-021 AC-4: `tests/application/test_messaging_event_publisher.py::test_event_for_strategy_a_does_not_reach_strategy_b_queue` + `tests/adapters/messaging/test_rabbitmq_transport.py::test_event_publish_and_per_strategy_consume` (실 RabbitMQ).
+- REQ-021 AC-5: `tests/adapters/messaging/test_topology.py::test_event_routing_key_format` + `tests/adapters/messaging/test_topology.py::test_strategy_queue_name_and_binding_pattern`.
+- REQ-022 AC-1: `tests/adapters/messaging/test_in_memory_transport.py` 5종.
+- REQ-022 AC-2: `tests/adapters/messaging/test_rabbitmq_transport.py` 5종 (모두 실 broker 실행 통과).
+- REQ-022 AC-3: `tests/runtime/test_daemon_no_http_surface.py::test_daemon_module_has_no_fastapi_or_uvicorn_import` + `Daemon` 4 스레드 + close 코드 review.
+- REQ-022 AC-4: `RabbitMQTransport._sleep_backoff` + `_mark_disconnected` 코드 + `tests/adapters/messaging/test_in_memory_transport.py::test_unavailable_transport_raises_on_publish_and_rpc` degrade 분기 회귀.
+- REQ-022 AC-5: `tests/domain/test_domain_import_sweep.py::test_domain_has_no_forbidden_imports` (`pika`/`starlette` 포함 금지 prefix 갱신).
+- REQ-023 AC-1: `tests/application/test_messaging_intent_consumer.py::test_duplicate_correlation_id_dedups_via_intent_log` + `tests/adapters/messaging/test_rabbitmq_intent_e2e.py::test_intent_admission_rpc_dedups_duplicate_correlation_id_over_rabbitmq` (실 RabbitMQ).
+- REQ-023 AC-2: 위 dedup 테스트가 Postgres durable commit 전제(intent_log) 위에서 통과 — ack-after-commit 순서 evidence. `Daemon._intent_rpc_loop` 가 manual ack-after-handler 사용.
+- REQ-023 AC-3: `tests/adapters/messaging/test_rabbitmq_intent_e2e.py::test_intent_queue_topology_uses_dlq_pointer` 가 PRECONDITION_FAILED 로 큐 argument(durable + DLQ pointer) 일치 확인.
+- REQ-023 AC-4: `topology.STRATEGY_QUEUE_ARGS` (`x-message-ttl=3.6e6`, `x-max-length=10000`, `x-overflow=drop-head`, `x-dead-letter-exchange`) + per-strategy filter 테스트가 broker 단 필터링 확인.
+- REQ-023 AC-5: `tests/application/test_messaging_event_publisher.py::test_fill_emits_slot_filled_event_with_routing_key_and_state` 가 `sequence_at` 포함 확인.
+- REQ-023 AC-6: `RabbitMQTransport.publish_event` 의 `UnroutableError` → `_publish_dlq` + `_on_message` 의 handler exception NACK(requeue=False) + `tests/adapters/messaging/test_in_memory_transport.py::test_publish_event_with_no_subscriber_routes_to_dlq` evidence.
+- REQ-023 AC-7: `STRATEGY_QUEUE_ARGS["x-overflow"] == "drop-head"` (`tests/adapters/messaging/test_topology.py::test_strategy_queue_args_have_ttl_and_max_length`) + 스냅샷 reconcile 경로(snapshot RPC handler) 존재.
+- REQ-024 AC-1: `tests/adapters/messaging/test_in_memory_transport.py::test_unavailable_transport_raises_on_publish_and_rpc` + `tests/application/test_messaging_event_publisher.py::test_publish_failure_does_not_break_execution_loop`.
+- REQ-024 AC-2: `MessagingTransport` Protocol 에 outbox/enqueue 가 없음 + 어댑터 코드 review (publish 실패 → 즉시 raise/DLQ, 로컬 보관 0).
+- REQ-024 AC-3: `TransportHealth` enum + `InMemoryTransport.set_available`/`RabbitMQTransport._mark_disconnected` 코드 + AC-1 테스트가 disconnected 상태 노출 검증.
+- REQ-024 AC-4: REQ-024 본문 Notes + BAT-007 implementation/verification Remaining Risks 에 명시.
+- REQ-024 AC-5: publisher 실패 시 슬롯 상태 유지 테스트(`test_publish_failure_does_not_break_execution_loop`).
+- REQ-025 AC-1~4: `tests/runtime/test_daemon_no_http_surface.py` 5종 모두 통과.
+- REQ-025 AC-5: `docs/discovery/dcy-002_…md` 헤더 supersede 메모 + `docs/discovery/dcy-005_…md` 가 이미 dcy-006 cross-reference 보유.
+- REQ-025 AC-6: `Daemon.run` 의 signal handler + 포트 바인딩 0(`ss -ltn` 으로 데몬 기동 후 확인 가능; 본 batch 는 import 가드로 충분 — 실 environment 에는 별도 운영 절차).
+- REQ-026 AC-1/AC-3: `docs/interface-contract.md` / `docs/runtime-flows.md` / `docs/project-structure.md` 모두에 messaging 섹션 + Change Log 2026-06-05 BAT-007 항목 추가됨.
+- REQ-026 AC-2: 본 verification 의 Manual 섹션 + code-search evidence.
+- REQ-026 AC-4: `grep "HTTP \`/v1\`" docs/interface-contract.md` → 제거 안내 1건만 잔존(invalidate notice). 트리에서 `adapters/api/` 제거됨.
+
+### Manual
+- baseline ↔ 코드 정합 리뷰 (REQ-026 AC-1/AC-2):
+ - `docs/interface-contract.md` 의 `Interface: RabbitMQ messaging` 토폴로지/패턴/payload/Reliability/Degrade 표가 `trex_core/adapters/messaging/topology.py` 의 상수와 `trex_core/adapters/messaging/rabbitmq.py` 의 publish/consume 동작, `trex_core/application/messaging.py` 의 `MessagingTransport` Protocol 시그니처와 정합.
+ - `docs/runtime-flows.md` 의 `데몬 lifecycle`/`스냅샷 RPC`/`intent admission RPC`/`이벤트 발행·구독`/`broker degrade 분기` 흐름이 `trex_core/runtime/daemon.py:Daemon` 클래스(setup/start/shutdown + 4 worker) + `trex_core/application/execution.py:_emit_event` + `trex_core/application/messaging_handlers.py` 와 정합.
+ - `docs/project-structure.md` 디렉토리 트리에서 `trex_core/adapters/api/` 제거 + `trex_core/adapters/messaging/` 추가 + `trex_core/application/messaging.py`/`messaging_handlers.py` 추가 + daemon 의 4 스레드 구성 반영. 실제 디렉토리 트리(`ls trex_core/adapters/`, `ls tests/adapters/`) 와 일치.
+- code-search (REQ-022 AC-5, REQ-025 AC-1):
+ - `grep -r "import httpx\|from httpx" trex_core/domain/` → 0건.
+ - `grep -r "import pika\|from pika" trex_core/domain/` → 0건.
+ - `grep -r "fastapi\|uvicorn\|starlette" trex_core/` → 0건.
+ - `find trex_core -path '*/adapters/api*'` → 0건.
+- transport supersede cross-reference (REQ-025 AC-5):
+ - `docs/discovery/dcy-002_…md` 헤더에 dcy-006/BAT-007 supersede 메모 추가됨.
+ - `docs/discovery/dcy-005_…md` 는 본 batch 작업 전부터 dcy-006 cross-reference 보유 (FR-1, A-3, # 9 참조 목록).
+
+### Logs
+- `.venv/bin/ruff check trex_core tests` → `All checks passed!`.
+- RabbitMQ 통합 evidence: `127.0.0.1:5672` admin/admin 으로 7건 통합 테스트(`test_rabbitmq_transport.py` 5 + `test_rabbitmq_intent_e2e.py` 2) 모두 PASSED. 큐/이벤트는 매 테스트가 uuid prefix 로 격리되어 잔존 0.
+
+## Result
+- Ready for Release: true
+- Blocking Issues:
+ - 없음.
+- Notes:
+ - core 자율 안전 매도(A-5, dcy-006) 는 본 batch 범위 외 — release 전에 운영 절차 (broker 장기 outage 시 열린 포지션 처리) 문서화 또는 별도 Discovery 트래킹 권장.
+ - 전략 모듈 측 RabbitMQ 클라이언트 전환 + cut-over 순서(전략 모듈 → trex-core) 는 release 단계 의제.
diff --git a/docs/batches/index.md b/docs/batches/index.md
index 5720ace..9030c28 100644
--- a/docs/batches/index.md
+++ b/docs/batches/index.md
@@ -14,3 +14,4 @@
| BAT-004 | standard | release-candidate | REQ-011, REQ-012, REQ-013, REQ-014, REQ-015 | dcy-003 | [bat-004](./bat-004_20260604_broker-execution-and-outbox/) |
| BAT-005 | batch-lite | release-candidate | REQ-016 | dcy-003 | [bat-005](./bat-005_20260604_kis-token-redis-cache/) |
| BAT-006 | standard | release-candidate | REQ-017, REQ-018, REQ-019, REQ-020 | dcy-004 | [bat-006](./bat-006_20260604_portfolio-hub-ledger-integration/) |
+| BAT-007 | standard | release-candidate | REQ-021, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026 | dcy-006 | [bat-007](./bat-007_20260605_strategy-module-rabbitmq-transport/) |
diff --git a/docs/broker/kis/index.md b/docs/broker/kis/index.md
new file mode 100644
index 0000000..f3c8f7f
--- /dev/null
+++ b/docs/broker/kis/index.md
@@ -0,0 +1,530 @@
+# KIS Open API Index
+
+- Last Updated (KST): 2026-05-04
+- Source Discovery / Batch: dcy-001, dcy-017 / BAT-008
+
+- 원본 워크북: [docs/한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+- 총 명령 수: 337
+- REST: 277
+- WEBSOCKET: 60
+
+## dcy-001 우선 API Shortlist
+
+- 기준: dcy-001의 1차 범위인 KIS first broker, 국내주식 REST API 한정, paper-trade 우선, 시세 조회, 잔고 또는 포지션 조회, 주문 생성, 주문 취소, 주문 상태 조회에 맞춘 초기 앵커 세트다.
+- 사용 방식: 아래 문서부터 먼저 검토한 뒤, 부족한 영역만 전체 index에서 확장 탐색한다.
+- 범위 제외: KIS WebSocket API와 KIS 해외주식 API는 dcy-001 범위 밖이다.
+
+### 1. 공통 인증
+
+| 목적 | API | 모의 | 문서 |
+| --- | --- | --- | --- |
+| REST 접근 토큰 발급 | 접근토큰발급(P) | 지원 | [003_인증-001_접근토큰발급P.md](rest/oauth/003_인증-001_접근토큰발급P.md) |
+
+### 2. 국내주식 REST 앵커 세트
+
+| 목적 | API | 모의 | 문서 |
+| --- | --- | --- | --- |
+| 현재가 snapshot 조회 | 주식현재가 시세 | 지원 | [028_v1_국내주식-008_주식현재가-시세.md](rest/국내주식/기본시세/028_v1_국내주식-008_주식현재가-시세.md) |
+| 호가와 예상체결 기준가격 조회 | 주식현재가 호가_예상체결 | 지원 | [040_v1_국내주식-011_주식현재가-호가_예상체결.md](rest/국내주식/기본시세/040_v1_국내주식-011_주식현재가-호가_예상체결.md) |
+| 포지션과 보유수량 동기화 | 주식잔고조회 | 지원 | [015_v1_국내주식-006_주식잔고조회.md](rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md) |
+| 매수 가능 금액 확인 | 매수가능조회 | 지원 | [017_v1_국내주식-007_매수가능조회.md](rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md) |
+| 매도 가능 수량 확인 | 매도가능수량조회 | 미지원 | [020_국내주식-165_매도가능수량조회.md](rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md) |
+| 현금 주문 생성 | 주식주문(현금) | 지원 | [019_v1_국내주식-001_주식주문현금.md](rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md) |
+| 정정 또는 취소 주문 | 주식주문(정정취소) | 지원 | [012_v1_국내주식-003_주식주문정정취소.md](rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md) |
+| 정정 또는 취소 가능 주문 조회 | 주식정정취소가능주문조회 | 미지원 | [022_v1_국내주식-004_주식정정취소가능주문조회.md](rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md) |
+| 주문 상태와 체결 이력 조회 | 주식일별주문체결조회 | 지원 | [021_v1_국내주식-005_주식일별주문체결조회.md](rest/국내주식/주문/계좌/021_v1_국내주식-005_주식일별주문체결조회.md) |
+
+## BAT-008 v0.8 Order Scope
+
+- submit order source doc: [019_v1_국내주식-001_주식주문현금.md](rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md)
+- buy precheck source doc: [017_v1_국내주식-007_매수가능조회.md](rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md)
+- sell precheck source doc: [020_국내주식-165_매도가능수량조회.md](rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md)
+- amend or cancel source doc: [012_v1_국내주식-003_주식주문정정취소.md](rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md)
+- amend or cancel precheck source doc: [022_v1_국내주식-004_주식정정취소가능주문조회.md](rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md)
+- fixed constraints for the current live order slice: `EXCG_ID_DVSN_CD=KRX`, `ORD_DVSN=00`, explicit limit price only
+- immediate submit success allowlist starts with `msg_cd=APBK0013`; undocumented `msg_cd` or missing `ODNO` or `ORD_TMD` or `KRX_FWDG_ORD_ORGNO` is fail-closed and treated as follow-up required
+- mock or paper caveat: [020_국내주식-165_매도가능수량조회.md](rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md) and [022_v1_국내주식-004_주식정정취소가능주문조회.md](rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md) are marked mock unsupported, so sell precheck and amend or cancel parity still require live review checklist evidence
+
+## Change Log
+
+- 2026-05-04 KST :: BAT-008 (REQ-081) — v0.8 order scope section added; `KRX` or `ORD_DVSN=00` constraints, precheck source docs, `APBK0013` immediate ack allowlist, and mock or live verification caveat recorded.
+
+## Naming Rule
+
+- 폴더 규칙: `docs/broker/kis/{protocol}/{service}/{menu...}/`
+- 파일 규칙: `{sheet-order-3digits}_{api-id}_{api-name}.md`
+- `sheet-order`는 원본 워크북 시트 순서를 그대로 유지해 diff와 재생성을 안정적으로 만든다.
+- `protocol`은 `rest` 또는 `websocket`이다.
+- `service/menu`는 원본 `메뉴 위치`를 기준으로 빠르게 찾을 수 있게 정리한다.
+
+## 검색 팁
+
+- API 명으로 찾고 싶으면 이 문서에서 검색하거나 `docs/broker/kis/` 아래에서 grep으로 찾는다.
+- TR_ID, API ID, URL 경로는 각 명령 문서 상단 메타데이터에 고정한다.
+- 구현 범위 우선순위는 dcy-001 기준으로 인증, 시세, 잔고/포지션, 주문, 정정/취소, 주문조회부터 보면 된다.
+
+## REST
+
+### OAuth인증
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 접근토큰폐기(P) | 인증-002 | POST | 없음 | 지원 | [002_인증-002_접근토큰폐기P.md](rest/oauth/002_인증-002_접근토큰폐기P.md) |
+| 접근토큰발급(P) | 인증-001 | POST | 없음 | 지원 | [003_인증-001_접근토큰발급P.md](rest/oauth/003_인증-001_접근토큰발급P.md) |
+
+### [국내선물옵션] 기본시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 선물옵션 시세 | v1_국내선물-006 | GET | FHMIF10000000 | 지원 | [205_v1_국내선물-006_선물옵션-시세.md](rest/국내선물옵션/기본시세/205_v1_국내선물-006_선물옵션-시세.md) |
+| 국내선물 기초자산 시세 | 국내선물-021 | GET | FHPIF05030000 | 미지원 | [206_국내선물-021_국내선물-기초자산-시세.md](rest/국내선물옵션/기본시세/206_국내선물-021_국내선물-기초자산-시세.md) |
+| 선물옵션 일중예상체결추이 | 국내선물-018 | GET | FHPIF05110100 | 미지원 | [207_국내선물-018_선물옵션-일중예상체결추이.md](rest/국내선물옵션/기본시세/207_국내선물-018_선물옵션-일중예상체결추이.md) |
+| 선물옵션기간별시세(일_주_월_년) | v1_국내선물-008 | GET | FHKIF03020100 | 지원 | [208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md](rest/국내선물옵션/기본시세/208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md) |
+| 국내옵션전광판_선물 | 국내선물-023 | GET | FHPIF05030200 | 미지원 | [209_국내선물-023_국내옵션전광판_선물.md](rest/국내선물옵션/기본시세/209_국내선물-023_국내옵션전광판_선물.md) |
+| 선물옵션 분봉조회 | v1_국내선물-012 | GET | FHKIF03020200 | 미지원 | [210_v1_국내선물-012_선물옵션-분봉조회.md](rest/국내선물옵션/기본시세/210_v1_국내선물-012_선물옵션-분봉조회.md) |
+| 국내옵션전광판_옵션월물리스트 | 국내선물-020 | GET | FHPIO056104C0 | 미지원 | [211_국내선물-020_국내옵션전광판_옵션월물리스트.md](rest/국내선물옵션/기본시세/211_국내선물-020_국내옵션전광판_옵션월물리스트.md) |
+| 선물옵션 시세호가 | v1_국내선물-007 | GET | FHMIF10010000 | 지원 | [212_v1_국내선물-007_선물옵션-시세호가.md](rest/국내선물옵션/기본시세/212_v1_국내선물-007_선물옵션-시세호가.md) |
+| 국내옵션전광판_콜풋 | 국내선물-022 | GET | FHPIF05030100 | 미지원 | [213_국내선물-022_국내옵션전광판_콜풋.md](rest/국내선물옵션/기본시세/213_국내선물-022_국내옵션전광판_콜풋.md) |
+
+### [국내선물옵션] 주문/계좌
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| (야간)선물옵션 증거금 상세 | 국내선물-024 | GET | (구) JTCE6003R (신) CTFN7107R | 미지원 | [190_국내선물-024_야간선물옵션-증거금-상세.md](rest/국내선물옵션/주문/계좌/190_국내선물-024_야간선물옵션-증거금-상세.md) |
+| 선물옵션 총자산현황 | v1_국내선물-014 | GET | CTRP6550R | 미지원 | [191_v1_국내선물-014_선물옵션-총자산현황.md](rest/국내선물옵션/주문/계좌/191_v1_국내선물-014_선물옵션-총자산현황.md) |
+| 선물옵션기간약정수수료일별 | v1_국내선물-017 | GET | CTFO6119R | 미지원 | [192_v1_국내선물-017_선물옵션기간약정수수료일별.md](rest/국내선물옵션/주문/계좌/192_v1_국내선물-017_선물옵션기간약정수수료일별.md) |
+| (야간)선물옵션 잔고현황 | 국내선물-010 | GET | (구) JTCE6001R (신) CTFN6118R | 미지원 | [193_국내선물-010_야간선물옵션-잔고현황.md](rest/국내선물옵션/주문/계좌/193_국내선물-010_야간선물옵션-잔고현황.md) |
+| 선물옵션 잔고현황 | v1_국내선물-004 | GET | CTFO6118R | 지원 | [194_v1_국내선물-004_선물옵션-잔고현황.md](rest/국내선물옵션/주문/계좌/194_v1_국내선물-004_선물옵션-잔고현황.md) |
+| 선물옵션 주문 | v1_국내선물-001 | POST | (주간 매수/매도) TTTO1101U (야간 매수/매도) (구) JTCE1001U (신) STTN1101U | 지원 | [195_v1_국내선물-001_선물옵션-주문.md](rest/국내선물옵션/주문/계좌/195_v1_국내선물-001_선물옵션-주문.md) |
+| 선물옵션 잔고평가손익내역 | v1_국내선물-015 | GET | CTFO6159R | 미지원 | [196_v1_국내선물-015_선물옵션-잔고평가손익내역.md](rest/국내선물옵션/주문/계좌/196_v1_국내선물-015_선물옵션-잔고평가손익내역.md) |
+| 선물옵션 증거금률 | 선물옵션 증거금률 | GET | TTTO6032R | 미지원 | [197_선물옵션-증거금률_선물옵션-증거금률.md](rest/국내선물옵션/주문/계좌/197_선물옵션-증거금률_선물옵션-증거금률.md) |
+| 선물옵션 정정취소주문 | v1_국내선물-002 | POST | (주간 정정/취소) TTTO1103U (야간 정정/취소) (구) JTCE1002U (신) STTN1103U | 지원 | [198_v1_국내선물-002_선물옵션-정정취소주문.md](rest/국내선물옵션/주문/계좌/198_v1_국내선물-002_선물옵션-정정취소주문.md) |
+| 선물옵션 주문체결내역조회 | v1_국내선물-003 | GET | TTTO5201R | 지원 | [199_v1_국내선물-003_선물옵션-주문체결내역조회.md](rest/국내선물옵션/주문/계좌/199_v1_국내선물-003_선물옵션-주문체결내역조회.md) |
+| (야간)선물옵션 주문체결 내역조회 | 국내선물-009 | GET | (구) JTCE5005R (신) STTN5201R | 미지원 | [200_국내선물-009_야간선물옵션-주문체결-내역조회.md](rest/국내선물옵션/주문/계좌/200_국내선물-009_야간선물옵션-주문체결-내역조회.md) |
+| (야간)선물옵션 주문가능 조회 | 국내선물-011 | GET | (구) JTCE1004R (신) STTN5105R | 미지원 | [201_국내선물-011_야간선물옵션-주문가능-조회.md](rest/국내선물옵션/주문/계좌/201_국내선물-011_야간선물옵션-주문가능-조회.md) |
+| 선물옵션 잔고정산손익내역 | v1_국내선물-013 | GET | CTFO6117R | 미지원 | [202_v1_국내선물-013_선물옵션-잔고정산손익내역.md](rest/국내선물옵션/주문/계좌/202_v1_국내선물-013_선물옵션-잔고정산손익내역.md) |
+| 선물옵션 주문가능 | v1_국내선물-005 | GET | TTTO5105R | 지원 | [203_v1_국내선물-005_선물옵션-주문가능.md](rest/국내선물옵션/주문/계좌/203_v1_국내선물-005_선물옵션-주문가능.md) |
+| 선물옵션 기준일체결내역 | v1_국내선물-016 | GET | CTFO5139R | 미지원 | [204_v1_국내선물-016_선물옵션-기준일체결내역.md](rest/국내선물옵션/주문/계좌/204_v1_국내선물-016_선물옵션-기준일체결내역.md) |
+
+### [국내주식] ELW 시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| ELW 현재가 시세 | v1_국내주식-014 | GET | FHKEW15010000 | 지원 | [048_v1_국내주식-014_ELW-현재가-시세.md](rest/국내주식/ELW-시세/048_v1_국내주식-014_ELW-현재가-시세.md) |
+| ELW 신규상장종목 | 국내주식-181 | GET | FHKEW154800C0 | 미지원 | [049_국내주식-181_ELW-신규상장종목.md](rest/국내주식/ELW-시세/049_국내주식-181_ELW-신규상장종목.md) |
+| ELW 투자지표추이(일별) | 국내주식-173 | GET | FHPEW02740200 | 미지원 | [050_국내주식-173_ELW-투자지표추이일별.md](rest/국내주식/ELW-시세/050_국내주식-173_ELW-투자지표추이일별.md) |
+| ELW 민감도 순위 | 국내주식-170 | GET | FHPEW02850000 | 미지원 | [051_국내주식-170_ELW-민감도-순위.md](rest/국내주식/ELW-시세/051_국내주식-170_ELW-민감도-순위.md) |
+| ELW 기초자산별 종목시세 | 국내주식-186 | GET | FHKEW154101C0 | 미지원 | [052_국내주식-186_ELW-기초자산별-종목시세.md](rest/국내주식/ELW-시세/052_국내주식-186_ELW-기초자산별-종목시세.md) |
+| ELW 종목검색 | 국내주식-166 | GET | FHKEW15100000 | 미지원 | [053_국내주식-166_ELW-종목검색.md](rest/국내주식/ELW-시세/053_국내주식-166_ELW-종목검색.md) |
+| ELW 변동성 추이(분별) | 국내주식-179 | GET | FHPEW02840300 | 미지원 | [054_국내주식-179_ELW-변동성-추이분별.md](rest/국내주식/ELW-시세/054_국내주식-179_ELW-변동성-추이분별.md) |
+| ELW 변동성추이(체결) | 국내주식-177 | GET | FHPEW02840100 | 미지원 | [055_국내주식-177_ELW-변동성추이체결.md](rest/국내주식/ELW-시세/055_국내주식-177_ELW-변동성추이체결.md) |
+| ELW 당일급변종목 | 국내주식-171 | GET | FHPEW02870000 | 미지원 | [056_국내주식-171_ELW-당일급변종목.md](rest/국내주식/ELW-시세/056_국내주식-171_ELW-당일급변종목.md) |
+| ELW 투자지표추이(분별) | 국내주식-174 | GET | FHPEW02740300 | 미지원 | [057_국내주식-174_ELW-투자지표추이분별.md](rest/국내주식/ELW-시세/057_국내주식-174_ELW-투자지표추이분별.md) |
+| ELW 기초자산 목록조회 | 국내주식-185 | GET | FHKEW154100C0 | 미지원 | [058_국내주식-185_ELW-기초자산-목록조회.md](rest/국내주식/ELW-시세/058_국내주식-185_ELW-기초자산-목록조회.md) |
+| ELW 변동성 추이(일별) | 국내주식-178 | GET | FHPEW02840200 | 미지원 | [059_국내주식-178_ELW-변동성-추이일별.md](rest/국내주식/ELW-시세/059_국내주식-178_ELW-변동성-추이일별.md) |
+| ELW 거래량순위 | 국내주식-168 | GET | FHPEW02780000 | 미지원 | [060_국내주식-168_ELW-거래량순위.md](rest/국내주식/ELW-시세/060_국내주식-168_ELW-거래량순위.md) |
+| ELW 지표순위 | 국내주식-169 | GET | FHPEW02790000 | 미지원 | [061_국내주식-169_ELW-지표순위.md](rest/국내주식/ELW-시세/061_국내주식-169_ELW-지표순위.md) |
+| ELW 투자지표추이(체결) | 국내주식-172 | GET | FHPEW02740100 | 미지원 | [062_국내주식-172_ELW-투자지표추이체결.md](rest/국내주식/ELW-시세/062_국내주식-172_ELW-투자지표추이체결.md) |
+| ELW 상승률순위 | 국내주식-167 | GET | FHPEW02770000 | 미지원 | [063_국내주식-167_ELW-상승률순위.md](rest/국내주식/ELW-시세/063_국내주식-167_ELW-상승률순위.md) |
+| ELW 민감도 추이(일별) | 국내주식-176 | GET | FHPEW02830200 | 미지원 | [064_국내주식-176_ELW-민감도-추이일별.md](rest/국내주식/ELW-시세/064_국내주식-176_ELW-민감도-추이일별.md) |
+| ELW 비교대상종목조회 | 국내주식-183 | GET | FHKEW151701C0 | 미지원 | [065_국내주식-183_ELW-비교대상종목조회.md](rest/국내주식/ELW-시세/065_국내주식-183_ELW-비교대상종목조회.md) |
+| ELW 만기예정_만기종목 | 국내주식-184 | GET | FHKEW154700C0 | 미지원 | [066_국내주식-184_ELW-만기예정_만기종목.md](rest/국내주식/ELW-시세/066_국내주식-184_ELW-만기예정_만기종목.md) |
+| ELW LP매매추이 | 국내주식-182 | GET | FHPEW03760000 | 미지원 | [067_국내주식-182_ELW-LP매매추이.md](rest/국내주식/ELW-시세/067_국내주식-182_ELW-LP매매추이.md) |
+| ELW 민감도 추이(체결) | 국내주식-175 | GET | FHPEW02830100 | 미지원 | [068_국내주식-175_ELW-민감도-추이체결.md](rest/국내주식/ELW-시세/068_국내주식-175_ELW-민감도-추이체결.md) |
+| ELW 변동성 추이(틱) | 국내주식-180 | GET | FHPEW02840400 | 미지원 | [069_국내주식-180_ELW-변동성-추이틱.md](rest/국내주식/ELW-시세/069_국내주식-180_ELW-변동성-추이틱.md) |
+
+### [국내주식] 기본시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 주식현재가 일자별 | v1_국내주식-010 | GET | FHKST01010400 | 지원 | [027_v1_국내주식-010_주식현재가-일자별.md](rest/국내주식/기본시세/027_v1_국내주식-010_주식현재가-일자별.md) |
+| 주식현재가 시세 | v1_국내주식-008 | GET | FHKST01010100 | 지원 | [028_v1_국내주식-008_주식현재가-시세.md](rest/국내주식/기본시세/028_v1_국내주식-008_주식현재가-시세.md) |
+| 국내주식 시간외현재가 | 국내주식-076 | GET | FHPST02300000 | 미지원 | [029_국내주식-076_국내주식-시간외현재가.md](rest/국내주식/기본시세/029_국내주식-076_국내주식-시간외현재가.md) |
+| ETF 구성종목시세 | 국내주식-073 | GET | FHKST121600C0 | 미지원 | [030_국내주식-073_ETF-구성종목시세.md](rest/국내주식/기본시세/030_국내주식-073_ETF-구성종목시세.md) |
+| 주식현재가 시간외시간별체결 | v1_국내주식-025 | GET | FHPST02310000 | 지원 | [031_v1_국내주식-025_주식현재가-시간외시간별체결.md](rest/국내주식/기본시세/031_v1_국내주식-025_주식현재가-시간외시간별체결.md) |
+| NAV 비교추이(종목) | v1_국내주식-069 | GET | FHPST02440000 | 미지원 | [032_v1_국내주식-069_NAV-비교추이종목.md](rest/국내주식/기본시세/032_v1_국내주식-069_NAV-비교추이종목.md) |
+| 주식현재가 시간외일자별주가 | v1_국내주식-026 | GET | FHPST02320000 | 지원 | [033_v1_국내주식-026_주식현재가-시간외일자별주가.md](rest/국내주식/기본시세/033_v1_국내주식-026_주식현재가-시간외일자별주가.md) |
+| 국내주식 시간외호가 | 국내주식-077 | GET | FHPST02300400 | 미지원 | [034_국내주식-077_국내주식-시간외호가.md](rest/국내주식/기본시세/034_국내주식-077_국내주식-시간외호가.md) |
+| 주식현재가 당일시간대별체결 | v1_국내주식-023 | GET | FHPST01060000 | 지원 | [035_v1_국내주식-023_주식현재가-당일시간대별체결.md](rest/국내주식/기본시세/035_v1_국내주식-023_주식현재가-당일시간대별체결.md) |
+| 주식현재가 시세2 | v1_국내주식-054 | GET | FHPST01010000 | 미지원 | [036_v1_국내주식-054_주식현재가-시세2.md](rest/국내주식/기본시세/036_v1_국내주식-054_주식현재가-시세2.md) |
+| 주식일별분봉조회 | 국내주식-213 | GET | FHKST03010230 | 미지원 | [037_국내주식-213_주식일별분봉조회.md](rest/국내주식/기본시세/037_국내주식-213_주식일별분봉조회.md) |
+| 국내주식기간별시세(일_주_월_년) | v1_국내주식-016 | GET | FHKST03010100 | 지원 | [038_v1_국내주식-016_국내주식기간별시세일_주_월_년.md](rest/국내주식/기본시세/038_v1_국내주식-016_국내주식기간별시세일_주_월_년.md) |
+| NAV 비교추이(일) | v1_국내주식-071 | GET | FHPST02440200 | 미지원 | [039_v1_국내주식-071_NAV-비교추이일.md](rest/국내주식/기본시세/039_v1_국내주식-071_NAV-비교추이일.md) |
+| 주식현재가 호가_예상체결 | v1_국내주식-011 | GET | FHKST01010200 | 지원 | [040_v1_국내주식-011_주식현재가-호가_예상체결.md](rest/국내주식/기본시세/040_v1_국내주식-011_주식현재가-호가_예상체결.md) |
+| 주식현재가 체결 | v1_국내주식-009 | GET | FHKST01010300 | 지원 | [041_v1_국내주식-009_주식현재가-체결.md](rest/국내주식/기본시세/041_v1_국내주식-009_주식현재가-체결.md) |
+| 주식현재가 회원사 | v1_국내주식-013 | GET | FHKST01010600 | 지원 | [042_v1_국내주식-013_주식현재가-회원사.md](rest/국내주식/기본시세/042_v1_국내주식-013_주식현재가-회원사.md) |
+| NAV 비교추이(분) | v1_국내주식-070 | GET | FHPST02440100 | 미지원 | [043_v1_국내주식-070_NAV-비교추이분.md](rest/국내주식/기본시세/043_v1_국내주식-070_NAV-비교추이분.md) |
+| 주식현재가 투자자 | v1_국내주식-012 | GET | FHKST01010900 | 지원 | [044_v1_국내주식-012_주식현재가-투자자.md](rest/국내주식/기본시세/044_v1_국내주식-012_주식현재가-투자자.md) |
+| ETF_ETN 현재가 | v1_국내주식-068 | GET | FHPST02400000 | 미지원 | [045_v1_국내주식-068_ETF_ETN-현재가.md](rest/국내주식/기본시세/045_v1_국내주식-068_ETF_ETN-현재가.md) |
+| 국내주식 장마감 예상체결가 | 국내주식-120 | GET | FHKST117300C0 | 미지원 | [046_국내주식-120_국내주식-장마감-예상체결가.md](rest/국내주식/기본시세/046_국내주식-120_국내주식-장마감-예상체결가.md) |
+| 주식당일분봉조회 | v1_국내주식-022 | GET | FHKST03010200 | 지원 | [047_v1_국내주식-022_주식당일분봉조회.md](rest/국내주식/기본시세/047_v1_국내주식-022_주식당일분봉조회.md) |
+
+### [국내주식] 순위분석
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 국내주식 예상체결 상승_하락상위 | v1_국내주식-103 | GET | FHPST01820000 | 미지원 | [139_v1_국내주식-103_국내주식-예상체결-상승_하락상위.md](rest/국내주식/순위분석/139_v1_국내주식-103_국내주식-예상체결-상승_하락상위.md) |
+| 국내주식 호가잔량 순위 | 국내주식-089 | GET | FHPST01720000 | 미지원 | [140_국내주식-089_국내주식-호가잔량-순위.md](rest/국내주식/순위분석/140_국내주식-089_국내주식-호가잔량-순위.md) |
+| 국내주식 신용잔고 상위 | 국내주식-109 | GET | FHKST17010000 | 미지원 | [141_국내주식-109_국내주식-신용잔고-상위.md](rest/국내주식/순위분석/141_국내주식-109_국내주식-신용잔고-상위.md) |
+| 국내주식 시간외거래량순위 | 국내주식-139 | GET | FHPST02350000 | 미지원 | [142_국내주식-139_국내주식-시간외거래량순위.md](rest/국내주식/순위분석/142_국내주식-139_국내주식-시간외거래량순위.md) |
+| 국내주식 배당률 상위 | 국내주식-106 | GET | HHKDB13470100 | 미지원 | [143_국내주식-106_국내주식-배당률-상위.md](rest/국내주식/순위분석/143_국내주식-106_국내주식-배당률-상위.md) |
+| 국내주식 시간외잔량 순위 | v1_국내주식-093 | GET | FHPST01760000 | 미지원 | [144_v1_국내주식-093_국내주식-시간외잔량-순위.md](rest/국내주식/순위분석/144_v1_국내주식-093_국내주식-시간외잔량-순위.md) |
+| 국내주식 공매도 상위종목 | 국내주식-133 | GET | FHPST04820000 | 미지원 | [145_국내주식-133_국내주식-공매도-상위종목.md](rest/국내주식/순위분석/145_국내주식-133_국내주식-공매도-상위종목.md) |
+| 국내주식 이격도 순위 | v1_국내주식-095 | GET | FHPST01780000 | 미지원 | [146_v1_국내주식-095_국내주식-이격도-순위.md](rest/국내주식/순위분석/146_v1_국내주식-095_국내주식-이격도-순위.md) |
+| HTS조회상위20종목 | 국내주식-214 | GET | HHMCM000100C0 | 미지원 | [147_국내주식-214_HTS조회상위20종목.md](rest/국내주식/순위분석/147_국내주식-214_HTS조회상위20종목.md) |
+| 거래량순위 | v1_국내주식-047 | GET | FHPST01710000 | 미지원 | [148_v1_국내주식-047_거래량순위.md](rest/국내주식/순위분석/148_v1_국내주식-047_거래량순위.md) |
+| 국내주식 수익자산지표 순위 | v1_국내주식-090 | GET | FHPST01730000 | 미지원 | [149_v1_국내주식-090_국내주식-수익자산지표-순위.md](rest/국내주식/순위분석/149_v1_국내주식-090_국내주식-수익자산지표-순위.md) |
+| 국내주식 신고_신저근접종목 상위 | v1_국내주식-105 | GET | FHPST01870000 | 미지원 | [150_v1_국내주식-105_국내주식-신고_신저근접종목-상위.md](rest/국내주식/순위분석/150_v1_국내주식-105_국내주식-신고_신저근접종목-상위.md) |
+| 국내주식 우선주_괴리율 상위 | v1_국내주식-094 | GET | FHPST01770000 | 미지원 | [151_v1_국내주식-094_국내주식-우선주_괴리율-상위.md](rest/국내주식/순위분석/151_v1_국내주식-094_국내주식-우선주_괴리율-상위.md) |
+| 국내주식 대량체결건수 상위 | 국내주식-107 | GET | FHKST190900C0 | 미지원 | [152_국내주식-107_국내주식-대량체결건수-상위.md](rest/국내주식/순위분석/152_국내주식-107_국내주식-대량체결건수-상위.md) |
+| 국내주식 재무비율 순위 | v1_국내주식-092 | GET | FHPST01750000 | 미지원 | [153_v1_국내주식-092_국내주식-재무비율-순위.md](rest/국내주식/순위분석/153_v1_국내주식-092_국내주식-재무비율-순위.md) |
+| 국내주식 시가총액 상위 | v1_국내주식-091 | GET | FHPST01740000 | 미지원 | [154_v1_국내주식-091_국내주식-시가총액-상위.md](rest/국내주식/순위분석/154_v1_국내주식-091_국내주식-시가총액-상위.md) |
+| 국내주식 당사매매종목 상위 | v1_국내주식-104 | GET | FHPST01860000 | 미지원 | [155_v1_국내주식-104_국내주식-당사매매종목-상위.md](rest/국내주식/순위분석/155_v1_국내주식-104_국내주식-당사매매종목-상위.md) |
+| 국내주식 등락률 순위 | v1_국내주식-088 | GET | FHPST01700000 | 미지원 | [156_v1_국내주식-088_국내주식-등락률-순위.md](rest/국내주식/순위분석/156_v1_국내주식-088_국내주식-등락률-순위.md) |
+| 국내주식 시장가치 순위 | v1_국내주식-096 | GET | FHPST01790000 | 미지원 | [157_v1_국내주식-096_국내주식-시장가치-순위.md](rest/국내주식/순위분석/157_v1_국내주식-096_국내주식-시장가치-순위.md) |
+| 국내주식 관심종목등록 상위 | v1_국내주식-102 | GET | FHPST01800000 | 미지원 | [158_v1_국내주식-102_국내주식-관심종목등록-상위.md](rest/국내주식/순위분석/158_v1_국내주식-102_국내주식-관심종목등록-상위.md) |
+| 국내주식 체결강도 상위 | v1_국내주식-101 | GET | FHPST01680000 | 미지원 | [159_v1_국내주식-101_국내주식-체결강도-상위.md](rest/국내주식/순위분석/159_v1_국내주식-101_국내주식-체결강도-상위.md) |
+| 국내주식 시간외등락율순위 | 국내주식-138 | GET | FHPST02340000 | 미지원 | [160_국내주식-138_국내주식-시간외등락율순위.md](rest/국내주식/순위분석/160_국내주식-138_국내주식-시간외등락율순위.md) |
+
+### [국내주식] 시세분석
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 프로그램매매 종합현황(시간) | 국내주식-114 | GET | FHPPG04600101 | 미지원 | [110_국내주식-114_프로그램매매-종합현황시간.md](rest/국내주식/시세분석/110_국내주식-114_프로그램매매-종합현황시간.md) |
+| 국내주식 신용잔고 일별추이 | 국내주식-110 | GET | FHPST04760000 | 미지원 | [111_국내주식-110_국내주식-신용잔고-일별추이.md](rest/국내주식/시세분석/111_국내주식-110_국내주식-신용잔고-일별추이.md) |
+| 시장별 투자자매매동향(일별) | 국내주식-075 | GET | FHPTJ04040000 | 미지원 | [112_국내주식-075_시장별-투자자매매동향일별.md](rest/국내주식/시세분석/112_국내주식-075_시장별-투자자매매동향일별.md) |
+| 국내주식 공매도 일별추이 | 국내주식-134 | GET | FHPST04830000 | 미지원 | [113_국내주식-134_국내주식-공매도-일별추이.md](rest/국내주식/시세분석/113_국내주식-134_국내주식-공매도-일별추이.md) |
+| 종목별 투자자매매동향(일별) | 종목별 투자자매매동향(일별) | GET | FHPTJ04160001 | 미지원 | [114_종목별-투자자매매동향일별_종목별-투자자매매동향일별.md](rest/국내주식/시세분석/114_종목별-투자자매매동향일별_종목별-투자자매매동향일별.md) |
+| 종목조건검색 목록조회 | 국내주식-038 | GET | HHKST03900300 | 미지원 | [115_국내주식-038_종목조건검색-목록조회.md](rest/국내주식/시세분석/115_국내주식-038_종목조건검색-목록조회.md) |
+| 국내주식 상하한가 포착 | 국내주식-190 | GET | FHKST130000C0 | 미지원 | [116_국내주식-190_국내주식-상하한가-포착.md](rest/국내주식/시세분석/116_국내주식-190_국내주식-상하한가-포착.md) |
+| 프로그램매매 종합현황(일별) | 국내주식-115 | GET | FHPPG04600001 | 미지원 | [117_국내주식-115_프로그램매매-종합현황일별.md](rest/국내주식/시세분석/117_국내주식-115_프로그램매매-종합현황일별.md) |
+| 종목별 일별 대차거래추이 | 국내주식-135 | GET | HHPST074500C0 | 미지원 | [118_국내주식-135_종목별-일별-대차거래추이.md](rest/국내주식/시세분석/118_국내주식-135_종목별-일별-대차거래추이.md) |
+| 종목조건검색조회 | 국내주식-039 | GET | HHKST03900400 | 미지원 | [119_국내주식-039_종목조건검색조회.md](rest/국내주식/시세분석/119_국내주식-039_종목조건검색조회.md) |
+| 국내주식 매물대_거래비중 | 국내주식-196 | GET | FHPST01130000 | 미지원 | [120_국내주식-196_국내주식-매물대_거래비중.md](rest/국내주식/시세분석/120_국내주식-196_국내주식-매물대_거래비중.md) |
+| 국내기관_외국인 매매종목가집계 | 국내주식-037 | GET | FHPTJ04400000 | 미지원 | [121_국내주식-037_국내기관_외국인-매매종목가집계.md](rest/국내주식/시세분석/121_국내주식-037_국내기관_외국인-매매종목가집계.md) |
+| 관심종목 그룹별 종목조회 | 국내주식-203 | GET | HHKCM113004C6 | 미지원 | [122_국내주식-203_관심종목-그룹별-종목조회.md](rest/국내주식/시세분석/122_국내주식-203_관심종목-그룹별-종목조회.md) |
+| 주식현재가 회원사 종목매매동향 | 국내주식-197 | GET | FHPST04540000 | 미지원 | [123_국내주식-197_주식현재가-회원사-종목매매동향.md](rest/국내주식/시세분석/123_국내주식-197_주식현재가-회원사-종목매매동향.md) |
+| 종목별 프로그램매매추이(일별) | 국내주식-113 | GET | FHPPG04650201 | 미지원 | [124_국내주식-113_종목별-프로그램매매추이일별.md](rest/국내주식/시세분석/124_국내주식-113_종목별-프로그램매매추이일별.md) |
+| 관심종목 그룹조회 | 국내주식-204 | GET | HHKCM113004C7 | 미지원 | [125_국내주식-204_관심종목-그룹조회.md](rest/국내주식/시세분석/125_국내주식-204_관심종목-그룹조회.md) |
+| 종목별 외인기관 추정가집계 | v1_국내주식-046 | GET | HHPTJ04160200 | 미지원 | [126_v1_국내주식-046_종목별-외인기관-추정가집계.md](rest/국내주식/시세분석/126_v1_국내주식-046_종목별-외인기관-추정가집계.md) |
+| 종목별일별매수매도체결량 | v1_국내주식-056 | GET | FHKST03010800 | 미지원 | [127_v1_국내주식-056_종목별일별매수매도체결량.md](rest/국내주식/시세분석/127_v1_국내주식-056_종목별일별매수매도체결량.md) |
+| 국내주식 체결금액별 매매비중 | 국내주식-192 | GET | FHKST111900C0 | 미지원 | [128_국내주식-192_국내주식-체결금액별-매매비중.md](rest/국내주식/시세분석/128_국내주식-192_국내주식-체결금액별-매매비중.md) |
+| 프로그램매매 투자자매매동향(당일) | 국내주식-116 | GET | HHPPG046600C1 | 미지원 | [129_국내주식-116_프로그램매매-투자자매매동향당일.md](rest/국내주식/시세분석/129_국내주식-116_프로그램매매-투자자매매동향당일.md) |
+| 국내 증시자금 종합 | 국내주식-193 | GET | FHKST649100C0 | 미지원 | [130_국내주식-193_국내-증시자금-종합.md](rest/국내주식/시세분석/130_국내주식-193_국내-증시자금-종합.md) |
+| 국내주식 예상체결가 추이 | 국내주식-118 | GET | FHPST01810000 | 미지원 | [131_국내주식-118_국내주식-예상체결가-추이.md](rest/국내주식/시세분석/131_국내주식-118_국내주식-예상체결가-추이.md) |
+| 시장별 투자자매매동향(시세) | v1_국내주식-074 | GET | FHPTJ04030000 | 미지원 | [133_v1_국내주식-074_시장별-투자자매매동향시세.md](rest/국내주식/시세분석/133_v1_국내주식-074_시장별-투자자매매동향시세.md) |
+| 종목별 프로그램매매추이(체결) | v1_국내주식-044 | GET | FHPPG04650101 | 미지원 | [134_v1_국내주식-044_종목별-프로그램매매추이체결.md](rest/국내주식/시세분석/134_v1_국내주식-044_종목별-프로그램매매추이체결.md) |
+| 외국계 매매종목 가집계 | 국내주식-161 | GET | FHKST644100C0 | 미지원 | [135_국내주식-161_외국계-매매종목-가집계.md](rest/국내주식/시세분석/135_국내주식-161_외국계-매매종목-가집계.md) |
+| 국내주식 시간외예상체결등락률 | 국내주식-140 | GET | FHKST11860000 | 미지원 | [136_국내주식-140_국내주식-시간외예상체결등락률.md](rest/국내주식/시세분석/136_국내주식-140_국내주식-시간외예상체결등락률.md) |
+| 종목별 외국계 순매수추이 | 국내주식-164 | GET | FHKST644400C0 | 미지원 | [137_국내주식-164_종목별-외국계-순매수추이.md](rest/국내주식/시세분석/137_국내주식-164_종목별-외국계-순매수추이.md) |
+| 관심종목(멀티종목) 시세조회 | 국내주식-205 | GET | FHKST11300006 | 미지원 | [138_국내주식-205_관심종목멀티종목-시세조회.md](rest/국내주식/시세분석/138_국내주식-205_관심종목멀티종목-시세조회.md) |
+
+### [국내주식] 실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 국내주식 장운영정보 (통합) | 국내주식 장운영정보 (통합) | POST | H0UNMKO0 | 미지원 | [162_국내주식-장운영정보-통합_국내주식-장운영정보-통합.md](rest/국내주식/실시간시세/162_국내주식-장운영정보-통합_국내주식-장운영정보-통합.md) |
+| 국내주식 장운영정보 (NXT) | 국내주식 장운영정보 (NXT) | POST | H0NXMKO0 | 미지원 | [187_국내주식-장운영정보-NXT_국내주식-장운영정보-NXT.md](rest/국내주식/실시간시세/187_국내주식-장운영정보-NXT_국내주식-장운영정보-NXT.md) |
+
+### [국내주식] 업종/기타
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 국내주식 예상체결지수 추이 | 국내주식-121 | GET | FHPST01840000 | 미지원 | [070_국내주식-121_국내주식-예상체결지수-추이.md](rest/국내주식/업종/기타/070_국내주식-121_국내주식-예상체결지수-추이.md) |
+| 국내주식업종기간별시세(일_주_월_년) | v1_국내주식-021 | GET | FHKUP03500100 | 지원 | [071_v1_국내주식-021_국내주식업종기간별시세일_주_월_년.md](rest/국내주식/업종/기타/071_v1_국내주식-021_국내주식업종기간별시세일_주_월_년.md) |
+| 국내업종 시간별지수(분) | 국내주식-119 | GET | FHPUP02110200 | 미지원 | [072_국내주식-119_국내업종-시간별지수분.md](rest/국내주식/업종/기타/072_국내주식-119_국내업종-시간별지수분.md) |
+| 국내업종 구분별전체시세 | v1_국내주식-066 | GET | FHPUP02140000 | 미지원 | [073_v1_국내주식-066_국내업종-구분별전체시세.md](rest/국내주식/업종/기타/073_v1_국내주식-066_국내업종-구분별전체시세.md) |
+| 업종 분봉조회 | v1_국내주식-045 | GET | FHKUP03500200 | 미지원 | [074_v1_국내주식-045_업종-분봉조회.md](rest/국내주식/업종/기타/074_v1_국내주식-045_업종-분봉조회.md) |
+| 국내휴장일조회 | 국내주식-040 | GET | CTCA0903R | 미지원 | [075_국내주식-040_국내휴장일조회.md](rest/국내주식/업종/기타/075_국내주식-040_국내휴장일조회.md) |
+| 국내주식 예상체결 전체지수 | 국내주식-122 | GET | FHKUP11750000 | 미지원 | [076_국내주식-122_국내주식-예상체결-전체지수.md](rest/국내주식/업종/기타/076_국내주식-122_국내주식-예상체결-전체지수.md) |
+| 국내업종 현재지수 | v1_국내주식-063 | GET | FHPUP02100000 | 미지원 | [077_v1_국내주식-063_국내업종-현재지수.md](rest/국내주식/업종/기타/077_v1_국내주식-063_국내업종-현재지수.md) |
+| 국내선물 영업일조회 | 국내주식-160 | GET | HHMCM000002C0 | 미지원 | [078_국내주식-160_국내선물-영업일조회.md](rest/국내주식/업종/기타/078_국내주식-160_국내선물-영업일조회.md) |
+| 국내업종 시간별지수(초) | 국내주식-064 | GET | FHPUP02110100 | 미지원 | [079_국내주식-064_국내업종-시간별지수초.md](rest/국내주식/업종/기타/079_국내주식-064_국내업종-시간별지수초.md) |
+| 국내업종 일자별지수 | v1_국내주식-065 | GET | FHPUP02120000 | 미지원 | [080_v1_국내주식-065_국내업종-일자별지수.md](rest/국내주식/업종/기타/080_v1_국내주식-065_국내업종-일자별지수.md) |
+| 금리 종합(국내채권_금리) | 국내주식-155 | GET | FHPST07020000 | 미지원 | [081_국내주식-155_금리-종합국내채권_금리.md](rest/국내주식/업종/기타/081_국내주식-155_금리-종합국내채권_금리.md) |
+| 변동성완화장치(VI) 현황 | v1_국내주식-055 | GET | FHPST01390000 | 미지원 | [082_v1_국내주식-055_변동성완화장치VI-현황.md](rest/국내주식/업종/기타/082_v1_국내주식-055_변동성완화장치VI-현황.md) |
+| 종합 시황_공시(제목) | 국내주식-141 | GET | FHKST01011800 | 미지원 | [083_국내주식-141_종합-시황_공시제목.md](rest/국내주식/업종/기타/083_국내주식-141_종합-시황_공시제목.md) |
+
+### [국내주식] 종목정보
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 상품기본조회 | v1_국내주식-029 | GET | CTPF1604R | 미지원 | [084_v1_국내주식-029_상품기본조회.md](rest/국내주식/종목정보/084_v1_국내주식-029_상품기본조회.md) |
+| 예탁원정보(상장정보일정) | 국내주식-150 | GET | HHKDB669107C0 | 미지원 | [085_국내주식-150_예탁원정보상장정보일정.md](rest/국내주식/종목정보/085_국내주식-150_예탁원정보상장정보일정.md) |
+| 예탁원정보(공모주청약일정) | 국내주식-151 | GET | HHKDB669108C0 | 미지원 | [086_국내주식-151_예탁원정보공모주청약일정.md](rest/국내주식/종목정보/086_국내주식-151_예탁원정보공모주청약일정.md) |
+| 국내주식 재무비율 | v1_국내주식-080 | GET | FHKST66430300 | 미지원 | [087_v1_국내주식-080_국내주식-재무비율.md](rest/국내주식/종목정보/087_v1_국내주식-080_국내주식-재무비율.md) |
+| 예탁원정보(자본감소일정) | 국내주식-149 | GET | HHKDB669106C0 | 미지원 | [088_국내주식-149_예탁원정보자본감소일정.md](rest/국내주식/종목정보/088_국내주식-149_예탁원정보자본감소일정.md) |
+| 예탁원정보(무상증자일정) | 국내주식-144 | GET | HHKDB669101C0 | 미지원 | [089_국내주식-144_예탁원정보무상증자일정.md](rest/국내주식/종목정보/089_국내주식-144_예탁원정보무상증자일정.md) |
+| 국내주식 증권사별 투자의견 | 국내주식-189 | GET | FHKST663400C0 | 미지원 | [090_국내주식-189_국내주식-증권사별-투자의견.md](rest/국내주식/종목정보/090_국내주식-189_국내주식-증권사별-투자의견.md) |
+| 국내주식 당사 신용가능종목 | 국내주식-111 | GET | FHPST04770000 | 미지원 | [091_국내주식-111_국내주식-당사-신용가능종목.md](rest/국내주식/종목정보/091_국내주식-111_국내주식-당사-신용가능종목.md) |
+| 예탁원정보(주식매수청구일정) | 국내주식-146 | GET | HHKDB669103C0 | 미지원 | [092_국내주식-146_예탁원정보주식매수청구일정.md](rest/국내주식/종목정보/092_국내주식-146_예탁원정보주식매수청구일정.md) |
+| 예탁원정보(액면교체일정) | 국내주식-148 | GET | HHKDB669105C0 | 미지원 | [093_국내주식-148_예탁원정보액면교체일정.md](rest/국내주식/종목정보/093_국내주식-148_예탁원정보액면교체일정.md) |
+| 예탁원정보(배당일정) | 국내주식-145 | GET | HHKDB669102C0 | 미지원 | [094_국내주식-145_예탁원정보배당일정.md](rest/국내주식/종목정보/094_국내주식-145_예탁원정보배당일정.md) |
+| 국내주식 종목투자의견 | 국내주식-188 | GET | FHKST663300C0 | 미지원 | [095_국내주식-188_국내주식-종목투자의견.md](rest/국내주식/종목정보/095_국내주식-188_국내주식-종목투자의견.md) |
+| 국내주식 안정성비율 | v1_국내주식-083 | GET | FHKST66430600 | 미지원 | [096_v1_국내주식-083_국내주식-안정성비율.md](rest/국내주식/종목정보/096_v1_국내주식-083_국내주식-안정성비율.md) |
+| 국내주식 수익성비율 | v1_국내주식-081 | GET | FHKST66430400 | 미지원 | [097_v1_국내주식-081_국내주식-수익성비율.md](rest/국내주식/종목정보/097_v1_국내주식-081_국내주식-수익성비율.md) |
+| 예탁원정보(실권주일정) | 국내주식-152 | GET | HHKDB669109C0 | 미지원 | [098_국내주식-152_예탁원정보실권주일정.md](rest/국내주식/종목정보/098_국내주식-152_예탁원정보실권주일정.md) |
+| 예탁원정보(의무예치일정) | 국내주식-153 | GET | HHKDB669110C0 | 미지원 | [099_국내주식-153_예탁원정보의무예치일정.md](rest/국내주식/종목정보/099_국내주식-153_예탁원정보의무예치일정.md) |
+| 국내주식 손익계산서 | v1_국내주식-079 | GET | FHKST66430200 | 미지원 | [100_v1_국내주식-079_국내주식-손익계산서.md](rest/국내주식/종목정보/100_v1_국내주식-079_국내주식-손익계산서.md) |
+| 당사 대주가능 종목 | 국내주식-195 | GET | CTSC2702R | 미지원 | [101_국내주식-195_당사-대주가능-종목.md](rest/국내주식/종목정보/101_국내주식-195_당사-대주가능-종목.md) |
+| 주식기본조회 | v1_국내주식-067 | GET | CTPF1002R | 미지원 | [102_v1_국내주식-067_주식기본조회.md](rest/국내주식/종목정보/102_v1_국내주식-067_주식기본조회.md) |
+| 예탁원정보(유상증자일정) | 국내주식-143 | GET | HHKDB669100C0 | 미지원 | [103_국내주식-143_예탁원정보유상증자일정.md](rest/국내주식/종목정보/103_국내주식-143_예탁원정보유상증자일정.md) |
+| 예탁원정보(주주총회일정) | 국내주식-154 | GET | HHKDB669111C0 | 미지원 | [104_국내주식-154_예탁원정보주주총회일정.md](rest/국내주식/종목정보/104_국내주식-154_예탁원정보주주총회일정.md) |
+| 국내주식 성장성비율 | v1_국내주식-085 | GET | FHKST66430800 | 미지원 | [105_v1_국내주식-085_국내주식-성장성비율.md](rest/국내주식/종목정보/105_v1_국내주식-085_국내주식-성장성비율.md) |
+| 국내주식 대차대조표 | v1_국내주식-078 | GET | FHKST66430100 | 미지원 | [106_v1_국내주식-078_국내주식-대차대조표.md](rest/국내주식/종목정보/106_v1_국내주식-078_국내주식-대차대조표.md) |
+| 예탁원정보(합병_분할일정) | 국내주식-147 | GET | HHKDB669104C0 | 미지원 | [107_국내주식-147_예탁원정보합병_분할일정.md](rest/국내주식/종목정보/107_국내주식-147_예탁원정보합병_분할일정.md) |
+| 국내주식 종목추정실적 | 국내주식-187 | GET | HHKST668300C0 | 미지원 | [108_국내주식-187_국내주식-종목추정실적.md](rest/국내주식/종목정보/108_국내주식-187_국내주식-종목추정실적.md) |
+| 국내주식 기타주요비율 | v1_국내주식-082 | GET | FHKST66430500 | 미지원 | [109_v1_국내주식-082_국내주식-기타주요비율.md](rest/국내주식/종목정보/109_v1_국내주식-082_국내주식-기타주요비율.md) |
+
+### [국내주식] 주문/계좌
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 기간별계좌권리현황조회 | 국내주식-211 | GET | CTRGA011R | 미지원 | [004_국내주식-211_기간별계좌권리현황조회.md](rest/국내주식/주문/계좌/004_국내주식-211_기간별계좌권리현황조회.md) |
+| 투자계좌자산현황조회 | v1_국내주식-048 | GET | CTRP6548R | 미지원 | [005_v1_국내주식-048_투자계좌자산현황조회.md](rest/국내주식/주문/계좌/005_v1_국내주식-048_투자계좌자산현황조회.md) |
+| 퇴직연금 예수금조회 | v1_국내주식-035 | GET | TTTC0506R | 미지원 | [006_v1_국내주식-035_퇴직연금-예수금조회.md](rest/국내주식/주문/계좌/006_v1_국내주식-035_퇴직연금-예수금조회.md) |
+| 주식예약주문정정취소 | v1_국내주식-018,019 | POST | (예약취소) CTSC0009U (예약정정) CTSC0013U | 미지원 | [007_v1_국내주식-018,019_주식예약주문정정취소.md](rest/국내주식/주문/계좌/007_v1_국내주식-018,019_주식예약주문정정취소.md) |
+| 신용매수가능조회 | v1_국내주식-042 | GET | TTTC8909R | 미지원 | [008_v1_국내주식-042_신용매수가능조회.md](rest/국내주식/주문/계좌/008_v1_국내주식-042_신용매수가능조회.md) |
+| 주식통합증거금 현황 | 국내주식-191 | GET | TTTC0869R | 미지원 | [009_국내주식-191_주식통합증거금-현황.md](rest/국내주식/주문/계좌/009_국내주식-191_주식통합증거금-현황.md) |
+| 퇴직연금 미체결내역 | v1_국내주식-033 | GET | TTTC2201R(기존 KRX만 가능), TTTC2210R (KRX,NXT/SOR) | 미지원 | [010_v1_국내주식-033_퇴직연금-미체결내역.md](rest/국내주식/주문/계좌/010_v1_국내주식-033_퇴직연금-미체결내역.md) |
+| 기간별매매손익현황조회 | v1_국내주식-060 | GET | TTTC8715R | 미지원 | [011_v1_국내주식-060_기간별매매손익현황조회.md](rest/국내주식/주문/계좌/011_v1_국내주식-060_기간별매매손익현황조회.md) |
+| 주식주문(정정취소) | v1_국내주식-003 | POST | TTTC0013U | 지원 | [012_v1_국내주식-003_주식주문정정취소.md](rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md) |
+| 주식예약주문조회 | v1_국내주식-020 | GET | CTSC0004R | 미지원 | [013_v1_국내주식-020_주식예약주문조회.md](rest/국내주식/주문/계좌/013_v1_국내주식-020_주식예약주문조회.md) |
+| 퇴직연금 매수가능조회 | v1_국내주식-034 | GET | TTTC0503R | 미지원 | [014_v1_국내주식-034_퇴직연금-매수가능조회.md](rest/국내주식/주문/계좌/014_v1_국내주식-034_퇴직연금-매수가능조회.md) |
+| 주식잔고조회 | v1_국내주식-006 | GET | TTTC8434R | 지원 | [015_v1_국내주식-006_주식잔고조회.md](rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md) |
+| 퇴직연금 체결기준잔고 | v1_국내주식-032 | GET | TTTC2202R | 미지원 | [016_v1_국내주식-032_퇴직연금-체결기준잔고.md](rest/국내주식/주문/계좌/016_v1_국내주식-032_퇴직연금-체결기준잔고.md) |
+| 매수가능조회 | v1_국내주식-007 | GET | TTTC8908R | 지원 | [017_v1_국내주식-007_매수가능조회.md](rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md) |
+| 기간별손익일별합산조회 | v1_국내주식-052 | GET | TTTC8708R | 미지원 | [018_v1_국내주식-052_기간별손익일별합산조회.md](rest/국내주식/주문/계좌/018_v1_국내주식-052_기간별손익일별합산조회.md) |
+| 주식주문(현금) | v1_국내주식-001 | POST | (매도) TTTC0011U (매수) TTTC0012U | 지원 | [019_v1_국내주식-001_주식주문현금.md](rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md) |
+| 매도가능수량조회 | 국내주식-165 | GET | TTTC8408R | 미지원 | [020_국내주식-165_매도가능수량조회.md](rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md) |
+| 주식일별주문체결조회 | v1_국내주식-005 | GET | (3개월이내) TTTC0081R (3개월이전) CTSC9215R | 지원 | [021_v1_국내주식-005_주식일별주문체결조회.md](rest/국내주식/주문/계좌/021_v1_국내주식-005_주식일별주문체결조회.md) |
+| 주식정정취소가능주문조회 | v1_국내주식-004 | GET | TTTC0084R | 미지원 | [022_v1_국내주식-004_주식정정취소가능주문조회.md](rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md) |
+| 주식예약주문 | v1_국내주식-017 | POST | CTSC0008U | 미지원 | [023_v1_국내주식-017_주식예약주문.md](rest/국내주식/주문/계좌/023_v1_국내주식-017_주식예약주문.md) |
+| 주식주문(신용) | v1_국내주식-002 | POST | (매도) TTTC0051U (매수) TTTC0052U | 미지원 | [024_v1_국내주식-002_주식주문신용.md](rest/국내주식/주문/계좌/024_v1_국내주식-002_주식주문신용.md) |
+| 퇴직연금 잔고조회 | v1_국내주식-036 | GET | TTTC2208R | 미지원 | [025_v1_국내주식-036_퇴직연금-잔고조회.md](rest/국내주식/주문/계좌/025_v1_국내주식-036_퇴직연금-잔고조회.md) |
+| 주식잔고조회_실현손익 | v1_국내주식-041 | GET | TTTC8494R | 미지원 | [026_v1_국내주식-041_주식잔고조회_실현손익.md](rest/국내주식/주문/계좌/026_v1_국내주식-041_주식잔고조회_실현손익.md) |
+
+### [장내채권] 기본시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 장내채권현재가(호가) | 국내주식-132 | GET | FHKBJ773401C0 | 미지원 | [327_국내주식-132_장내채권현재가호가.md](rest/장내채권/기본시세/327_국내주식-132_장내채권현재가호가.md) |
+| 장내채권현재가(시세) | 국내주식-200 | GET | FHKBJ773400C0 | 미지원 | [328_국내주식-200_장내채권현재가시세.md](rest/장내채권/기본시세/328_국내주식-200_장내채권현재가시세.md) |
+| 장내채권현재가(체결) | 국내주식-201 | GET | FHKBJ773403C0 | 미지원 | [329_국내주식-201_장내채권현재가체결.md](rest/장내채권/기본시세/329_국내주식-201_장내채권현재가체결.md) |
+| 장내채권현재가(일별) | 국내주식-202 | GET | FHKBJ773404C0 | 미지원 | [330_국내주식-202_장내채권현재가일별.md](rest/장내채권/기본시세/330_국내주식-202_장내채권현재가일별.md) |
+| 장내채권 기간별시세(일) | 국내주식-159 | GET | FHKBJ773701C0 | 미지원 | [331_국내주식-159_장내채권-기간별시세일.md](rest/장내채권/기본시세/331_국내주식-159_장내채권-기간별시세일.md) |
+| 장내채권 평균단가조회 | 국내주식-158 | GET | CTPF2005R | 미지원 | [332_국내주식-158_장내채권-평균단가조회.md](rest/장내채권/기본시세/332_국내주식-158_장내채권-평균단가조회.md) |
+| 장내채권 발행정보 | 국내주식-156 | GET | CTPF1101R | 미지원 | [333_국내주식-156_장내채권-발행정보.md](rest/장내채권/기본시세/333_국내주식-156_장내채권-발행정보.md) |
+| 장내채권 기본조회 | 국내주식-129 | GET | CTPF1114R | 미지원 | [334_국내주식-129_장내채권-기본조회.md](rest/장내채권/기본시세/334_국내주식-129_장내채권-기본조회.md) |
+
+### [장내채권] 주문/계좌
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 장내채권 매수주문 | 국내주식-124 | POST | TTTC0952U | 미지원 | [320_국내주식-124_장내채권-매수주문.md](rest/장내채권/주문/계좌/320_국내주식-124_장내채권-매수주문.md) |
+| 장내채권 매도주문 | 국내주식-123 | POST | TTTC0958U | 미지원 | [321_국내주식-123_장내채권-매도주문.md](rest/장내채권/주문/계좌/321_국내주식-123_장내채권-매도주문.md) |
+| 장내채권 정정취소주문 | 국내주식-125 | POST | TTTC0953U | 미지원 | [322_국내주식-125_장내채권-정정취소주문.md](rest/장내채권/주문/계좌/322_국내주식-125_장내채권-정정취소주문.md) |
+| 채권정정취소가능주문조회 | 국내주식-126 | GET | CTSC8035R | 미지원 | [323_국내주식-126_채권정정취소가능주문조회.md](rest/장내채권/주문/계좌/323_국내주식-126_채권정정취소가능주문조회.md) |
+| 장내채권 주문체결내역 | 국내주식-127 | GET | CTSC8013R | 미지원 | [324_국내주식-127_장내채권-주문체결내역.md](rest/장내채권/주문/계좌/324_국내주식-127_장내채권-주문체결내역.md) |
+| 장내채권 잔고조회 | 국내주식-198 | GET | CTSC8407R | 미지원 | [325_국내주식-198_장내채권-잔고조회.md](rest/장내채권/주문/계좌/325_국내주식-198_장내채권-잔고조회.md) |
+| 장내채권 매수가능조회 | 국내주식-199 | GET | TTTC8910R | 미지원 | [326_국내주식-199_장내채권-매수가능조회.md](rest/장내채권/주문/계좌/326_국내주식-199_장내채권-매수가능조회.md) |
+
+### [해외선물옵션] 기본시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외선물종목현재가 | v1_해외선물-009 | GET | HHDFC55010000 | 미지원 | [296_v1_해외선물-009_해외선물종목현재가.md](rest/해외선물옵션/기본시세/296_v1_해외선물-009_해외선물종목현재가.md) |
+| 해외선물종목상세 | v1_해외선물-008 | GET | HHDFC55010100 | 미지원 | [297_v1_해외선물-008_해외선물종목상세.md](rest/해외선물옵션/기본시세/297_v1_해외선물-008_해외선물종목상세.md) |
+| 해외선물 호가 | 해외선물-031 | GET | HHDFC86000000 | 미지원 | [298_해외선물-031_해외선물-호가.md](rest/해외선물옵션/기본시세/298_해외선물-031_해외선물-호가.md) |
+| 해외선물 분봉조회 | 해외선물-016 | GET | HHDFC55020400 | 미지원 | [299_해외선물-016_해외선물-분봉조회.md](rest/해외선물옵션/기본시세/299_해외선물-016_해외선물-분봉조회.md) |
+| 해외선물 체결추이(틱) | 해외선물-019 | GET | HHDFC55020200 | 미지원 | [300_해외선물-019_해외선물-체결추이틱.md](rest/해외선물옵션/기본시세/300_해외선물-019_해외선물-체결추이틱.md) |
+| 해외선물 체결추이(주간) | 해외선물-017 | GET | HHDFC55020000 | 미지원 | [301_해외선물-017_해외선물-체결추이주간.md](rest/해외선물옵션/기본시세/301_해외선물-017_해외선물-체결추이주간.md) |
+| 해외선물 체결추이(일간) | 해외선물-018 | GET | HHDFC55020100 | 미지원 | [302_해외선물-018_해외선물-체결추이일간.md](rest/해외선물옵션/기본시세/302_해외선물-018_해외선물-체결추이일간.md) |
+| 해외선물 체결추이(월간) | 해외선물-020 | GET | HHDFC55020300 | 미지원 | [303_해외선물-020_해외선물-체결추이월간.md](rest/해외선물옵션/기본시세/303_해외선물-020_해외선물-체결추이월간.md) |
+| 해외선물 상품기본정보 | 해외선물-023 | GET | HHDFC55200000 | 미지원 | [304_해외선물-023_해외선물-상품기본정보.md](rest/해외선물옵션/기본시세/304_해외선물-023_해외선물-상품기본정보.md) |
+| 해외선물 미결제추이 | 해외선물-029 | GET | HHDDB95030000 | 미지원 | [305_해외선물-029_해외선물-미결제추이.md](rest/해외선물옵션/기본시세/305_해외선물-029_해외선물-미결제추이.md) |
+| 해외옵션종목현재가 | 해외선물-035 | GET | HHDFO55010000 | 미지원 | [306_해외선물-035_해외옵션종목현재가.md](rest/해외선물옵션/기본시세/306_해외선물-035_해외옵션종목현재가.md) |
+| 해외옵션종목상세 | 해외선물-034 | GET | HHDFO55010100 | 미지원 | [307_해외선물-034_해외옵션종목상세.md](rest/해외선물옵션/기본시세/307_해외선물-034_해외옵션종목상세.md) |
+| 해외옵션 호가 | 해외선물-033 | GET | HHDFO86000000 | 미지원 | [308_해외선물-033_해외옵션-호가.md](rest/해외선물옵션/기본시세/308_해외선물-033_해외옵션-호가.md) |
+| 해외옵션 분봉조회 | 해외선물-040 | GET | HHDFO55020400 | 미지원 | [309_해외선물-040_해외옵션-분봉조회.md](rest/해외선물옵션/기본시세/309_해외선물-040_해외옵션-분봉조회.md) |
+| 해외옵션 체결추이(틱) | 해외선물-038 | GET | HHDFO55020200 | 미지원 | [310_해외선물-038_해외옵션-체결추이틱.md](rest/해외선물옵션/기본시세/310_해외선물-038_해외옵션-체결추이틱.md) |
+| 해외옵션 체결추이(일간) | 해외선물-037 | GET | HHDFO55020100 | 미지원 | [311_해외선물-037_해외옵션-체결추이일간.md](rest/해외선물옵션/기본시세/311_해외선물-037_해외옵션-체결추이일간.md) |
+| 해외옵션 체결추이(주간) | 해외선물-036 | GET | HHDFO55020000 | 미지원 | [312_해외선물-036_해외옵션-체결추이주간.md](rest/해외선물옵션/기본시세/312_해외선물-036_해외옵션-체결추이주간.md) |
+| 해외옵션 체결추이(월간) | 해외선물-039 | GET | HHDFO55020300 | 미지원 | [313_해외선물-039_해외옵션-체결추이월간.md](rest/해외선물옵션/기본시세/313_해외선물-039_해외옵션-체결추이월간.md) |
+| 해외옵션 상품기본정보 | 해외선물-041 | GET | HHDFO55200000 | 미지원 | [314_해외선물-041_해외옵션-상품기본정보.md](rest/해외선물옵션/기본시세/314_해외선물-041_해외옵션-상품기본정보.md) |
+| 해외선물옵션 장운영시간 | 해외선물-030 | GET | OTFM2229R | 미지원 | [315_해외선물-030_해외선물옵션-장운영시간.md](rest/해외선물옵션/기본시세/315_해외선물-030_해외선물옵션-장운영시간.md) |
+
+### [해외선물옵션] 주문/계좌
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외선물옵션 주문 | v1_해외선물-001 | POST | OTFM3001U | 미지원 | [285_v1_해외선물-001_해외선물옵션-주문.md](rest/해외선물옵션/주문/계좌/285_v1_해외선물-001_해외선물옵션-주문.md) |
+| 해외선물옵션 정정취소주문 | v1_해외선물-002, 003 | POST | (정정) OTFM3002U (취소) OTFM3003U | 미지원 | [286_v1_해외선물-002,-003_해외선물옵션-정정취소주문.md](rest/해외선물옵션/주문/계좌/286_v1_해외선물-002,-003_해외선물옵션-정정취소주문.md) |
+| 해외선물옵션 당일주문내역조회 | v1_해외선물-004 | GET | OTFM3116R | 미지원 | [287_v1_해외선물-004_해외선물옵션-당일주문내역조회.md](rest/해외선물옵션/주문/계좌/287_v1_해외선물-004_해외선물옵션-당일주문내역조회.md) |
+| 해외선물옵션 미결제내역조회(잔고) | v1_해외선물-005 | GET | OTFM1412R | 미지원 | [288_v1_해외선물-005_해외선물옵션-미결제내역조회잔고.md](rest/해외선물옵션/주문/계좌/288_v1_해외선물-005_해외선물옵션-미결제내역조회잔고.md) |
+| 해외선물옵션 주문가능조회 | v1_해외선물-006 | GET | OTFM3304R | 미지원 | [289_v1_해외선물-006_해외선물옵션-주문가능조회.md](rest/해외선물옵션/주문/계좌/289_v1_해외선물-006_해외선물옵션-주문가능조회.md) |
+| 해외선물옵션 기간계좌손익 일별 | 해외선물-010 | GET | OTFM3118R | 미지원 | [290_해외선물-010_해외선물옵션-기간계좌손익-일별.md](rest/해외선물옵션/주문/계좌/290_해외선물-010_해외선물옵션-기간계좌손익-일별.md) |
+| 해외선물옵션 일별 체결내역 | 해외선물-011 | GET | OTFM3122R | 미지원 | [291_해외선물-011_해외선물옵션-일별-체결내역.md](rest/해외선물옵션/주문/계좌/291_해외선물-011_해외선물옵션-일별-체결내역.md) |
+| 해외선물옵션 예수금현황 | 해외선물-012 | GET | OTFM1411R | 미지원 | [292_해외선물-012_해외선물옵션-예수금현황.md](rest/해외선물옵션/주문/계좌/292_해외선물-012_해외선물옵션-예수금현황.md) |
+| 해외선물옵션 일별 주문내역 | 해외선물-013 | GET | OTFM3120R | 미지원 | [293_해외선물-013_해외선물옵션-일별-주문내역.md](rest/해외선물옵션/주문/계좌/293_해외선물-013_해외선물옵션-일별-주문내역.md) |
+| 해외선물옵션 기간계좌거래내역 | 해외선물-014 | GET | OTFM3114R | 미지원 | [294_해외선물-014_해외선물옵션-기간계좌거래내역.md](rest/해외선물옵션/주문/계좌/294_해외선물-014_해외선물옵션-기간계좌거래내역.md) |
+| 해외선물옵션 증거금상세 | 해외선물-032 | GET | OTFM3115R | 미지원 | [295_해외선물-032_해외선물옵션-증거금상세.md](rest/해외선물옵션/주문/계좌/295_해외선물-032_해외선물옵션-증거금상세.md) |
+
+### [해외주식] 기본시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외주식 체결추이 | 해외주식-037 | GET | HHDFS76200300 | 미지원 | [252_해외주식-037_해외주식-체결추이.md](rest/해외주식/기본시세/252_해외주식-037_해외주식-체결추이.md) |
+| 해외주식 기간별시세 | v1_해외주식-010 | GET | HHDFS76240000 | 지원 | [253_v1_해외주식-010_해외주식-기간별시세.md](rest/해외주식/기본시세/253_v1_해외주식-010_해외주식-기간별시세.md) |
+| 해외결제일자조회 | 해외주식-017 | GET | CTOS5011R | 미지원 | [254_해외주식-017_해외결제일자조회.md](rest/해외주식/기본시세/254_해외주식-017_해외결제일자조회.md) |
+| 해외주식 현재체결가 | v1_해외주식-009 | GET | HHDFS00000300 | 지원 | [255_v1_해외주식-009_해외주식-현재체결가.md](rest/해외주식/기본시세/255_v1_해외주식-009_해외주식-현재체결가.md) |
+| 해외주식 복수종목 시세조회 | 해외주식 복수종목 시세조회 | GET | HHDFS76220000 | 미지원 | [256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md](rest/해외주식/기본시세/256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md) |
+| 해외주식조건검색 | v1_해외주식-015 | GET | HHDFS76410000 | 지원 | [257_v1_해외주식-015_해외주식조건검색.md](rest/해외주식/기본시세/257_v1_해외주식-015_해외주식조건검색.md) |
+| 해외주식 상품기본정보 | v1_해외주식-034 | GET | CTPF1702R | 미지원 | [258_v1_해외주식-034_해외주식-상품기본정보.md](rest/해외주식/기본시세/258_v1_해외주식-034_해외주식-상품기본정보.md) |
+| 해외지수분봉조회 | v1_해외주식-031 | GET | FHKST03030200 | 미지원 | [259_v1_해외주식-031_해외지수분봉조회.md](rest/해외주식/기본시세/259_v1_해외주식-031_해외지수분봉조회.md) |
+| 해외주식분봉조회 | v1_해외주식-030 | GET | HHDFS76950200 | 미지원 | [260_v1_해외주식-030_해외주식분봉조회.md](rest/해외주식/기본시세/260_v1_해외주식-030_해외주식분봉조회.md) |
+| 해외주식 현재가상세 | v1_해외주식-029 | GET | HHDFS76200200 | 미지원 | [261_v1_해외주식-029_해외주식-현재가상세.md](rest/해외주식/기본시세/261_v1_해외주식-029_해외주식-현재가상세.md) |
+| 해외주식 업종별코드조회 | 해외주식-049 | GET | HHDFS76370100 | 미지원 | [262_해외주식-049_해외주식-업종별코드조회.md](rest/해외주식/기본시세/262_해외주식-049_해외주식-업종별코드조회.md) |
+| 해외주식 종목_지수_환율기간별시세(일_주_월_년) | v1_해외주식-012 | GET | FHKST03030100 | 지원 | [263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md](rest/해외주식/기본시세/263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md) |
+| 해외주식 업종별시세 | 해외주식-048 | GET | HHDFS76370000 | 미지원 | [264_해외주식-048_해외주식-업종별시세.md](rest/해외주식/기본시세/264_해외주식-048_해외주식-업종별시세.md) |
+| 해외주식 현재가 호가 | 해외주식-033 | GET | HHDFS76200100 | 미지원 | [265_해외주식-033_해외주식-현재가-호가.md](rest/해외주식/기본시세/265_해외주식-033_해외주식-현재가-호가.md) |
+
+### [해외주식] 시세분석
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외주식 거래증가율순위 | 해외주식-045 | GET | HHDFS76330000 | 미지원 | [266_해외주식-045_해외주식-거래증가율순위.md](rest/해외주식/시세분석/266_해외주식-045_해외주식-거래증가율순위.md) |
+| 해외주식 기간별권리조회 | 해외주식-052 | GET | CTRGT011R | 미지원 | [267_해외주식-052_해외주식-기간별권리조회.md](rest/해외주식/시세분석/267_해외주식-052_해외주식-기간별권리조회.md) |
+| 해외주식 가격급등락 | 해외주식-038 | GET | HHDFS76260000 | 미지원 | [268_해외주식-038_해외주식-가격급등락.md](rest/해외주식/시세분석/268_해외주식-038_해외주식-가격급등락.md) |
+| 해외주식 거래대금순위 | 해외주식-044 | GET | HHDFS76320010 | 미지원 | [269_해외주식-044_해외주식-거래대금순위.md](rest/해외주식/시세분석/269_해외주식-044_해외주식-거래대금순위.md) |
+| 해외주식 거래량급증 | 해외주식-039 | GET | HHDFS76270000 | 미지원 | [270_해외주식-039_해외주식-거래량급증.md](rest/해외주식/시세분석/270_해외주식-039_해외주식-거래량급증.md) |
+| 해외주식 신고_신저가 | 해외주식-042 | GET | HHDFS76300000 | 미지원 | [271_해외주식-042_해외주식-신고_신저가.md](rest/해외주식/시세분석/271_해외주식-042_해외주식-신고_신저가.md) |
+| 해외주식 매수체결강도상위 | 해외주식-040 | GET | HHDFS76280000 | 미지원 | [272_해외주식-040_해외주식-매수체결강도상위.md](rest/해외주식/시세분석/272_해외주식-040_해외주식-매수체결강도상위.md) |
+| 해외주식 거래회전율순위 | 해외주식-046 | GET | HHDFS76340000 | 미지원 | [273_해외주식-046_해외주식-거래회전율순위.md](rest/해외주식/시세분석/273_해외주식-046_해외주식-거래회전율순위.md) |
+| 해외뉴스종합(제목) | 해외주식-053 | GET | HHPSTH60100C1 | 미지원 | [274_해외주식-053_해외뉴스종합제목.md](rest/해외주식/시세분석/274_해외주식-053_해외뉴스종합제목.md) |
+| 당사 해외주식담보대출 가능 종목 | 해외주식-051 | GET | CTLN4050R | 미지원 | [275_해외주식-051_당사-해외주식담보대출-가능-종목.md](rest/해외주식/시세분석/275_해외주식-051_당사-해외주식담보대출-가능-종목.md) |
+| 해외주식 시가총액순위 | 해외주식-047 | GET | HHDFS76350100 | 미지원 | [276_해외주식-047_해외주식-시가총액순위.md](rest/해외주식/시세분석/276_해외주식-047_해외주식-시가총액순위.md) |
+| 해외속보(제목) | 해외주식-055 | GET | FHKST01011801 | 미지원 | [277_해외주식-055_해외속보제목.md](rest/해외주식/시세분석/277_해외주식-055_해외속보제목.md) |
+| 해외주식 상승율_하락율 | 해외주식-041 | GET | HHDFS76290000 | 미지원 | [278_해외주식-041_해외주식-상승율_하락율.md](rest/해외주식/시세분석/278_해외주식-041_해외주식-상승율_하락율.md) |
+| 해외주식 권리종합 | 해외주식-050 | GET | HHDFS78330900 | 미지원 | [279_해외주식-050_해외주식-권리종합.md](rest/해외주식/시세분석/279_해외주식-050_해외주식-권리종합.md) |
+| 해외주식 거래량순위 | 해외주식-043 | GET | HHDFS76310010 | 미지원 | [280_해외주식-043_해외주식-거래량순위.md](rest/해외주식/시세분석/280_해외주식-043_해외주식-거래량순위.md) |
+
+### [해외주식] 주문/계좌
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외주식 잔고 | v1_해외주식-006 | GET | TTTS3012R | 지원 | [234_v1_해외주식-006_해외주식-잔고.md](rest/해외주식/주문/계좌/234_v1_해외주식-006_해외주식-잔고.md) |
+| 해외주식 체결기준현재잔고 | v1_해외주식-008 | GET | CTRP6504R | 지원 | [235_v1_해외주식-008_해외주식-체결기준현재잔고.md](rest/해외주식/주문/계좌/235_v1_해외주식-008_해외주식-체결기준현재잔고.md) |
+| 해외주식 지정가체결내역조회 | 해외주식-070 | GET | TTTS6059R | 미지원 | [236_해외주식-070_해외주식-지정가체결내역조회.md](rest/해외주식/주문/계좌/236_해외주식-070_해외주식-지정가체결내역조회.md) |
+| 해외주식 기간손익 | v1_해외주식-032 | GET | TTTS3039R | 미지원 | [237_v1_해외주식-032_해외주식-기간손익.md](rest/해외주식/주문/계좌/237_v1_해외주식-032_해외주식-기간손익.md) |
+| 해외주식 매수가능금액조회 | v1_해외주식-014 | GET | TTTS3007R | 지원 | [238_v1_해외주식-014_해외주식-매수가능금액조회.md](rest/해외주식/주문/계좌/238_v1_해외주식-014_해외주식-매수가능금액조회.md) |
+| 해외주식 정정취소주문 | v1_해외주식-003 | POST | (미국 정정·취소) TTTT1004U (아시아 국가 하단 규격서 참고) | 지원 | [239_v1_해외주식-003_해외주식-정정취소주문.md](rest/해외주식/주문/계좌/239_v1_해외주식-003_해외주식-정정취소주문.md) |
+| 해외주식 예약주문접수 | v1_해외주식-002 | POST | (미국예약매수) TTTT3014U (미국예약매도) TTTT3016U (중국/홍콩/일본/베트남 예약주문) TTTS3013U | 지원 | [240_v1_해외주식-002_해외주식-예약주문접수.md](rest/해외주식/주문/계좌/240_v1_해외주식-002_해외주식-예약주문접수.md) |
+| 해외주식 미체결내역 | v1_해외주식-005 | GET | TTTS3018R | 미지원 | [241_v1_해외주식-005_해외주식-미체결내역.md](rest/해외주식/주문/계좌/241_v1_해외주식-005_해외주식-미체결내역.md) |
+| 해외주식 미국주간정정취소 | v1_해외주식-027 | POST | TTTS6038U | 미지원 | [242_v1_해외주식-027_해외주식-미국주간정정취소.md](rest/해외주식/주문/계좌/242_v1_해외주식-027_해외주식-미국주간정정취소.md) |
+| 해외주식 주문체결내역 | v1_해외주식-007 | GET | TTTS3035R | 지원 | [243_v1_해외주식-007_해외주식-주문체결내역.md](rest/해외주식/주문/계좌/243_v1_해외주식-007_해외주식-주문체결내역.md) |
+| 해외주식 결제기준잔고 | 해외주식-064 | GET | CTRP6010R | 미지원 | [244_해외주식-064_해외주식-결제기준잔고.md](rest/해외주식/주문/계좌/244_해외주식-064_해외주식-결제기준잔고.md) |
+| 해외주식 일별거래내역 | 해외주식-063 | GET | CTOS4001R | 미지원 | [245_해외주식-063_해외주식-일별거래내역.md](rest/해외주식/주문/계좌/245_해외주식-063_해외주식-일별거래내역.md) |
+| 해외주식 미국주간주문 | v1_해외주식-026 | POST | (주간매수) TTTS6036U (주간매도) TTTS6037U | 미지원 | [246_v1_해외주식-026_해외주식-미국주간주문.md](rest/해외주식/주문/계좌/246_v1_해외주식-026_해외주식-미국주간주문.md) |
+| 해외주식 예약주문조회 | v1_해외주식-013 | GET | (미국) TTTT3039R (일본/중국/홍콩/베트남) TTTS3014R | 미지원 | [247_v1_해외주식-013_해외주식-예약주문조회.md](rest/해외주식/주문/계좌/247_v1_해외주식-013_해외주식-예약주문조회.md) |
+| 해외주식 주문 | v1_해외주식-001 | POST | (미국매수) TTTT1002U (미국매도) TTTT1006U (아시아 국가 하단 규격서 참고) | 지원 | [248_v1_해외주식-001_해외주식-주문.md](rest/해외주식/주문/계좌/248_v1_해외주식-001_해외주식-주문.md) |
+| 해외주식 예약주문접수취소 | v1_해외주식-004 | POST | (미국 예약주문 취소접수) TTTT3017U (아시아국가 미제공) | 지원 | [249_v1_해외주식-004_해외주식-예약주문접수취소.md](rest/해외주식/주문/계좌/249_v1_해외주식-004_해외주식-예약주문접수취소.md) |
+| 해외주식 지정가주문번호조회 | 해외주식-071 | GET | TTTS6058R | 미지원 | [250_해외주식-071_해외주식-지정가주문번호조회.md](rest/해외주식/주문/계좌/250_해외주식-071_해외주식-지정가주문번호조회.md) |
+| 해외증거금 통화별조회 | 해외주식-035 | GET | TTTC2101R | 미지원 | [251_해외주식-035_해외증거금-통화별조회.md](rest/해외주식/주문/계좌/251_해외주식-035_해외증거금-통화별조회.md) |
+
+## WEBSOCKET
+
+### OAuth인증
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 실시간 (웹소켓) 접속키 발급 | 실시간-000 | POST | 없음 | 지원 | [001_실시간-000_실시간-웹소켓-접속키-발급.md](websocket/oauth/001_실시간-000_실시간-웹소켓-접속키-발급.md) |
+
+### [국내선물옵션] 실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 주식옵션 실시간호가 | 실시간-045 | POST | H0ZOASP0 | 미지원 | [214_실시간-045_주식옵션-실시간호가.md](websocket/국내선물옵션/실시간시세/214_실시간-045_주식옵션-실시간호가.md) |
+| 선물옵션 실시간체결통보 | 실시간-012 | POST | H0IFCNI0 | 지원 | [215_실시간-012_선물옵션-실시간체결통보.md](websocket/국내선물옵션/실시간시세/215_실시간-012_선물옵션-실시간체결통보.md) |
+| KRX야간선물 실시간종목체결 | 실시간-064 | POST | H0MFCNT0 | 미지원 | [216_실시간-064_KRX야간선물-실시간종목체결.md](websocket/국내선물옵션/실시간시세/216_실시간-064_KRX야간선물-실시간종목체결.md) |
+| KRX야간선물 실시간호가 | 실시간-065 | POST | H0MFASP0 | 미지원 | [217_실시간-065_KRX야간선물-실시간호가.md](websocket/국내선물옵션/실시간시세/217_실시간-065_KRX야간선물-실시간호가.md) |
+| KRX야간옵션 실시간체결가 | 실시간-032 | POST | H0EUCNT0 | 미지원 | [218_실시간-032_KRX야간옵션-실시간체결가.md](websocket/국내선물옵션/실시간시세/218_실시간-032_KRX야간옵션-실시간체결가.md) |
+| KRX야간옵션실시간예상체결 | 실시간-034 | POST | H0EUANC0 | 미지원 | [219_실시간-034_KRX야간옵션실시간예상체결.md](websocket/국내선물옵션/실시간시세/219_실시간-034_KRX야간옵션실시간예상체결.md) |
+| 지수선물 실시간체결가 | 실시간-010 | POST | H0IFCNT0 | 미지원 | [220_실시간-010_지수선물-실시간체결가.md](websocket/국내선물옵션/실시간시세/220_실시간-010_지수선물-실시간체결가.md) |
+| 주식선물 실시간예상체결 | 실시간-031 | POST | H0ZFANC0 | 미지원 | [221_실시간-031_주식선물-실시간예상체결.md](websocket/국내선물옵션/실시간시세/221_실시간-031_주식선물-실시간예상체결.md) |
+| KRX야간옵션실시간체결통보 | 실시간-067 | POST | H0MFCNI0 | 미지원 | [222_실시간-067_KRX야간옵션실시간체결통보.md](websocket/국내선물옵션/실시간시세/222_실시간-067_KRX야간옵션실시간체결통보.md) |
+| KRX야간선물 실시간체결통보 | 실시간-066 | POST | H0MFCNI0 | 미지원 | [223_실시간-066_KRX야간선물-실시간체결통보.md](websocket/국내선물옵션/실시간시세/223_실시간-066_KRX야간선물-실시간체결통보.md) |
+| 상품선물 실시간체결가 | 실시간-022 | POST | H0CFCNT0 | 미지원 | [224_실시간-022_상품선물-실시간체결가.md](websocket/국내선물옵션/실시간시세/224_실시간-022_상품선물-실시간체결가.md) |
+| 지수선물 실시간호가 | 실시간-011 | POST | H0IFASP0 | 미지원 | [225_실시간-011_지수선물-실시간호가.md](websocket/국내선물옵션/실시간시세/225_실시간-011_지수선물-실시간호가.md) |
+| 지수옵션 실시간체결가 | 실시간-014 | POST | H0IOCNT0 | 미지원 | [226_실시간-014_지수옵션-실시간체결가.md](websocket/국내선물옵션/실시간시세/226_실시간-014_지수옵션-실시간체결가.md) |
+| KRX야간옵션 실시간호가 | 실시간-033 | POST | H0EUASP0 | 미지원 | [227_실시간-033_KRX야간옵션-실시간호가.md](websocket/국내선물옵션/실시간시세/227_실시간-033_KRX야간옵션-실시간호가.md) |
+| 상품선물 실시간호가 | 실시간-023 | POST | H0CFASP0 | 미지원 | [228_실시간-023_상품선물-실시간호가.md](websocket/국내선물옵션/실시간시세/228_실시간-023_상품선물-실시간호가.md) |
+| 주식옵션 실시간예상체결 | 실시간-046 | POST | H0ZOANC0 | 미지원 | [229_실시간-046_주식옵션-실시간예상체결.md](websocket/국내선물옵션/실시간시세/229_실시간-046_주식옵션-실시간예상체결.md) |
+| 주식선물 실시간호가 | 실시간-030 | POST | H0ZFASP0 | 미지원 | [230_실시간-030_주식선물-실시간호가.md](websocket/국내선물옵션/실시간시세/230_실시간-030_주식선물-실시간호가.md) |
+| 주식옵션 실시간체결가 | 실시간-044 | POST | H0ZOCNT0 | 미지원 | [231_실시간-044_주식옵션-실시간체결가.md](websocket/국내선물옵션/실시간시세/231_실시간-044_주식옵션-실시간체결가.md) |
+| 지수옵션 실시간호가 | 실시간-015 | POST | H0IOASP0 | 미지원 | [232_실시간-015_지수옵션-실시간호가.md](websocket/국내선물옵션/실시간시세/232_실시간-015_지수옵션-실시간호가.md) |
+| 주식선물 실시간체결가 | 실시간-029 | POST | H0ZFCNT0 | 미지원 | [233_실시간-029_주식선물-실시간체결가.md](websocket/국내선물옵션/실시간시세/233_실시간-029_주식선물-실시간체결가.md) |
+
+### [국내주식] 시세분석
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 회원사 실시간 매매동향(틱) | 국내주식-163 | GET | FHPST04320000 | 미지원 | [132_국내주식-163_회원사-실시간-매매동향틱.md](websocket/국내주식/시세분석/132_국내주식-163_회원사-실시간-매매동향틱.md) |
+
+### [국내주식] 실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 국내지수 실시간예상체결 | 실시간-027 | POST | H0UPANC0 | 미지원 | [161_실시간-027_국내지수-실시간예상체결.md](websocket/국내주식/실시간시세/161_실시간-027_국내지수-실시간예상체결.md) |
+| 국내주식 실시간회원사 (NXT) | 국내주식 실시간회원사 (NXT) | POST | H0NXMBC0 | 미지원 | [163_국내주식-실시간회원사-NXT_국내주식-실시간회원사-NXT.md](websocket/국내주식/실시간시세/163_국내주식-실시간회원사-NXT_국내주식-실시간회원사-NXT.md) |
+| 국내주식 실시간체결통보 | 실시간-005 | POST | H0STCNI0 | 지원 | [164_실시간-005_국내주식-실시간체결통보.md](websocket/국내주식/실시간시세/164_실시간-005_국내주식-실시간체결통보.md) |
+| 국내주식 시간외 실시간예상체결 (KRX) | 실시간-024 | POST | H0STOAC0 | 미지원 | [165_실시간-024_국내주식-시간외-실시간예상체결-KRX.md](websocket/국내주식/실시간시세/165_실시간-024_국내주식-시간외-실시간예상체결-KRX.md) |
+| 국내주식 시간외 실시간호가 (KRX) | 실시간-025 | POST | H0STOAA0 | 미지원 | [166_실시간-025_국내주식-시간외-실시간호가-KRX.md](websocket/국내주식/실시간시세/166_실시간-025_국내주식-시간외-실시간호가-KRX.md) |
+| 국내주식 실시간프로그램매매 (통합) | 국내주식 실시간프로그램매매 (통합) | POST | H0UNPGM0 | 미지원 | [167_국내주식-실시간프로그램매매-통합_국내주식-실시간프로그램매매-통합.md](websocket/국내주식/실시간시세/167_국내주식-실시간프로그램매매-통합_국내주식-실시간프로그램매매-통합.md) |
+| 국내주식 실시간호가 (통합) | 국내주식 실시간호가 (통합) | POST | H0UNASP0 | 미지원 | [168_국내주식-실시간호가-통합_국내주식-실시간호가-통합.md](websocket/국내주식/실시간시세/168_국내주식-실시간호가-통합_국내주식-실시간호가-통합.md) |
+| 국내주식 실시간프로그램매매 (KRX) | 실시간-048 | POST | H0STPGM0 | 미지원 | [169_실시간-048_국내주식-실시간프로그램매매-KRX.md](websocket/국내주식/실시간시세/169_실시간-048_국내주식-실시간프로그램매매-KRX.md) |
+| 국내주식 장운영정보 (KRX) | 실시간-049 | POST | H0STMKO0 | 미지원 | [170_실시간-049_국내주식-장운영정보-KRX.md](websocket/국내주식/실시간시세/170_실시간-049_국내주식-장운영정보-KRX.md) |
+| 국내주식 실시간체결가 (KRX) | 실시간-003 | POST | H0STCNT0 | 지원 | [171_실시간-003_국내주식-실시간체결가-KRX.md](websocket/국내주식/실시간시세/171_실시간-003_국내주식-실시간체결가-KRX.md) |
+| 국내지수 실시간프로그램매매 | 실시간-028 | POST | H0UPPGM0 | 미지원 | [172_실시간-028_국내지수-실시간프로그램매매.md](websocket/국내주식/실시간시세/172_실시간-028_국내지수-실시간프로그램매매.md) |
+| 국내주식 실시간회원사 (통합) | 국내주식 실시간회원사 (통합) | POST | H0UNMBC0 | 미지원 | [173_국내주식-실시간회원사-통합_국내주식-실시간회원사-통합.md](websocket/국내주식/실시간시세/173_국내주식-실시간회원사-통합_국내주식-실시간회원사-통합.md) |
+| 국내지수 실시간체결 | 실시간-026 | POST | H0UPCNT0 | 미지원 | [174_실시간-026_국내지수-실시간체결.md](websocket/국내주식/실시간시세/174_실시간-026_국내지수-실시간체결.md) |
+| 국내주식 실시간예상체결 (KRX) | 실시간-041 | POST | H0STANC0 | 미지원 | [175_실시간-041_국내주식-실시간예상체결-KRX.md](websocket/국내주식/실시간시세/175_실시간-041_국내주식-실시간예상체결-KRX.md) |
+| ELW 실시간호가 | 실시간-062 | POST | H0EWASP0 | 미지원 | [176_실시간-062_ELW-실시간호가.md](websocket/국내주식/실시간시세/176_실시간-062_ELW-실시간호가.md) |
+| 국내주식 실시간호가 (KRX) | 실시간-004 | POST | H0STASP0 | 지원 | [177_실시간-004_국내주식-실시간호가-KRX.md](websocket/국내주식/실시간시세/177_실시간-004_국내주식-실시간호가-KRX.md) |
+| 국내주식 실시간체결가 (통합) | 국내주식 실시간체결가 (통합) | POST | H0UNCNT0 | 미지원 | [178_국내주식-실시간체결가-통합_국내주식-실시간체결가-통합.md](websocket/국내주식/실시간시세/178_국내주식-실시간체결가-통합_국내주식-실시간체결가-통합.md) |
+| 국내주식 실시간호가 (NXT) | 국내주식 실시간호가 (NXT) | POST | H0NXASP0 | 미지원 | [179_국내주식-실시간호가-NXT_국내주식-실시간호가-NXT.md](websocket/국내주식/실시간시세/179_국내주식-실시간호가-NXT_국내주식-실시간호가-NXT.md) |
+| 국내주식 실시간프로그램매매 (NXT) | 국내주식 실시간프로그램매매 (NXT) | POST | H0NXPGM0 | 미지원 | [180_국내주식-실시간프로그램매매-NXT_국내주식-실시간프로그램매매-NXT.md](websocket/국내주식/실시간시세/180_국내주식-실시간프로그램매매-NXT_국내주식-실시간프로그램매매-NXT.md) |
+| 국내주식 실시간체결가 (NXT) | 국내주식 실시간체결가 (NXT) | POST | H0NXCNT0 | 미지원 | [181_국내주식-실시간체결가-NXT_국내주식-실시간체결가-NXT.md](websocket/국내주식/실시간시세/181_국내주식-실시간체결가-NXT_국내주식-실시간체결가-NXT.md) |
+| ELW 실시간체결가 | 실시간-061 | POST | H0EWCNT0 | 미지원 | [182_실시간-061_ELW-실시간체결가.md](websocket/국내주식/실시간시세/182_실시간-061_ELW-실시간체결가.md) |
+| ELW 실시간예상체결 | 실시간-063 | POST | H0EWANC0 | 미지원 | [183_실시간-063_ELW-실시간예상체결.md](websocket/국내주식/실시간시세/183_실시간-063_ELW-실시간예상체결.md) |
+| 국내주식 실시간예상체결 (NXT) | 국내주식 실시간예상체결 (NXT) | POST | H0NXANC0 | 미지원 | [184_국내주식-실시간예상체결-NXT_국내주식-실시간예상체결-NXT.md](websocket/국내주식/실시간시세/184_국내주식-실시간예상체결-NXT_국내주식-실시간예상체결-NXT.md) |
+| 국내주식 실시간회원사 (KRX) | 실시간-047 | POST | H0STMBC0 | 미지원 | [185_실시간-047_국내주식-실시간회원사-KRX.md](websocket/국내주식/실시간시세/185_실시간-047_국내주식-실시간회원사-KRX.md) |
+| 국내주식 실시간예상체결 (통합) | 국내주식 실시간예상체결 (통합) | POST | H0UNANC0 | 미지원 | [186_국내주식-실시간예상체결-통합_국내주식-실시간예상체결-통합.md](websocket/국내주식/실시간시세/186_국내주식-실시간예상체결-통합_국내주식-실시간예상체결-통합.md) |
+| 국내ETF NAV추이 | 실시간-051 | POST | H0STNAV0 | 미지원 | [188_실시간-051_국내ETF-NAV추이.md](websocket/국내주식/실시간시세/188_실시간-051_국내ETF-NAV추이.md) |
+| 국내주식 시간외 실시간체결가 (KRX) | 실시간-042 | POST | H0STOUP0 | 미지원 | [189_실시간-042_국내주식-시간외-실시간체결가-KRX.md](websocket/국내주식/실시간시세/189_실시간-042_국내주식-시간외-실시간체결가-KRX.md) |
+
+### [장내채권] 실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 일반채권 실시간체결가 | 실시간-052 | POST | H0BJCNT0 | 미지원 | [335_실시간-052_일반채권-실시간체결가.md](websocket/장내채권/실시간시세/335_실시간-052_일반채권-실시간체결가.md) |
+| 일반채권 실시간호가 | 실시간-053 | POST | H0BJCNT0 | 미지원 | [336_실시간-053_일반채권-실시간호가.md](websocket/장내채권/실시간시세/336_실시간-053_일반채권-실시간호가.md) |
+| 채권지수 실시간체결가 | 실시간-060 | POST | H0BICNT0 | 미지원 | [337_실시간-060_채권지수-실시간체결가.md](websocket/장내채권/실시간시세/337_실시간-060_채권지수-실시간체결가.md) |
+
+### [해외선물옵션]실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외선물옵션 실시간체결가 | 실시간-017 | POST | HDFFF020 | 미지원 | [316_실시간-017_해외선물옵션-실시간체결가.md](websocket/해외선물옵션/실시간시세/316_실시간-017_해외선물옵션-실시간체결가.md) |
+| 해외선물옵션 실시간호가 | 실시간-018 | POST | HDFFF010 | 미지원 | [317_실시간-018_해외선물옵션-실시간호가.md](websocket/해외선물옵션/실시간시세/317_실시간-018_해외선물옵션-실시간호가.md) |
+| 해외선물옵션 실시간주문내역통보 | 실시간-019 | POST | HDFFF1C0 | 미지원 | [318_실시간-019_해외선물옵션-실시간주문내역통보.md](websocket/해외선물옵션/실시간시세/318_실시간-019_해외선물옵션-실시간주문내역통보.md) |
+| 해외선물옵션 실시간체결내역통보 | 실시간-020 | POST | HDFFF2C0 | 미지원 | [319_실시간-020_해외선물옵션-실시간체결내역통보.md](websocket/해외선물옵션/실시간시세/319_실시간-020_해외선물옵션-실시간체결내역통보.md) |
+
+### [해외주식] 실시간시세
+
+| API 명 | API ID | Method | 실전 TR_ID | 모의 | 문서 |
+| --- | --- | --- | --- | --- | --- |
+| 해외주식 실시간호가 | 실시간-021 | POST | HDFSASP0 | 미지원 | [281_실시간-021_해외주식-실시간호가.md](websocket/해외주식/실시간시세/281_실시간-021_해외주식-실시간호가.md) |
+| 해외주식 지연호가(아시아) | 실시간-008 | POST | HDFSASP1 | 미지원 | [282_실시간-008_해외주식-지연호가아시아.md](websocket/해외주식/실시간시세/282_실시간-008_해외주식-지연호가아시아.md) |
+| 해외주식 실시간지연체결가 | 실시간-007 | POST | HDFSCNT0 | 미지원 | [283_실시간-007_해외주식-실시간지연체결가.md](websocket/해외주식/실시간시세/283_실시간-007_해외주식-실시간지연체결가.md) |
+| 해외주식 실시간체결통보 | 실시간-009 | POST | H0GSCNI0 | 지원 | [284_실시간-009_해외주식-실시간체결통보.md](websocket/해외주식/실시간시세/284_실시간-009_해외주식-실시간체결통보.md) |
diff --git a/docs/broker/kis/rest/oauth/002_인증-002_접근토큰폐기P.md b/docs/broker/kis/rest/oauth/002_인증-002_접근토큰폐기P.md
new file mode 100644
index 0000000..15b6b12
--- /dev/null
+++ b/docs/broker/kis/rest/oauth/002_인증-002_접근토큰폐기P.md
@@ -0,0 +1,64 @@
+# 접근토큰폐기(P)
+
+- 원본 시트명: 접근토큰폐기(P)
+- API 통신방식: REST
+- 메뉴 위치: OAuth인증
+- API ID: 인증-002
+- HTTP Method: POST
+- 실전 TR_ID: 없음
+- 모의 TR_ID: 없음
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /oauth2/revokeP
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+부여받은 접큰토큰을 더 이상 활용하지 않을 때 사용합니다.
+
+## 레이아웃
+
+### Request Header
+
+없음
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| appkey | 고객 앱Key | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 고객 앱Secret | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| token | 접근토큰 | string | Y | 286 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| code | 응답코드 | string | N | 8 | HTTP 응답코드 |
+| message | 응답메세지 | string | N | 450 | 응답메세지 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "appkey" : "PSw2UvBQCpoZFc7nZpIfIrOttmXXXXXXXXXX",
+ "appsecret" : "/g84gaZp7W3DJEZhamiTH8ZdJkUJ8603rjo3HcOm5PvIc1YC3YmyJOQoW1H0kNjo4IbHwGUdi3+9oEbH4RKKl8GnEu3n/khxm0OrwHkQur+wbA74fcFXxaUnEbftu0X72Eaw9dEBMuK3rODeeOanrsJ1kZ9oKWykIG04F0nmgdXXXXXXXXXX",
+ "token" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0b2tlbiIsImF1ZCI6IjZmNDgxMjBiLTlmMDItNGI5ZS05MGExLTRiNDk2MGM5ZWY2MyIsImlzcyI6InVub2d3IiwiZXhwIjoxNjQzMjg2MDUzLCJpYXQiOjE2NDMxOTk2NTMsImp0aSI6IlBTdzJVdkJRQ3dvWkZhOG5acElmSXJPdHRtZUtLUGZCclNKcyJ9.6Z-UvArobBfXbnpSFbFhd9WPVEM3ZQa5NEpqfmQ6rrZBISCi-P9CEamfVReIduTVYbafF02Pl6EPXXXXXXXXXX"
+}
+```
+
+### Response Example
+
+```text
+{
+ "code" : 200,
+ "message" : "접근토큰 폐기에 성공하였습니다"
+}
+```
diff --git a/docs/broker/kis/rest/oauth/003_인증-001_접근토큰발급P.md b/docs/broker/kis/rest/oauth/003_인증-001_접근토큰발급P.md
new file mode 100644
index 0000000..7829374
--- /dev/null
+++ b/docs/broker/kis/rest/oauth/003_인증-001_접근토큰발급P.md
@@ -0,0 +1,82 @@
+# 접근토큰발급(P)
+
+- 원본 시트명: 접근토큰발급(P)
+- API 통신방식: REST
+- 메뉴 위치: OAuth인증
+- API ID: 인증-001
+- HTTP Method: POST
+- 실전 TR_ID: 없음
+- 모의 TR_ID: 없음
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /oauth2/tokenP
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+본인 계좌에 필요한 인증 절차로, 인증을 통해 접근 토큰을 부여받아 오픈API 활용이 가능합니다.
+
+1. 접근토큰(access_token)의 유효기간은 24시간 이며(1일 1회발급 원칙)
+ 갱신발급주기는 6시간 입니다.(6시간 이내는 기존 발급키로 응답)
+
+2. 접근토큰발급(/oauth2/tokenP) 시 접근토큰값(access_token)과 함께 수신되는
+ 접근토큰 유효기간(acess_token_token_expired)을 이용해 접근토큰을 관리하실 수 있습니다.
+
+
+[참고]
+
+'23.4.28 이후 지나치게 잦은 토큰 발급 요청건을 제어 하기 위해 신규 접근토큰발급 이후 일정시간 이내에 재호출 시에는 직전 토큰값을 리턴하게 되었습니다. 일정시간 이후 접근토큰발급 API 호출 시에는 신규 토큰값을 리턴합니다.
+접근토큰발급 API 호출 및 코드 작성하실 때 해당 사항을 참고하시길 바랍니다.
+
+※ 참고 : 포럼 > 공지사항 > [수정] [중요] 접근 토큰 발급 변경 안내
+
+## 레이아웃
+
+### Request Header
+
+없음
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| grant_type | 권한부여 Type | string | Y | 18 | client_credentials |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| access_token | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
ex) "eyJ0eXUxMiJ9.eyJz…..................................."
- 일반개인고객/일반법인고객
. Access token 유효기간 1일
.. 일정시간(6시간) 이내에 재호출 시에는 직전 토큰값을 리턴
. OAuth 2.0의 Client Credentials Grant 절차를 준용
- 제휴법인
. Access token 유효기간 3개월
. Refresh token 유효기간 1년
. OAuth 2.0의 Authorization Code Grant 절차를 준용 |
+| token_type | 접근토큰유형 | string | Y | 20 | 접근토큰유형 : "Bearer"
※ API 호출 시, 접근토큰유형 "Bearer" 입력. ex) "Bearer eyJ...." |
+| expires_in | 접근토큰 유효기간 | number | Y | 10 | 유효기간(초)
ex) 7776000 |
+| access_token_token_expired | 접근토큰 유효기간(일시표시) | string | Y | 50 | 유효기간(년:월:일 시:분:초)
ex) "2022-08-30 08:10:10" |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "grant_type": "client_credentials",
+ "appkey": "PSg5dctL9dKPo727J13Ur405OSXXXXXXXXXX",
+ "appsecret": "yo2t8zS68zpdjGuWvFyM9VikjXE0i0CbgPEamnqPA00G0bIfrdfQb2RUD1xP7SqatQXr1cD1fGUNsb78MMXoq6o4lAYt9YTtHAjbMoFy+c72kbq5owQY1Pvp39/x6ejpJlXCj7gE3yVOB/h25Hvl+URmYeBTfrQeOqIAOYc/OIXXXXXXXXXX"
+}
+```
+
+### Response Example
+
+```text
+{
+ "access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0b2tlbiIsImF1ZCI6ImMwNzM1NTYzLTA1MjctNDNhZS05ODRiLTJiNWI1ZWZmOWYyMyIsImlzcyI6InVub2d3IiwiZXhwIjoxNjQ5NzUxMTAwLCJpYXQiOjE2NDE5NzUxMDAsImp0aSI6IkJTZlM0QUtSSnpRVGpmdHRtdXZlenVQUTlKajc3cHZGdjBZVyJ9.Oyt_C639yUjWmRhymlszgt6jDo8fvIKkkxH1mMngunV1T15SCC4I3Xe6MXxcY23DXunzBfR1uI0KXXXXXXXXXX",
+ "access_token_token_expired":"2023-12-22 08:16:59",
+ "token_type":"Bearer",
+ "expires_in":86400
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/205_v1_국내선물-006_선물옵션-시세.md b/docs/broker/kis/rest/국내선물옵션/기본시세/205_v1_국내선물-006_선물옵션-시세.md
new file mode 100644
index 0000000..274bd8e
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/205_v1_국내선물-006_선물옵션-시세.md
@@ -0,0 +1,184 @@
+# 선물옵션 시세
+
+- 원본 시트명: 선물옵션 시세
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: v1_국내선물-006
+- HTTP Method: GET
+- 실전 TR_ID: FHMIF10000000
+- 모의 TR_ID: FHMIF10000000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 시세 API입니다.
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전/모의투자]
FHMIF10000000 : 선물 옵션 시세 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목코드 (예: 101S03) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output1 | 응답상세1 | object | Y | | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | 종목명 |
+| futs_prpr | 선물 현재가 | string | Y | 14 | 선물의 현재가격 |
+| futs_prdy_vrss | 선물 전일 대비 | string | Y | 14 | 선물의 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가) |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| futs_prdy_clpr | 선물 전일 종가 | string | Y | 14 | 해당 선물 종목의 전일 종가 |
+| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 11 | 선물 전일 대비 / 당일 현재가 * 100 |
+| acml_vol | 누적 거래량 | string | Y | 18 | 당일 조회시점까지 전체 거래량 |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | 당일 조회시점까지 전체 거래금액 |
+| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | 현재까지 반대매매로 청산되지 않은 계약수 |
+| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | 전일대비 미결제 약정 수량의 증감 |
+| futs_oprc | 선물 시가2 | string | Y | 14 | 당일 최초 거래가격 |
+| futs_hgpr | 선물 최고가 | string | Y | 14 | 당일 조회 시점까지 가장 높은 거래가격 |
+| futs_lwpr | 선물 최저가 | string | Y | 14 | 당일 조회 시점까지 가장 낮은 거래가격 |
+| futs_mxpr | 선물 상한가 | string | Y | 14 | 당일 거래 가능한 최고 가격 |
+| futs_llam | 선물 하한가 | string | Y | 14 | 당일 거래 가능한 최저 가격 |
+| basis | 베이시스 | string | Y | 13 | 이론베이시스
선물 이론가격과 현물가격과의 차이 |
+| futs_sdpr | 선물 기준가 | string | Y | 14 | |
+| hts_thpr | HTS 이론가 | string | Y | 14 | 해당 월물의 이론적 가치를 계산한 것으로 주가지수 선물 이론가격은 (주가지수 선물 이론가격 = 주가지수 + 기간이자비용 - 기간배당수입) 로 계산 |
+| dprt | 괴리율 | string | Y | 11 | 현재의 시장가가 이론가격으로부터 얼마나 벗어나 있는지에 대한 측정 자료
괴리도 = (현재가 - 이론가격) |
+| crbr_aply_mxpr | 서킷브레이커 적용 상한가 | string | Y | 14 | |
+| crbr_aply_llam | 서킷브레이커 적용 하한가 | string | Y | 14 | |
+| futs_last_tr_date | 선물 최종 거래 일자 | string | Y | 8 | 해당 선물 종목의 마지막 거래일 |
+| hts_rmnn_dynu | HTS 잔존 일수 | string | Y | 5 | 최종 거래일까지 남은 일수 |
+| futs_lstn_medm_hgpr | 선물 상장 중 최고가 | string | Y | 14 | 해당 선물 종목의 상장일 이후 최고 거래가격 |
+| futs_lstn_medm_lwpr | 선물 상장 중 최저가 | string | Y | 14 | 해당 선물 종목의 상장일 이후 최저 거래가격 |
+| delta_val | 델타 값 | string | Y | 16 | 옵션 종목의 지표값 |
+| gama | 감마 | string | Y | 13 | 옵션 종목의 지표값 |
+| theta | 세타 | string | Y | 13 | 옵션 종목의 지표값 |
+| vega | 베가 | string | Y | 13 | 옵션 종목의 지표값 |
+| rho | 로우 | string | Y | 13 | 옵션 종목의 지표값 |
+| hist_vltl | 역사적 변동성 | string | Y | 16 | 옵션 종목의 지표값 |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 16 | 옵션 종목의 지표값 |
+| mrkt_basis | 시장 베이시스 | string | Y | 13 | 시장베이시스
현재 시장에서 형성된 선물가격과 현물가격과의 차이 |
+| acpr | 행사가 | string | Y | 14 | 옵션의 행사가격 |
+| output2 | 응답상세2 | object | Y | | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | 종목명 |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 14 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 14 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 11 | |
+| output3 | 응답상세3 | object | Y | | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 14 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 14 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 11 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "F",
+"fid_input_iscd": "101S03"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "hts_kor_isnm": "F 202203",
+ "futs_prpr": "395.00",
+ "futs_prdy_vrss": "6.70",
+ "prdy_vrss_sign": "2",
+ "futs_prdy_clpr": "388.30",
+ "futs_prdy_ctrt": "1.73",
+ "acml_vol": "220924",
+ "acml_tr_pbmn": "21741293338",
+ "hts_otst_stpl_qty": "247121",
+ "otst_stpl_qty_icdc": "-592",
+ "futs_oprc": "391.05",
+ "futs_hgpr": "395.15",
+ "futs_lwpr": "391.00",
+ "futs_mxpr": "419.35",
+ "futs_llam": "357.25",
+ "basis": "0.82",
+ "futs_sdpr": "388.30",
+ "hts_thpr": "395.48",
+ "dprt": "-0.12",
+ "crbr_aply_mxpr": "0.00",
+ "crbr_aply_llam": "0.00",
+ "futs_last_tr_date": "20220310",
+ "hts_rmnn_dynu": "58",
+ "futs_lstn_medm_hgpr": "434.00",
+ "futs_lstn_medm_lwpr": "366.60",
+ "delta_val": "1.0000",
+ "gama": "0.0000",
+ "theta": "0.0000",
+ "vega": "0.0000",
+ "rho": "0.0000",
+ "mrkt_basis": "0.34"
+ },
+ "output2": {
+ "bstp_cls_code": "0001",
+ "hts_kor_isnm": "종합",
+ "bstp_nmix_prpr": "2972.48",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "45.10",
+ "bstp_nmix_prdy_ctrt": "1.54"
+ },
+ "output3": {
+ "bstp_cls_code": "2001",
+ "hts_kor_isnm": "KOSPI200",
+ "bstp_nmix_prpr": "394.66",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "5.69",
+ "bstp_nmix_prdy_ctrt": "1.46"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/206_국내선물-021_국내선물-기초자산-시세.md b/docs/broker/kis/rest/국내선물옵션/기본시세/206_국내선물-021_국내선물-기초자산-시세.md
new file mode 100644
index 0000000..345ca54
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/206_국내선물-021_국내선물-기초자산-시세.md
@@ -0,0 +1,116 @@
+# 국내선물 기초자산 시세
+
+- 원본 시트명: 국내선물 기초자산 시세
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: 국내선물-021
+- HTTP Method: GET
+- 실전 TR_ID: FHPIF05030000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-top
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내선물 기초자산 시세 API입니다.
+한국투자 HTS(eFriend Plus) > [0503] 선물옵션 종합시세(Ⅰ) 화면의 "상단 바" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPIF05030000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (F: 선물) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 선물최근월물 ex)(101V06) |
+| FID_COND_MRKT_DIV_CODE1 | 조건 시장 분류 코드 | string | Y | 2 | 공백 |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | 공백 |
+| FID_MTRT_CNT | 만기 수 | string | Y | 11 | 공백 |
+| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| unas_prpr | 기초자산 현재가 | string | Y | 112 | |
+| unas_prdy_vrss | 기초자산 전일 대비 | string | Y | 112 | |
+| unas_prdy_vrss_sign | 기초자산 전일 대비 부호 | string | Y | 1 | |
+| unas_prdy_ctrt | 기초자산 전일 대비율 | string | Y | 82 | |
+| unas_acml_vol | 기초자산 누적 거래량 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| futs_prpr | 선물 현재가 | string | Y | 112 | |
+| futs_prdy_vrss | 선물 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 82 | |
+| output2 | 응답상세 | object array | Y | | array |
+| hts_rmnn_dynu | HTS 잔존 일수 | string | Y | 5 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:F
+fid_input_iscd:101V06
+fid_cond_mrkt_div_code1:
+fid_cond_scr_div_code:
+fid_mtrt_cnt:
+fid_cond_mrkt_cls_code:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "unas_prpr": "367.25",
+ "unas_prdy_vrss": "-3.47",
+ "unas_prdy_vrss_sign": "5",
+ "unas_prdy_ctrt": "-0.94",
+ "unas_acml_vol": "161725000",
+ "hts_kor_isnm": "F 202406",
+ "futs_prpr": "369.35",
+ "futs_prdy_vrss": "-3.45",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-0.93"
+ },
+ "output2": [],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/207_국내선물-018_선물옵션-일중예상체결추이.md b/docs/broker/kis/rest/국내선물옵션/기본시세/207_국내선물-018_선물옵션-일중예상체결추이.md
new file mode 100644
index 0000000..0faf8f8
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/207_국내선물-018_선물옵션-일중예상체결추이.md
@@ -0,0 +1,805 @@
+# 선물옵션 일중예상체결추이
+
+- 원본 시트명: 선물옵션 일중예상체결추이
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: 국내선물-018
+- HTTP Method: GET
+- 실전 TR_ID: FHPIF05110100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/exp-price-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 일중예상체결추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0548] 선물옵션 예상체결추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPIF05110100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (지수선물:6자리, 지수옵션 9자리) |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | F : 지수선물, O : 지수옵션 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| hts_kor_isnm | 영업 시간 | string | Y | 40 | |
+| futs_antc_cnpr | 업종 지수 현재가 | string | Y | 112 | |
+| antc_cntg_vrss_sign | 업종 지수 전일 대비 | string | Y | 1 | |
+| futs_antc_cntg_vrss | 전일 대비 부호 | string | Y | 112 | |
+| antc_cntg_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| futs_sdpr | 누적 거래 대금 | string | Y | 112 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
+| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
+| antc_cntg_vrss_sign | 예상체결대비부호 | string | Y | 1 | |
+| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
+| antc_cntg_prdy_ctrt | 예상체결전일대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:F
+FID_INPUT_ISCD:101V06
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "hts_kor_isnm": "F 202406",
+ "futs_antc_cnpr": "0.000",
+ "antc_cntg_vrss_sign": "0",
+ "futs_antc_cntg_vrss": "0.000",
+ "antc_cntg_prdy_ctrt": "0.00",
+ "futs_sdpr": "376.95"
+ },
+ "output2": [
+ {
+ "stck_cntg_hour": "084500",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "380.00",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.05",
+ "antc_cntg_prdy_ctrt": "0.81"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "380.00",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.05",
+ "antc_cntg_prdy_ctrt": "0.81"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "380.00",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.05",
+ "antc_cntg_prdy_ctrt": "0.81"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "380.00",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.05",
+ "antc_cntg_prdy_ctrt": "0.81"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.95",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "3.00",
+ "antc_cntg_prdy_ctrt": "0.80"
+ },
+ {
+ "stck_cntg_hour": "084459",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.90",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.95",
+ "antc_cntg_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.80",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.85",
+ "antc_cntg_prdy_ctrt": "0.76"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.80",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.85",
+ "antc_cntg_prdy_ctrt": "0.76"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084458",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.75",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.80",
+ "antc_cntg_prdy_ctrt": "0.74"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084457",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084456",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084455",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.70",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.75",
+ "antc_cntg_prdy_ctrt": "0.73"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.60",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.65",
+ "antc_cntg_prdy_ctrt": "0.70"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084454",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.65",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.70",
+ "antc_cntg_prdy_ctrt": "0.72"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.60",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.65",
+ "antc_cntg_prdy_ctrt": "0.70"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_cntg_hour": "084453",
+ "futs_antc_cnpr": "379.55",
+ "antc_cntg_vrss_sign": "2",
+ "futs_antc_cntg_vrss": "2.60",
+ "antc_cntg_prdy_ctrt": "0.69"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md b/docs/broker/kis/rest/국내선물옵션/기본시세/208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md
new file mode 100644
index 0000000..322ee18
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md
@@ -0,0 +1,159 @@
+# 선물옵션기간별시세(일_주_월_년)
+
+- 원본 시트명: 선물옵션기간별시세(일_주_월_년)
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: v1_국내선물-008
+- HTTP Method: GET
+- 실전 TR_ID: FHKIF03020100
+- 모의 TR_ID: FHKIF03020100
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-daily-fuopchartprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(지수)선물옵션 기간별시세 데이터(일/주/월/년) 조회 (최대 100건 조회)
+실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+모의계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| tr_id | 거래ID | string | Y | 13 | [실전/모의투자]
FHKIF03020100 |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션,
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션 |
+| FID_INPUT_ISCD | 종목코드 | string | Y | 12 | 종목번호 (지수선물:6자리, 지수옵션 9자리) |
+| FID_INPUT_DATE_1 | 조회 시작일자 | string | Y | 10 | 조회 시작일자 (ex. 20220401) |
+| FID_INPUT_DATE_2 | 조회 종료일자 | string | Y | 10 | 조회 종료일자 (ex. 20220524)
※ 주(W), 월(M), 년(Y) 봉 조회 시에 아래 참고
ㅁ FID_INPUT_DATE_2 가 현재일 까지일때
. 주봉 조회 : 해당 주의 첫번째 영업일이 포함되어야함
. 월봉 조회 : 해당 월의 전월 일자로 시작되어야함
. 년봉 조회 : 해당 년의 전년도 일자로 시작되어야함
ㅁ FID_INPUT_DATE_2 가 현재일보다 이전일 때
. 주봉 조회 : 해당 주의 첫번째 영업일이 포함되어야함
. 월봉 조회 : 해당 월의 영업일이 포함되어야함
. 년봉 조회 : 해당 년의 영업일이 포함되어야함 |
+| FID_PERIOD_DIV_CODE | 기간분류코드 | string | Y | 32 | D:일봉 W:주봉, M:월봉, Y:년봉 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output1 | 상세기본정보 | object | Y | 1 | 상세기본정보 |
+| -futs_prdy_vrss | 전일 대비 | string | Y | 14 | 전일 대비 |
+| -prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 전일 대비 부호 |
+| -futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 11 | 선물 전일 대비율 |
+| -futs_prdy_clpr | 선물 전일 종가 | string | Y | 14 | 선물 전일 종가 |
+| -acml_vol | 누적 거래량 | string | Y | 18 | 누적 거래량 |
+| -acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | 누적 거래 대금 |
+| -hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | HTS 한글 종목명 |
+| -futs_prpr | 현재가 | string | Y | 14 | 현재가 |
+| -futs_shrn_iscd | 단축 종목코드 | string | Y | 9 | 단축 종목코드 |
+| -prdy_vol | 전일 거래량 | string | Y | 18 | 전일 거래량 |
+| -futs_mxpr | 상한가 | string | Y | 14 | 상한가 |
+| -futs_llam | 하한가 | string | Y | 14 | 하한가 |
+| -futs_oprc | 시가 | string | Y | 14 | 시가 |
+| -futs_hgpr | 최고가 | string | Y | 14 | 최고가 |
+| -futs_lwpr | 최저가 | string | Y | 14 | 최저가 |
+| -futs_prdy_oprc | 전일 시가 | string | Y | 14 | 전일 시가 |
+| -futs_prdy_hgpr | 전일 최고가 | string | Y | 14 | 전일 최고가 |
+| -futs_prdy_lwpr | 전일 최저가 | string | Y | 14 | 전일 최저가 |
+| -futs_askp | 매도호가 | string | Y | 14 | 매도호가 |
+| -futs_bidp | 매수호가 | string | Y | 14 | 매수호가 |
+| -basis | 베이시스 | string | Y | 12 | 베이시스 |
+| -kospi200_nmix | KOSPI200 지수 | string | Y | 14 | KOSPI200 지수 |
+| -kospi200_prdy_vrss | KOSPI200 전일 대비 | string | Y | 14 | KOSPI200 전일 대비 |
+| -kospi200_prdy_ctrt | KOSPI200 전일 대비율 | string | Y | 11 | KOSPI200 전일 대비율 |
+| -kospi200_prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 전일 대비 부호 |
+| -hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | HTS 미결제 약정 수량 |
+| -otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | 미결제 약정 수량 증감 |
+| -tday_rltv | 당일 체결강도 | string | Y | 14 | 당일 체결강도 |
+| -hts_thpr | HTS 이론가 | string | Y | 14 | HTS 이론가 |
+| -dprt | 괴리율 | string | Y | 11 | 괴리율 |
+| output2 | 기간별 조회데이터 (배열) | array | Y | 1 | 기간별 조회데이터 (배열) |
+| -stck_bsop_date | 영업 일자 | string | Y | 8 | 영업 일자 |
+| -futs_prpr | 현재가 | string | Y | 14 | 현재가 |
+| -futs_oprc | 시가 | string | Y | 14 | 시가 |
+| -futs_hgpr | 최고가 | string | Y | 14 | 최고가 |
+| -futs_lwpr | 최저가 | string | Y | 14 | 최저가 |
+| -acml_vol | 누적 거래량 | string | Y | 18 | 누적 거래량 |
+| -acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | 누적 거래 대금 |
+| -mod_yn | 변경 여부 | string | Y | 1 | 변경 여부 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "F",
+ "fid_input_date_1": "20220401",
+ "fid_input_date_2": "20220524",
+ "fid_input_iscd": "101S06",
+ "fid_period_div_code": "D"
+ }
+```
+
+### Response Example
+
+```text
+"output1": {
+ "acml_tr_pbmn": "15491417875",
+ "acml_vol": "178446",
+ "basis": "0.28",
+ "dprt": "-0.14",
+ "futs_askp": "344.70",
+ "futs_bidp": "344.65",
+ "futs_hgpr": "349.75",
+ "futs_llam": "322.65",
+ "futs_lwpr": "344.65",
+ "futs_mxpr": "378.75",
+ "futs_oprc": "348.85",
+ "futs_prdy_clpr": "350.70",
+ "futs_prdy_ctrt": "-1.71",
+ "futs_prdy_hgpr": "351.85",
+ "futs_prdy_lwpr": "348.65",
+ "futs_prdy_oprc": "351.55",
+ "futs_prdy_vrss": "-6.00",
+ "futs_prpr": "344.70",
+ "futs_shrn_iscd": "101S06",
+ "hts_kor_isnm": "F 202206",
+ "hts_otst_stpl_qty": "297901",
+ "hts_thpr": "345.17",
+ "kospi200_nmix": "344.89",
+ "otst_stpl_qty_icdc": "4348",
+ "prdy_vol": "222987",
+ "prdy_vrss_sign": "5",
+ "tday_rltv": "92.20"
+ },
+ "output2": [
+ {
+ "acml_tr_pbmn": "15491417875",
+ "acml_vol": "178446",
+ "futs_hgpr": "349.75",
+ "futs_lwpr": "344.65",
+ "futs_oprc": "348.85",
+ "futs_prpr": "344.70",
+ "mod_yn": "N",
+ "stck_bsop_date": "20220524"
+ },
+....
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/209_국내선물-023_국내옵션전광판_선물.md b/docs/broker/kis/rest/국내선물옵션/기본시세/209_국내선물-023_국내옵션전광판_선물.md
new file mode 100644
index 0000000..56c3b20
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/209_국내선물-023_국내옵션전광판_선물.md
@@ -0,0 +1,239 @@
+# 국내옵션전광판_선물
+
+- 원본 시트명: 국내옵션전광판_선물
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: 국내선물-023
+- HTTP Method: GET
+- 실전 TR_ID: FHPIF05030200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-futures
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내옵션전광판_선물 API입니다.
+한국투자 HTS(eFriend Plus) > [0503] 선물옵션 종합시세(Ⅰ) 화면의 "하단" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPIF05030200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (F: 선물) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20503) |
+| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백: KOSPI200
MKI: 미니KOSPI200
WKM: KOSPI200위클리(월)
WKI: KOSPI200위클리(목)
KQI: KOSDAQ150 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| futs_shrn_iscd | 선물 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| futs_prpr | 선물 현재가 | string | Y | 112 | |
+| futs_prdy_vrss | 선물 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 82 | |
+| hts_thpr | HTS 이론가 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| futs_askp | 선물 매도호가 | string | Y | 112 | |
+| futs_bidp | 선물 매수호가 | string | Y | 112 | |
+| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
+| futs_hgpr | 선물 최고가 | string | Y | 112 | |
+| futs_lwpr | 선물 최저가 | string | Y | 112 | |
+| hts_rmnn_dynu | HTS 잔존 일수 | string | Y | 5 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
+| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
+| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
+| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:F
+FID_COND_SCR_DIV_CODE:20503
+FID_COND_MRKT_CLS_CODE:MKI
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "futs_shrn_iscd": "105V05",
+ "hts_kor_isnm": "미니F 202405",
+ "futs_prpr": "368.28",
+ "futs_prdy_vrss": "-3.32",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-0.89",
+ "hts_thpr": "368.26",
+ "acml_vol": "91624",
+ "futs_askp": "368.28",
+ "futs_bidp": "368.26",
+ "hts_otst_stpl_qty": "38188",
+ "futs_hgpr": "372.86",
+ "futs_lwpr": "367.40",
+ "hts_rmnn_dynu": "28",
+ "total_askp_rsqn": "934",
+ "total_bidp_rsqn": "282",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ {
+ "futs_shrn_iscd": "105V06",
+ "hts_kor_isnm": "미니F 202406",
+ "futs_prpr": "369.48",
+ "futs_prdy_vrss": "-3.32",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-0.89",
+ "hts_thpr": "369.51",
+ "acml_vol": "621",
+ "futs_askp": "369.54",
+ "futs_bidp": "369.48",
+ "hts_otst_stpl_qty": "3433",
+ "futs_hgpr": "374.16",
+ "futs_lwpr": "368.64",
+ "hts_rmnn_dynu": "63",
+ "total_askp_rsqn": "68",
+ "total_bidp_rsqn": "53",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ {
+ "futs_shrn_iscd": "105V07",
+ "hts_kor_isnm": "미니F 202407",
+ "futs_prpr": "369.00",
+ "futs_prdy_vrss": "-3.98",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-1.07",
+ "hts_thpr": "369.43",
+ "acml_vol": "19",
+ "futs_askp": "370.24",
+ "futs_bidp": "367.52",
+ "hts_otst_stpl_qty": "31",
+ "futs_hgpr": "372.00",
+ "futs_lwpr": "369.00",
+ "hts_rmnn_dynu": "91",
+ "total_askp_rsqn": "257",
+ "total_bidp_rsqn": "13",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ {
+ "futs_shrn_iscd": "105V08",
+ "hts_kor_isnm": "미니F 202408",
+ "futs_prpr": "373.78",
+ "futs_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "futs_prdy_ctrt": "0.00",
+ "hts_thpr": "370.41",
+ "acml_vol": "0",
+ "futs_askp": "403.58",
+ "futs_bidp": "344.00",
+ "hts_otst_stpl_qty": "1",
+ "futs_hgpr": "0.00",
+ "futs_lwpr": "0.00",
+ "hts_rmnn_dynu": "119",
+ "total_askp_rsqn": "4",
+ "total_bidp_rsqn": "5",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ {
+ "futs_shrn_iscd": "105V09",
+ "hts_kor_isnm": "미니F 202409",
+ "futs_prpr": "374.00",
+ "futs_prdy_vrss": "-0.50",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-0.13",
+ "hts_thpr": "371.67",
+ "acml_vol": "3",
+ "futs_askp": "404.36",
+ "futs_bidp": "369.82",
+ "hts_otst_stpl_qty": "10",
+ "futs_hgpr": "374.00",
+ "futs_lwpr": "371.00",
+ "hts_rmnn_dynu": "154",
+ "total_askp_rsqn": "4",
+ "total_bidp_rsqn": "12",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ {
+ "futs_shrn_iscd": "105V10",
+ "hts_kor_isnm": "미니F 202410",
+ "futs_prpr": "375.26",
+ "futs_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "futs_prdy_ctrt": "0.00",
+ "hts_thpr": "371.72",
+ "acml_vol": "0",
+ "futs_askp": "405.18",
+ "futs_bidp": "345.34",
+ "hts_otst_stpl_qty": "0",
+ "futs_hgpr": "0.00",
+ "futs_lwpr": "0.00",
+ "hts_rmnn_dynu": "182",
+ "total_askp_rsqn": "4",
+ "total_bidp_rsqn": "4",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/210_v1_국내선물-012_선물옵션-분봉조회.md b/docs/broker/kis/rest/국내선물옵션/기본시세/210_v1_국내선물-012_선물옵션-분봉조회.md
new file mode 100644
index 0000000..61c1797
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/210_v1_국내선물-012_선물옵션-분봉조회.md
@@ -0,0 +1,206 @@
+# 선물옵션 분봉조회
+
+- 원본 시트명: 선물옵션 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: v1_국내선물-012
+- HTTP Method: GET
+- 실전 TR_ID: FHKIF03020200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-time-fuopchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 분봉조회 API입니다.
+실전계좌의 경우, 한 번의 호출에 최대 102건까지 확인 가능하며,
+FID_INPUT_DATE_1(입력날짜), FID_INPUT_HOUR_1(입력시간)을 이용하여 다음조회 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKIF03020200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션,
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목번호 (지수선물:6자리, 지수옵션 9자리) |
+| FID_HOUR_CLS_CODE | FID 시간 구분 코드 | string | Y | 5 | FID 시간 구분 코드(30: 30초, 60: 1분, 3600: 1시간) |
+| FID_PW_DATA_INCU_YN | FID 과거 데이터 포함 여부 | string | Y | 2 | Y(과거) / N (당일) |
+| FID_FAKE_TICK_INCU_YN | FID 허봉 포함 여부 | string | Y | 2 | N으로 입력 |
+| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | 입력 날짜 기준으로 이전 기간 조회(YYYYMMDD)
ex) 20230908 입력 시, 2023년 9월 8일부터 일자 역순으로 조회 |
+| FID_INPUT_HOUR_1 | FID 입력 시간1 | string | Y | 10 | 입력 시간 기준으로 이전 시간 조회(HHMMSS)
ex) 093000 입력 시, 오전 9시 30분부터 역순으로 분봉 조회
* CM(야간선물), EU(야간옵션)인 경우, 자정 이후 시간은 +24시간으로 입력
ex) 253000 입력 시, 새벽 1시 30분부터 역순으로 분봉 조회 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output1 | 응답상세 | object array | Y | | |
+| futs_prdy_vrss | 선물 전일 대비 | string | Y | 11 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 8 | |
+| futs_prdy_clpr | 선물 전일 종가 | string | Y | 11 | |
+| prdy_nmix | 전일 지수 | string | Y | 11 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| futs_prpr | 선물 현재가 | string | Y | 11 | |
+| futs_shrn_iscd | 선물 단축 종목코드 | string | Y | 9 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| futs_mxpr | 선물 상한가 | string | Y | 11 | |
+| futs_llam | 선물 하한가 | string | Y | 11 | |
+| futs_oprc | 선물 시가2 | string | Y | 11 | |
+| futs_hgpr | 선물 최고가 | string | Y | 11 | |
+| futs_lwpr | 선물 최저가 | string | Y | 11 | |
+| futs_prdy_oprc | 선물 전일 시가 | string | Y | 11 | |
+| futs_prdy_hgpr | 선물 전일 최고가 | string | Y | 11 | |
+| futs_prdy_lwpr | 선물 전일 최저가 | string | Y | 11 | |
+| futs_askp | 선물 매도호가 | string | Y | 11 | |
+| futs_bidp | 선물 매수호가 | string | Y | 11 | |
+| basis | 베이시스 | string | Y | 8 | |
+| kospi200_nmix | KOSPI200 지수 | string | Y | 11 | |
+| kospi200_prdy_vrss | KOSPI200 전일 대비 | string | Y | 18 | |
+| kospi200_prdy_ctrt | KOSPI200 전일 대비율 | string | Y | 8 | |
+| kospi200_prdy_vrss_sign | KOSPI200 전일 대비 부호 | string | Y | 1 | |
+| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
+| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | |
+| tday_rltv | 당일 체결강도 | string | Y | 11 | |
+| hts_thpr | HTS 이론가 | string | Y | 11 | |
+| dprt | 괴리율 | string | Y | 8 | |
+| Output2 | 응답상세2 | object | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | CM(야간선물), EU(야간옵션)인 경우, 자정 이후 시간은 +24시간으로 표시
ex) "260000"인 경우, 오전 4시를 의미 |
+| futs_prpr | 선물 현재가 | string | Y | 11 | |
+| futs_oprc | 선물 시가2 | string | Y | 11 | |
+| futs_hgpr | 선물 최고가 | string | Y | 11 | |
+| futs_lwpr | 선물 최저가 | string | Y | 11 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:F
+fid_input_iscd:101V09
+fid_hour_cls_code:30
+fid_pw_data_incu_yn:N
+fid_fake_tick_incu_yn:Y
+fid_input_date_1:
+fid_input_hour_1:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "futs_prdy_vrss": "-0.30",
+ "prdy_vrss_sign": "5",
+ "futs_prdy_ctrt": "-0.08",
+ "futs_prdy_clpr": "359.90",
+ "prdy_nmix": "359.90",
+ "acml_vol": "349",
+ "acml_tr_pbmn": "31394925",
+ "hts_kor_isnm": "F 202409",
+ "futs_prpr": "359.60",
+ "futs_shrn_iscd": "101V09",
+ "prdy_vol": "721",
+ "futs_mxpr": "388.65",
+ "futs_llam": "331.15",
+ "futs_oprc": "361.50",
+ "futs_hgpr": "362.00",
+ "futs_lwpr": "357.20",
+ "futs_prdy_oprc": "364.95",
+ "futs_prdy_hgpr": "365.30",
+ "futs_prdy_lwpr": "358.60",
+ "futs_askp": "359.65",
+ "futs_bidp": "359.50",
+ "basis": "4.06",
+ "kospi200_nmix": "356.42",
+ "hts_otst_stpl_qty": "11529",
+ "otst_stpl_qty_icdc": "0",
+ "tday_rltv": "78.97",
+ "hts_thpr": "360.48",
+ "dprt": "-0.25"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240417",
+ "stck_cntg_hour": "141500",
+ "futs_prpr": "359.60",
+ "futs_oprc": "359.60",
+ "futs_hgpr": "359.60",
+ "futs_lwpr": "359.60",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "31394925"
+ },
+ {
+ "stck_bsop_date": "20240417",
+ "stck_cntg_hour": "141430",
+ "futs_prpr": "359.60",
+ "futs_oprc": "359.60",
+ "futs_hgpr": "359.60",
+ "futs_lwpr": "359.60",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "31394925"
+ },
+ {
+ "stck_bsop_date": "20240417",
+ "stck_cntg_hour": "141400",
+ "futs_prpr": "359.60",
+ "futs_oprc": "359.60",
+ "futs_hgpr": "359.60",
+ "futs_lwpr": "359.60",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "31394925"
+ },
+ {
+ "stck_bsop_date": "20240417",
+ "stck_cntg_hour": "141330",
+ "futs_prpr": "359.60",
+ "futs_oprc": "359.60",
+ "futs_hgpr": "359.60",
+ "futs_lwpr": "359.60",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "31394925"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/211_국내선물-020_국내옵션전광판_옵션월물리스트.md b/docs/broker/kis/rest/국내선물옵션/기본시세/211_국내선물-020_국내옵션전광판_옵션월물리스트.md
new file mode 100644
index 0000000..6fa7813
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/211_국내선물-020_국내옵션전광판_옵션월물리스트.md
@@ -0,0 +1,133 @@
+# 국내옵션전광판_옵션월물리스트
+
+- 원본 시트명: 국내옵션전광판_옵션월물리스트
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: 국내선물-020
+- HTTP Method: GET
+- 실전 TR_ID: FHPIO056104C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-option-list
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 국내옵션전광판_옵션월물리스트 API입니다.
+한국투자 HTS(eFriend Plus) > [0503] 선물옵션 종합시세(Ⅰ) 화면의 "월물리스트 목록 확인" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPIO056104C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(509) |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 공백 |
+| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| mtrt_yymm_code | 만기 년월 코드 | string | Y | 6 | |
+| mtrt_yymm | 만기 년월 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_scr_div_code:509
+fid_cond_mrkt_div_code:
+fid_cond_mrkt_cls_code:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mtrt_yymm_code": "0V05",
+ "mtrt_yymm": "202405"
+ },
+ {
+ "mtrt_yymm_code": "0V06",
+ "mtrt_yymm": "202406"
+ },
+ {
+ "mtrt_yymm_code": "0V07",
+ "mtrt_yymm": "202407"
+ },
+ {
+ "mtrt_yymm_code": "0V08",
+ "mtrt_yymm": "202408"
+ },
+ {
+ "mtrt_yymm_code": "0V09",
+ "mtrt_yymm": "202409"
+ },
+ {
+ "mtrt_yymm_code": "0V10",
+ "mtrt_yymm": "202410"
+ },
+ {
+ "mtrt_yymm_code": "0V12",
+ "mtrt_yymm": "202412"
+ },
+ {
+ "mtrt_yymm_code": "0W03",
+ "mtrt_yymm": "202503"
+ },
+ {
+ "mtrt_yymm_code": "0W06",
+ "mtrt_yymm": "202506"
+ },
+ {
+ "mtrt_yymm_code": "0W12",
+ "mtrt_yymm": "202512"
+ },
+ {
+ "mtrt_yymm_code": "0612",
+ "mtrt_yymm": "202612"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/212_v1_국내선물-007_선물옵션-시세호가.md b/docs/broker/kis/rest/국내선물옵션/기본시세/212_v1_국내선물-007_선물옵션-시세호가.md
new file mode 100644
index 0000000..53e42a8
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/212_v1_국내선물-007_선물옵션-시세호가.md
@@ -0,0 +1,175 @@
+# 선물옵션 시세호가
+
+- 원본 시트명: 선물옵션 시세호가
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: v1_국내선물-007
+- HTTP Method: GET
+- 실전 TR_ID: FHMIF10010000
+- 모의 TR_ID: FHMIF10010000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-asking-price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 시세호가 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전/모의투자]
FHMIF10010000 : 선물 옵션 시세 호가 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목코드 (예: 101S03) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output1 | 응답상세1 | object | Y | | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | 종목명 |
+| futs_prpr | 선물 현재가 | string | Y | 14 | 선물의 현재가격 |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| futs_prdy_vrss | 선물 전일 대비 | string | Y | 14 | 선물의 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가) |
+| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 11 | 선물 전일 대비 / 당일 현재가 * 100 |
+| acml_vol | 누적 거래량 | string | Y | 18 | 당일 조회시점까지 전체 거래량 |
+| futs_prdy_clpr | 선물 전일 종가 | string | Y | 14 | 해당 선물 종목의 전일 종가 |
+| futs_shrn_iscd | 선물 단축 종목코드 | string | Y | 9 | |
+| output2 | 응답상세2 | object array | Y | | Array |
+| futs_askp1 | 선물 매도호가1 | string | Y | 14 | 해당 종목의 매도호가 중 1번째 낮은 호가 |
+| futs_askp2 | 선물 매도호가2 | string | Y | 14 | 해당 종목의 매도호가 중 2번째 낮은 호가 |
+| futs_askp3 | 선물 매도호가3 | string | Y | 14 | 해당 종목의 매도호가 중 3번째 낮은 호가 |
+| futs_askp4 | 선물 매도호가4 | string | Y | 14 | 해당 종목의 매도호가 중 4번째 낮은 호가 |
+| futs_askp5 | 선물 매도호가5 | string | Y | 14 | 해당 종목의 매도호가 중 5번째 낮은 호가 |
+| futs_bidp1 | 선물 매수호가1 | string | Y | 14 | 해당 종목의 매수호가 중 가장 높은 호가 |
+| futs_bidp2 | 선물 매수호가1 | string | Y | 14 | 해당 종목의 매수호가 중 2번째 높은 호가 |
+| futs_bidp3 | 선물 매수호가3 | string | Y | 14 | 해당 종목의 매수호가 중 3번째 높은 호가 |
+| futs_bidp4 | 선물 매수호가4 | string | Y | 14 | 해당 종목의 매수호가 중 4번째 높은 호가 |
+| futs_bidp5 | 선물 매수호가5 | string | Y | 14 | 해당 종목의 매수호가 중 5번째 높은 호가 |
+| askp_rsqn1 | 매도호가 잔량1 | string | Y | 12 | 매도호가 1의 미체결수량 |
+| askp_rsqn2 | 매도호가 잔량2 | string | Y | 12 | 매도호가 2의 미체결수량 |
+| askp_rsqn3 | 매도호가 잔량3 | string | Y | 12 | 매도호가 3의 미체결수량 |
+| askp_rsqn4 | 매도호가 잔량4 | string | Y | 12 | 매도호가 4의 미체결수량 |
+| askp_rsqn5 | 매도호가 잔량5 | string | Y | 12 | 매도호가 5의 미체결수량 |
+| bidp_rsqn1 | 매수호가 잔량1 | string | Y | 12 | 매수호가 1의 미체결수량 |
+| bidp_rsqn2 | 매수호가 잔량2 | string | Y | 12 | 매수호가 2의 미체결수량 |
+| bidp_rsqn3 | 매수호가 잔량3 | string | Y | 12 | 매수호가 3의 미체결수량 |
+| bidp_rsqn4 | 매수호가 잔량4 | string | Y | 12 | 매수호가 4의 미체결수량 |
+| bidp_rsqn5 | 매수호가 잔량5 | string | Y | 12 | 매수호가 5의 미체결수량 |
+| askp_csnu1 | 매도호가 건수1 | string | Y | 10 | 매도호가 1의 미체결 주문 건수 |
+| askp_csnu2 | 매도호가 건수2 | string | Y | 10 | 매도호가 2의 미체결 주문 건수 |
+| askp_csnu3 | 매도호가 건수3 | string | Y | 10 | 매도호가 3의 미체결 주문 건수 |
+| askp_csnu4 | 매도호가 건수4 | string | Y | 10 | 매도호가 4의 미체결 주문 건수 |
+| askp_csnu5 | 매도호가 건수5 | string | Y | 10 | 매도호가 5의 미체결 주문 건수 |
+| bidp_csnu1 | 매수호가 건수1 | string | Y | 10 | 매수호가 1의 미체결 주문 건수 |
+| bidp_csnu2 | 매수호가 건수2 | string | Y | 10 | 매수호가 2의 미체결 주문 건수 |
+| bidp_csnu3 | 매수호가 건수3 | string | Y | 10 | 매수호가 3의 미체결 주문 건수 |
+| bidp_csnu4 | 매수호가 건수4 | string | Y | 10 | 매수호가 4의 미체결 주문 건수 |
+| bidp_csnu5 | 매수호가 건수5 | string | Y | 10 | 매수호가 5의 미체결 주문 건수 |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | 매도호가 1~5의 잔량 합계 |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | 매수호가 1~5의 잔량 합계 |
+| total_askp_csnu | 총 매도호가 건수 | string | Y | 10 | 매도호가 1~5의 미체결 주문 건수 합계 |
+| total_bidp_csnu | 총 매수호가 건수 | string | Y | 10 | 매수호가 1~5의 미체결 주문 건수 합계 |
+| aspr_acpt_hour | 호가 접수 시간 | string | Y | 6 | 가장 최근 호가의 접수 시간 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code" : "F",
+"fid_input_iscd" : "101S06"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "hts_kor_isnm": "F 202206",
+ "futs_prpr": "364.40",
+ "prdy_vrss_sign": "2",
+ "futs_prdy_vrss": "3.00",
+ "futs_prdy_ctrt": "0.83",
+ "acml_vol": "193112",
+ "futs_prdy_clpr": "361.40",
+ "futs_shrn_iscd": "101S06"
+ },
+ "output2": {
+ "futs_askp1": "364.40",
+ "futs_askp2": "364.45",
+ "futs_askp3": "364.50",
+ "futs_askp4": "364.55",
+ "futs_askp5": "364.60",
+ "futs_bidp1": "364.35",
+ "futs_bidp2": "364.30",
+ "futs_bidp3": "364.25",
+ "futs_bidp4": "364.20",
+ "futs_bidp5": "364.15",
+ "askp_rsqn1": "35",
+ "askp_rsqn2": "47",
+ "askp_rsqn3": "32",
+ "askp_rsqn4": "56",
+ "askp_rsqn5": "88",
+ "bidp_rsqn1": "22",
+ "bidp_rsqn2": "70",
+ "bidp_rsqn3": "68",
+ "bidp_rsqn4": "97",
+ "bidp_rsqn5": "42",
+ "askp_csnu1": "9",
+ "askp_csnu2": "19",
+ "askp_csnu3": "21",
+ "askp_csnu4": "28",
+ "askp_csnu5": "20",
+ "bidp_csnu1": "9",
+ "bidp_csnu2": "45",
+ "bidp_csnu3": "26",
+ "bidp_csnu4": "31",
+ "bidp_csnu5": "22",
+ "total_askp_rsqn": "7140",
+ "total_bidp_rsqn": "9319",
+ "total_askp_csnu": "1091",
+ "total_bidp_csnu": "1115",
+ "aspr_acpt_hour": "153744"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/기본시세/213_국내선물-022_국내옵션전광판_콜풋.md b/docs/broker/kis/rest/국내선물옵션/기본시세/213_국내선물-022_국내옵션전광판_콜풋.md
new file mode 100644
index 0000000..d1b7dbc
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/기본시세/213_국내선물-022_국내옵션전광판_콜풋.md
@@ -0,0 +1,268 @@
+# 국내옵션전광판_콜풋
+
+- 원본 시트명: 국내옵션전광판_콜풋
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 기본시세
+- API ID: 국내선물-022
+- HTTP Method: GET
+- 실전 TR_ID: FHPIF05030100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-callput
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내옵션전광판_콜풋 API입니다.
+한국투자 HTS(eFriend Plus) > [0503] 선물옵션 종합시세(Ⅰ) 화면의 "중앙" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ output1, output2 각각 100건까지만 확인이 가능합니다. (FY25년도 서비스 개선 예정)
+※ 조회시간이 긴 API인 점 참고 부탁드리며, 잦은 호출을 삼가해주시기 바랍니다. (1초당 최대 1건 권장)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPIF05030100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (O: 옵션) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20503) |
+| FID_MRKT_CLS_CODE | 시장 구분 코드 | string | Y | 2 | 시장구분코드 (CO: 콜옵션) |
+| FID_MTRT_CNT | 만기 수 | string | Y | 11 | - FID_COND_MRKT_CLS_CODE : 공백(KOSPI200), MKI(미니KOSPI200), KQI(KOSDAQ150) 인 경우
: 만기년월(YYYYMM) 입력 (ex. 202407)
- FID_COND_MRKT_CLS_CODE : WKM(KOSPI200위클리(월)), WKI(KOSPI200위클리(목)) 인 경우
: 만기년월주차(YYMMWW) 입력
(ex. 2024년도 7월 3주차인 경우, 240703 입력) |
+| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백: KOSPI200
MKI: 미니KOSPI200
WKM: KOSPI200위클리(월)
WKI: KOSPI200위클리(목)
KQI: KOSDAQ150 |
+| FID_MRKT_CLS_CODE1 | 시장 구분 코드 | string | Y | 2 | 시장구분코드 (PO: 풋옵션) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| acpr | 행사가 | string | Y | 112 | |
+| unch_prpr | 환산 현재가 | string | Y | 112 | |
+| optn_shrn_iscd | 옵션 단축 종목코드 | string | Y | 9 | |
+| optn_prpr | 옵션 현재가 | string | Y | 112 | |
+| optn_prdy_vrss | 옵션 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| optn_prdy_ctrt | 옵션 전일 대비율 | string | Y | 82 | |
+| optn_bidp | 옵션 매수호가 | string | Y | 112 | |
+| optn_askp | 옵션 매도호가 | string | Y | 112 | |
+| tmvl_val | 시간가치 값 | string | Y | 132 | |
+| nmix_sdpr | 지수 기준가 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| seln_rsqn | 매도 잔량 | string | Y | 12 | |
+| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
+| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | |
+| delta_val | 델타 값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| rho | 로우 | string | Y | 84 | |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 114 | |
+| invl_val | 내재가치 값 | string | Y | 132 | |
+| esdg | 괴리도 | string | Y | 114 | |
+| dprt | 괴리율 | string | Y | 82 | |
+| hist_vltl | 역사적 변동성 | string | Y | 114 | |
+| hts_thpr | HTS 이론가 | string | Y | 112 | |
+| optn_oprc | 옵션 시가2 | string | Y | 112 | |
+| optn_hgpr | 옵션 최고가 | string | Y | 112 | |
+| optn_lwpr | 옵션 최저가 | string | Y | 112 | |
+| optn_mxpr | 옵션 상한가 | string | Y | 112 | |
+| optn_llam | 옵션 하한가 | string | Y | 112 | |
+| atm_cls_name | ATM 구분 명 | string | Y | 10 | |
+| rgbf_vrss_icdc | 직전 대비 증감 | string | Y | 10 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
+| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
+| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
+| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
+| output2 | 응답상세 | object array | Y | | array |
+| acpr | 행사가 | string | Y | 112 | |
+| unch_prpr | 환산 현재가 | string | Y | 112 | |
+| optn_shrn_iscd | 옵션 단축 종목코드 | string | Y | 9 | |
+| optn_prpr | 옵션 현재가 | string | Y | 112 | |
+| optn_prdy_vrss | 옵션 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| optn_prdy_ctrt | 옵션 전일 대비율 | string | Y | 82 | |
+| optn_bidp | 옵션 매수호가 | string | Y | 112 | |
+| optn_askp | 옵션 매도호가 | string | Y | 112 | |
+| tmvl_val | 시간가치 값 | string | Y | 132 | |
+| nmix_sdpr | 지수 기준가 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| seln_rsqn | 매도 잔량 | string | Y | 12 | |
+| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
+| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | |
+| delta_val | 델타 값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| rho | 로우 | string | Y | 84 | |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 114 | |
+| invl_val | 내재가치 값 | string | Y | 132 | |
+| esdg | 괴리도 | string | Y | 114 | |
+| dprt | 괴리율 | string | Y | 82 | |
+| hist_vltl | 역사적 변동성 | string | Y | 114 | |
+| hts_thpr | HTS 이론가 | string | Y | 112 | |
+| optn_oprc | 옵션 시가2 | string | Y | 112 | |
+| optn_hgpr | 옵션 최고가 | string | Y | 112 | |
+| optn_lwpr | 옵션 최저가 | string | Y | 112 | |
+| optn_mxpr | 옵션 상한가 | string | Y | 112 | |
+| optn_llam | 옵션 하한가 | string | Y | 112 | |
+| atm_cls_name | ATM 구분 명 | string | Y | 10 | |
+| rgbf_vrss_icdc | 직전 대비 증감 | string | Y | 10 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
+| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
+| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
+| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:O
+fid_cond_scr_div_code:20503
+fid_mrkt_cls_code:CO
+fid_mtrt_cnt:202405
+fid_cond_mrkt_cls_code:
+fid_mrkt_cls_code1:PO
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "acpr": "480.00",
+ "unch_prpr": "3505.17",
+ "optn_shrn_iscd": "201V05480",
+ "optn_prpr": "0.01",
+ "optn_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "optn_prdy_ctrt": "0.00",
+ "optn_bidp": "0.00",
+ "optn_askp": "0.01",
+ "tmvl_val": "0.01",
+ "nmix_sdpr": "0.01",
+ "acml_vol": "34",
+ "seln_rsqn": "1710",
+ "shnu_rsqn": "0",
+ "acml_tr_pbmn": "85",
+ "hts_otst_stpl_qty": "642",
+ "otst_stpl_qty_icdc": "39",
+ "delta_val": "0.0000",
+ "gama": "0.0000",
+ "vega": "0.0000",
+ "theta": "-0.0000",
+ "rho": "0.0000",
+ "hts_ints_vltl": "31.5614",
+ "invl_val": "0.00",
+ "esdg": "0.01",
+ "dprt": "9999.99",
+ "hist_vltl": "16.9285",
+ "hts_thpr": "0.00",
+ "optn_oprc": "0.01",
+ "optn_hgpr": "0.01",
+ "optn_lwpr": "0.01",
+ "optn_mxpr": "5.20",
+ "optn_llam": "0.01",
+ "atm_cls_name": "OTM",
+ "rgbf_vrss_icdc": "1",
+ "total_askp_rsqn": "1710",
+ "total_bidp_rsqn": "0",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },
+ ...
+ ],
+ "output2": [
+ {
+ "acpr": "480.00",
+ "unch_prpr": "3505.17",
+ "optn_shrn_iscd": "301V05480",
+ "optn_prpr": "108.45",
+ "optn_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "optn_prdy_ctrt": "0.00",
+ "optn_bidp": "78.35",
+ "optn_askp": "142.60",
+ "tmvl_val": "-4.30",
+ "nmix_sdpr": "108.45",
+ "acml_vol": "0",
+ "seln_rsqn": "10",
+ "shnu_rsqn": "10",
+ "acml_tr_pbmn": "0",
+ "hts_otst_stpl_qty": "48",
+ "otst_stpl_qty_icdc": "0",
+ "delta_val": "-1.0000",
+ "gama": "0.0000",
+ "vega": "0.0000",
+ "theta": "0.0460",
+ "rho": "-0.3541",
+ "hts_ints_vltl": "0.0000",
+ "invl_val": "112.75",
+ "esdg": "-3.06",
+ "dprt": "-2.74",
+ "hist_vltl": "16.9285",
+ "hts_thpr": "111.51",
+ "optn_oprc": "0.00",
+ "optn_hgpr": "0.00",
+ "optn_lwpr": "0.00",
+ "optn_mxpr": "142.60",
+ "optn_llam": "78.35",
+ "atm_cls_name": "ITM",
+ "rgbf_vrss_icdc": "0",
+ "total_askp_rsqn": "10",
+ "total_bidp_rsqn": "10",
+ "futs_antc_cnpr": "0.00",
+ "futs_antc_cntg_vrss": "0.00",
+ "antc_cntg_vrss_sign": "0",
+ "antc_cntg_prdy_ctrt": "0.00"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/190_국내선물-024_야간선물옵션-증거금-상세.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/190_국내선물-024_야간선물옵션-증거금-상세.md
new file mode 100644
index 0000000..87aef3f
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/190_국내선물-024_야간선물옵션-증거금-상세.md
@@ -0,0 +1,285 @@
+# (야간)선물옵션 증거금 상세
+
+- 원본 시트명: (야간)선물옵션 증거금 상세
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: 국내선물-024
+- HTTP Method: GET
+- 실전 TR_ID: (구) JTCE6003R (신) CTFN7107R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/ngt-margin-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(야간)선물옵션 증거금상세 API입니다.
+한국투자 HTS(eFriend Plus) > [2537] 야간선물옵션 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | (구) JTCE6003R (신) CTFN7107R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| MGNA_DVSN_CD | 증거금 구분코드 | string | Y | 2 | 위탁(01), 유지(02) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array
아래 18가지 항목이 순서대로 출력됨
(1) A. 신규증거금 - 선물 - 1.개별종목
(2) A. 신규증거금 - 선물 - 2.스프레드
(3) A. 신규증거금 - 3. 옵션매수증거금
(4) A. 신규증거금 - 4. 옵션매도증거금
(5) A. 소계(1+2+3+4)
(6) B. 순위험증거금 - 1. 가격변동증거금
(7) B. 순위험증거금 - 2. 선물스프레드증거금
(8) B. 순위험증거금 - 3. 인수수도 증거금 등
(9) B. 순위험증거금 - 4. 최소증거금
(10) B. 순위험증거금 - 5. 옵션가격증거금
(11) B. 순위험증거금 - 6. 총위험증거금
(12) B. 소계SUM상품군별MAX[{MAX(1+2+3,4)+5},6]
(13) C. 결제예정금액 - 1. 당일옵션매수금액
(14) C. 결제예정금액 - 2. 당일옵션매도금액
(15) C. 결제예정금액 - 3. 당일선물손실
(16) C. 결제예정금액 - 4. 당일선물이익
(17) C.소계(1-2+3-4)
(18) (A)+B+(C) |
+| cash_amt | 현금금액 | string | Y | 19 | |
+| tot_amt | 총금액 | string | Y | 19 | |
+| output2 | 응답상세 | object array | Y | | array
아래 5가지 항목이 순서대로 출력됨
(1) 예수금
(2) 인출가능금액
(3) 주문가능금액
(4) 위탁증거금액
(5) 추가증거금액
※ 인출가능금액은 정산 후 인출가능 예정 금액입니다.
현재 시점 실제 인출 가능금액은 정규장, 야간시장 인출가능금액 중 적은 금액 기준입니다. |
+| cash_amt | 현금금액 | string | Y | 19 | |
+| sbst_amt | 대용금액 | string | Y | 19 | |
+| tot_amt | 총금액 | string | Y | 19 | |
+| output3 | 응답상세 | object | Y | | |
+| base_dpsa_gdat_grad_cd | 기본예탁금차등등급코드 | string | Y | 2 | |
+| bfdy_sbst_sll_ccld_amt | 전일대용매도체결금액 | string | Y | 19 | |
+| bfdy_sbst_sll_sbst_amt | 전일대용매도대용금액 | string | Y | 19 | |
+| excc_dfpa | 정산차금 | string | Y | 19 | |
+| fee_amt | 수수료금액 | string | Y | 19 | |
+| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
+| opt_base_dpsa_gdat_grad_cd | 옵션기본예탁금차등등급코드 | string | Y | 2 | |
+| opt_buy_exus_acnt_yn | 옵션매수전용계좌여부 | string | Y | 1 | |
+| opt_dfpa | 옵션차금 | string | Y | 19 | |
+| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
+| thdt_sbst_sll_ccld_amt | 당일대용매도체결금액 | string | Y | 19 | |
+| thdt_sbst_sll_sbst_amt | 당일대용매도대용금액 | string | Y | 19 | |
+| output1 | 응답상세 | object array | Y | | Array 신 TR 사용 필드 |
+| futr_new_mgn_amt | 선물신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_sprd_ord_mgna | 선물스프레드주문증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_sll_new_mgn_amt | 옵션매도신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_buy_new_mgn_amt | 옵션매수신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| new_mgn_amt | 신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_pric_mgna | 옵션가격증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| fuop_pric_altr_mgna | 선물옵션가격변동증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_sprd_mgna | 선물스프레드증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| uwdl_mgna | 인수도증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| ctrt_per_min_mgna | 계약당최소증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| tot_risk_mgna | 총위험증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| netrisk_brkg_mgna | 순위험위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_loss_amt | 선물손실금액 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_prft_amt | 선물이익금액 | string | Y | 19 | 신 TR 사용 필드 |
+| thdt_ccld_net_loss_amt | 당일체결순손실금액 | string | Y | 19 | 신 TR 사용 필드 |
+| brkg_mgna | 위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| output2 | 응답상세 | object array | Y | | Array 신 TR 사용 필드 |
+| futr_new_mgn_amt | 선물신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_sprd_ord_mgna | 선물스프레드주문증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_sll_new_mgn_amt | 옵션매도신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_buy_new_mgn_amt | 옵션매수신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| new_mgn_amt | 신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_pric_mgna | 옵션가격증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| fuop_pric_altr_mgna | 선물옵션가격변동증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_sprd_mgna | 선물스프레드증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| uwdl_mgna | 인수도증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| ctrt_per_min_mgna | 계약당최소증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| tot_risk_mgna | 총위험증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| netrisk_brkg_mgna | 순위험위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_loss_amt | 선물손실금액 | string | Y | 19 | 신 TR 사용 필드 |
+| futr_prft_amt | 선물이익금액 | string | Y | 19 | 신 TR 사용 필드 |
+| thdt_ccld_net_loss_amt | 당일체결순손실금액 | string | Y | 19 | 신 TR 사용 필드 |
+| brkg_mgna | 위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
+| output3 | 응답상세 | object | Y | | Single 신 TR 사용 필드 |
+| dnca_cash | 예수금현금 | string | Y | 19 | 신 TR 사용 필드 |
+| dnca_sbst | 예수금대용 | string | Y | 19 | 신 TR 사용 필드 |
+| dnca_tota | 예수금총액 | string | Y | 19 | 신 TR 사용 필드 |
+| wdrw_psbl_cash_amt | 인출가능현금금액 | string | Y | 19 | 신 TR 사용 필드 |
+| wdrw_psbl_sbsa | 인출가능대용금액 | string | Y | 19 | 신 TR 사용 필드 |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | 신 TR 사용 필드 |
+| ord_psbl_cash_amt | 주문가능현금금액 | string | Y | 19 | 신 TR 사용 필드 |
+| ord_psbl_sbsa | 주문가능대용금액 | string | Y | 19 | 신 TR 사용 필드 |
+| ord_psbl_tot_amt | 주문가능총금액 | string | Y | 19 | 신 TR 사용 필드 |
+| brkg_mgna_cash_amt | 위탁증거금현금금액 | string | Y | 19 | 신 TR 사용 필드 |
+| brkg_mgna_sbst | 위탁증거금대용 | string | Y | 19 | 신 TR 사용 필드 |
+| brkg_mgna_tot_amt | 위탁증거금총금액 | string | Y | 19 | 신 TR 사용 필드 |
+| add_mgna_cash_amt | 추가증거금현금금액 | string | Y | 19 | 신 TR 사용 필드 |
+| add_mgna_sbsa | 추가증거금대용금액 | string | Y | 19 | 신 TR 사용 필드 |
+| add_mgna_tot_amt | 추가증거금총금액 | string | Y | 19 | 신 TR 사용 필드 |
+| bfdy_sbst_sll_sbst_amt | 전일대용매도대용금액 | string | Y | 19 | 신 TR 사용 필드 |
+| thdt_sbst_sll_sbst_amt | 당일대용매도대용금액 | string | Y | 19 | 신 TR 사용 필드 |
+| bfdy_sbst_sll_ccld_amt | 전일대용매도체결금액 | string | Y | 19 | 신 TR 사용 필드 |
+| thdt_sbst_sll_ccld_amt | 당일대용매도체결금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_dfpa | 옵션차금 | string | Y | 19 | 신 TR 사용 필드 |
+| excc_dfpa | 정산차금 | string | Y | 19 | 신 TR 사용 필드 |
+| fee_amt | 수수료금액 | string | Y | 19 | 신 TR 사용 필드 |
+| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | 신 TR 사용 필드 |
+| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_buy_exus_acnt_yn | 옵션매수전용계좌여부 | string | Y | 19 | 신 TR 사용 필드 |
+| base_dpsa_gdat_grad_cd | 기본예탁금차등등급코드 | string | Y | 19 | 신 TR 사용 필드 |
+| opt_base_dpsa_gdat_grad_cd | 옵션기본예탁금차등등급코드 | string | Y | 19 | 신 TR 사용 필드 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:03
+MGNA_DVSN_CD:01
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "tot_amt": "0"
+ }
+ ],
+ "output2": [
+ {
+ "cash_amt": "100000000",
+ "sbst_amt": "0",
+ "tot_amt": "100000000"
+ },
+ {
+ "cash_amt": "100000000",
+ "sbst_amt": "0",
+ "tot_amt": "100000000"
+ },
+ {
+ "cash_amt": "100000000",
+ "sbst_amt": "0",
+ "tot_amt": "100000000"
+ },
+ {
+ "cash_amt": "0",
+ "sbst_amt": "0",
+ "tot_amt": "0"
+ },
+ {
+ "cash_amt": "0",
+ "sbst_amt": "0",
+ "tot_amt": "0"
+ }
+ ],
+ "output3": {
+ "bfdy_sbst_sll_sbst_amt": "0",
+ "thdt_sbst_sll_sbst_amt": "0",
+ "bfdy_sbst_sll_ccld_amt": "0",
+ "thdt_sbst_sll_ccld_amt": "0",
+ "opt_buy_exus_acnt_yn": "N",
+ "base_dpsa_gdat_grad_cd": "03",
+ "opt_dfpa": "0",
+ "excc_dfpa": "0",
+ "fee_amt": "0",
+ "nxdy_dncl_amt": "100000000",
+ "prsm_dpast_amt": "100000000",
+ "opt_base_dpsa_gdat_grad_cd": "01"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/191_v1_국내선물-014_선물옵션-총자산현황.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/191_v1_국내선물-014_선물옵션-총자산현황.md
new file mode 100644
index 0000000..ec10bb7
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/191_v1_국내선물-014_선물옵션-총자산현황.md
@@ -0,0 +1,146 @@
+# 선물옵션 총자산현황
+
+- 원본 시트명: 선물옵션 총자산현황
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-014
+- HTTP Method: GET
+- 실전 TR_ID: CTRP6550R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-deposit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 총자산현황 API 입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTRP6550R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| dnca_tota | 예수금총액 | string | Y | 19 | |
+| bfdy_chck_amt | 전일수표금액 | string | Y | 19 | |
+| thdt_chck_amt | 당일수표금액 | string | Y | 19 | |
+| rlth_uwdl_dpos_amt | 실물인수도예치금액 | string | Y | 19 | |
+| brkg_mgna_cash | 위탁증거금현금 | string | Y | 19 | |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
+| dnca_sbst | 예수금대용 | string | Y | 19 | |
+| scts_sbst_amt | 유가증권대용금액 | string | Y | 19 | |
+| frcr_evlu_amt | 외화평가금액 | string | Y | 19 | |
+| brkg_mgna_sbst | 위탁증거금대용 | string | Y | 19 | |
+| sbst_rlse_psbl_amt | 대용해제가능금액 | string | Y | 19 | |
+| mtnc_rt | 유지비율 | string | Y | 238 | |
+| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
+| add_mgna_cash | 추가증거금현금 | string | Y | 19 | |
+| rcva | 미수금 | string | Y | 19 | |
+| futr_trad_pfls | 선물매매손익 | string | Y | 19 | |
+| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | |
+| trad_pfls_smtl | 매매손익합계 | string | Y | 19 | |
+| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | |
+| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | |
+| evlu_pfls_smtl | 평가손익합계 | string | Y | 19 | |
+| excc_dfpa | 정산차금 | string | Y | 19 | |
+| opt_dfpa | 옵션차금 | string | Y | 19 | |
+| brkg_fee | 위탁수수료 | string | Y | 19 | |
+| nxdy_dnca | 익일예수금 | string | Y | 19 | |
+| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
+| cash_mntn_amt | 현금유지금액 | string | Y | 19 | |
+| hack_acdt_acnt_move_amt | 해킹사고계좌이전금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"03",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "dnca_tota": "100000000",
+ "bfdy_chck_amt": "0",
+ "thdt_chck_amt": "0",
+ "rlth_uwdl_dpos_amt": "0",
+ "brkg_mgna_cash": "17907612",
+ "wdrw_psbl_tot_amt": "34046775",
+ "ord_psbl_cash": "64184775",
+ "ord_psbl_tota": "64184775",
+ "dnca_sbst": "0",
+ "scts_sbst_amt": "0",
+ "frcr_evlu_amt": "0",
+ "brkg_mgna_sbst": "17907613",
+ "sbst_rlse_psbl_amt": "0",
+ "mtnc_rt": "418.23000000",
+ "add_mgna_tota": "0",
+ "add_mgna_cash": "0",
+ "rcva": "0",
+ "futr_trad_pfls": "0",
+ "opt_trad_pfls_amt": "0",
+ "trad_pfls_smtl": "0",
+ "futr_evlu_pfls_amt": "4187500",
+ "opt_evlu_pfls_amt": "-697500",
+ "evlu_pfls_smtl": "3490000",
+ "excc_dfpa": "-30138000",
+ "opt_dfpa": "0",
+ "brkg_fee": "0",
+ "nxdy_dnca": "69862000",
+ "prsm_dpast_amt": "69864500",
+ "cash_mntn_amt": "0",
+ "hack_acdt_acnt_move_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "APRP0126",
+ "msg1": "조회이(가) 완료되었습니다. "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/192_v1_국내선물-017_선물옵션기간약정수수료일별.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/192_v1_국내선물-017_선물옵션기간약정수수료일별.md
new file mode 100644
index 0000000..677fd2f
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/192_v1_국내선물-017_선물옵션기간약정수수료일별.md
@@ -0,0 +1,268 @@
+# 선물옵션기간약정수수료일별
+
+- 원본 시트명: 선물옵션기간약정수수료일별
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-017
+- HTTP Method: GET
+- 실전 TR_ID: CTFO6119R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-daily-amount-fee
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션기간약정수수료일별 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTFO6119R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| INQR_STRT_DAY | 조회시작일 | string | Y | 8 | 조회시작일(YYYYMMDD) |
+| INQR_END_DAY | 조회종료일 | string | Y | 8 | 조회종료일(YYYYMMDD) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | array | Y | | array |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| item_name | 종목명 | string | Y | 60 | |
+| sll_agrm_amt | 매도약정금액 | string | Y | 19 | |
+| sll_fee | 매도수수료 | string | Y | 19 | |
+| buy_agrm_amt | 매수약정금액 | string | Y | 19 | |
+| buy_fee | 매수수수료 | string | Y | 19 | |
+| tot_fee_smtl | 총수수료합계 | string | Y | 19 | |
+| trad_pfls | 매매손익 | string | Y | 19 | |
+| output2 | 응답상세2 | object | Y | | |
+| futr_agrm | 선물약정 | string | Y | 19 | |
+| futr_agrm_amt | 선물약정금액 | string | Y | 19 | |
+| futr_agrm_amt_smtl | 선물약정금액합계 | string | Y | 19 | |
+| futr_sll_fee_smtl | 선물매도수수료합계 | string | Y | 19 | |
+| futr_buy_fee_smtl | 선물매수수수료합계 | string | Y | 19 | |
+| futr_fee_smtl | 선물수수료합계 | string | Y | 19 | |
+| opt_agrm | 옵션약정 | string | Y | 19 | |
+| opt_agrm_amt | 옵션약정금액 | string | Y | 19 | |
+| opt_agrm_amt_smtl | 옵션약정금액합계 | string | Y | 19 | |
+| opt_sll_fee_smtl | 옵션매도수수료합계 | string | Y | 19 | |
+| opt_buy_fee_smtl | 옵션매수수수료합계 | string | Y | 19 | |
+| opt_fee_smtl | 옵션수수료합계 | string | Y | 19 | |
+| prdt_futr_agrm | 상품선물약정 | string | Y | 19 | |
+| prdt_fuop | 상품선물옵션 | string | Y | 19 | |
+| prdt_futr_evlu_amt | 상품선물평가금액 | string | Y | 8 | |
+| futr_fee | 선물수수료 | string | Y | 19 | |
+| opt_fee | 옵션수수료 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| sll_agrm_amt | 매도약정금액 | string | Y | 19 | |
+| buy_agrm_amt | 매수약정금액 | string | Y | 19 | |
+| agrm_amt_smtl | 약정금액합계 | string | Y | 19 | |
+| sll_fee | 매도수수료 | string | Y | 19 | |
+| buy_fee | 매수수수료 | string | Y | 19 | |
+| fee_smtl | 수수료합계 | string | Y | 19 | |
+| trad_pfls_smtl | 매매손익합계 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"03",
+ "INQR_STRT_DAY":"20230901",
+ "INQR_END_DAY":"20230920",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678!^03!^20230901!^20230920 ",
+ "ctx_area_nk200": " !^ ",
+ "output1": [
+ {
+ "ord_dt": "20230901",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230904",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230905",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230906",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230907",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230908",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230911",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230914",
+ "pdno": "KR4101T90003",
+ "item_name": "F 202309",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "0",
+ "buy_fee": "0",
+ "tot_fee_smtl": "0",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230920",
+ "pdno": "KR4101TC0008",
+ "item_name": "F 202312",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "419375000",
+ "buy_fee": "41140",
+ "tot_fee_smtl": "41140",
+ "trad_pfls": "0"
+ },
+ {
+ "ord_dt": "20230920",
+ "pdno": "KR4201TA3409",
+ "item_name": "C 202310 340.0",
+ "sll_agrm_amt": "0",
+ "sll_fee": "0",
+ "buy_agrm_amt": "700000",
+ "buy_fee": "2750",
+ "tot_fee_smtl": "2750",
+ "trad_pfls": "0"
+ }
+ ],
+ "output2": {
+ "futr_agrm": "0",
+ "futr_agrm_amt": "419375000",
+ "futr_agrm_amt_smtl": "419375000",
+ "futr_sll_fee_smtl": "0",
+ "futr_buy_fee_smtl": "41140",
+ "futr_fee_smtl": "41140",
+ "opt_agrm": "0",
+ "opt_agrm_amt": "700000",
+ "opt_agrm_amt_smtl": "700000",
+ "opt_sll_fee_smtl": "0",
+ "opt_buy_fee_smtl": "2750",
+ "opt_fee_smtl": "2750",
+ "prdt_futr_agrm": "0",
+ "prdt_fuop": "0",
+ "prdt_futr_evlu_amt": "0",
+ "futr_fee": "0",
+ "opt_fee": "0",
+ "fee": "0",
+ "sll_agrm_amt": "0",
+ "buy_agrm_amt": "420075000",
+ "agrm_amt_smtl": "420075000",
+ "sll_fee": "0",
+ "buy_fee": "43890",
+ "fee_smtl": "43890",
+ "trad_pfls_smtl": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/193_국내선물-010_야간선물옵션-잔고현황.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/193_국내선물-010_야간선물옵션-잔고현황.md
new file mode 100644
index 0000000..0bd8b14
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/193_국내선물-010_야간선물옵션-잔고현황.md
@@ -0,0 +1,203 @@
+# (야간)선물옵션 잔고현황
+
+- 원본 시트명: (야간)선물옵션 잔고현황
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: 국내선물-010
+- HTTP Method: GET
+- 실전 TR_ID: (구) JTCE6001R (신) CTFN6118R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ngt-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(야간)선물옵션 잔고현황 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | (구) JTCE6001R (신) CTFN6118R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ACNT_PWD | 계좌비밀번호 | string | Y | 84 | 공란("")으로 조회 |
+| MGNA_DVSN | 증거금구분 | string | Y | 2 | 01 : 개시, 02 : 유지 |
+| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세2 | object | Y | | |
+| dnca_cash | 예수금현금 | string | Y | 19 | 총주문수량 |
+| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | 주문채번지점번호 |
+| dnca_sbst | 예수금대용 | string | Y | 19 | |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
+| cash_mgna | 현금증거금 | string | Y | 19 | |
+| sbst_mgna | 대용증거금 | string | Y | 19 | |
+| mgna_tota | 증거금총액 | string | Y | 19 | |
+| opt_dfpa | 옵션차금 | string | Y | 19 | |
+| thdt_dfpa | 당일차금 | string | Y | 19 | |
+| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| nxdy_dnca | 익일예수금 | string | Y | 19 | |
+| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
+| prsm_dpast | 추정예탁자산 | string | Y | 19 | 종합계좌번호 |
+| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | 총체결수량 |
+| add_mgna_cash | 추가증거금현금 | string | Y | 19 | 총체결금액 |
+| add_mgna_tota | 추가증거금총액 | string | Y | 19 | 종합계좌명 |
+| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | 수수료 |
+| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | 계좌상품코드 |
+| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | 주문일자 |
+| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | 주문번호 |
+| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | |
+| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
+| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
+| mmga_tot_amt | 유지증거금총금액 | string | Y | 19 | 신규 TR 미사용 필드 |
+| mmga_cash_amt | 유지증거금현금금액 | string | Y | 19 | 신규 TR 미사용 필드 |
+| mtnc_rt | 유지비율 | string | Y | 32238 | 신규 TR 미사용 필드 |
+| isfc_amt | 부족금액 | string | Y | 19 | 신규 TR 미사용 필드 |
+| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | |
+| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | |
+| output1 | 응답상세2 | object array | Y | | 시간별체결 정보 |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | 신규 TR 사용 필드 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| cblc_qty | 잔고수량 | string | Y | 19 | |
+| excc_unpr | 정산단가 | string | Y | 32238 | |
+| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 32238 | |
+| idx_clpr | 지수종가 | string | Y | 32238 | |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
+| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"03",
+ "ACNT_PWD":"",
+ "MGNA_DVSN":"01",
+ "EXCC_STAT_CD":"1",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "80012345^03^01^1^ ",
+ "ctx_area_nk200": " ",
+ "output1": [
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "03",
+ "pdno": "KR4101SC0009",
+ "prdt_type_cd": "301",
+ "shtn_pdno": "101S12",
+ "prdt_name": "F 202212",
+ "sll_buy_dvsn_cd": "02",
+ "trad_dvsn_name": "매수",
+ "cblc_qty": "3",
+ "excc_unpr": "309.10000000",
+ "ccld_avg_unpr1": "320.50000000",
+ "idx_clpr": "307.45000000",
+ "pchs_amt": "231825000",
+ "evlu_amt": "230587500",
+ "evlu_pfls_amt": "-1237500",
+ "trad_pfls_amt": "0",
+ "lqd_psbl_qty": "3"
+ }
+ ],
+ "output2": {
+ "dnca_cash": "10101527360",
+ "frcr_dncl_amt": "0",
+ "dnca_sbst": "0",
+ "tot_dncl_amt": "10101527360",
+ "cash_mgna": "108922232",
+ "sbst_mgna": "133854708",
+ "mgna_tota": "242776940",
+ "opt_dfpa": "0",
+ "thdt_dfpa": "0",
+ "rnwl_dfpa": "-16200000",
+ "fee": "0",
+ "nxdy_dnca": "10085327360",
+ "prsm_dpast": "10085327360",
+ "pprt_ord_psbl_cash": "9858750420",
+ "add_mgna_cash": "0",
+ "add_mgna_tota": "0",
+ "futr_trad_pfls_amt": "0",
+ "opt_trad_pfls_amt": "0",
+ "futr_evlu_pfls_amt": "-1237500",
+ "opt_evlu_pfls_amt": "0",
+ "trad_pfls_amt_smtl": "0",
+ "evlu_pfls_amt_smtl": "-1237500",
+ "wdrw_psbl_tot_amt": "9858750420",
+ "ord_psbl_cash": "9858750420",
+ "ord_psbl_sbst": "0",
+ "ord_psbl_tota": "9858750420",
+ "mmga_tot_amt": "0",
+ "mmga_cash_amt": "0",
+ "mtnc_rt": "0.00000000",
+ "isfc_amt": "0",
+ "pchs_amt_smtl": "231825000",
+ "evlu_amt_smtl": "230587500"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/194_v1_국내선물-004_선물옵션-잔고현황.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/194_v1_국내선물-004_선물옵션-잔고현황.md
new file mode 100644
index 0000000..69d5905
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/194_v1_국내선물-004_선물옵션-잔고현황.md
@@ -0,0 +1,355 @@
+# 선물옵션 잔고현황
+
+- 원본 시트명: 선물옵션 잔고현황
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-004
+- HTTP Method: GET
+- 실전 TR_ID: CTFO6118R
+- 모의 TR_ID: VTFO6118R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 잔고현황 API입니다. 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
CTFO6118R : 선물 옵션 잔고 현황
[모의투자]
VTFO6118R : 선물 옵션 잔고 현황 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| MGNA_DVSN | 증거금 구분 | string | Y | 2 | 01 : 개시
02 : 유지 |
+| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output1 | 응답상세1 | array | Y | | |
+| cano | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| pdno | 상품번호 | string | Y | 12 | 선물옵션종목코드 |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | 단축상품번호 (예: 101P09) |
+| prdt_name | 상품명 | string | Y | 60 | |
+| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | 매도/매수 구분의 명칭
- 매수잔고를 가진 경우, "매수" 혹은 "BUY"로 출력
- 매도잔고를 가진 경우, "매도" 혹은 "SLL"로 출력
- 당일 잔고를 청산하여 잔고를 가지고 있지 않은 경우 빈칸으로 출력 |
+| cblc_qty | 잔고수량 | string | Y | 10 | 보유한 종목의 수량 |
+| excc_unpr | 정산단가 | string | Y | 32 | 당일 종가로 정산한 가격 |
+| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 32 | 보유한 종목의 평균 체결 가격 |
+| idx_clpr | 지수종가 | string | Y | 32 | |
+| pchs_amt | 매입금액 | string | Y | 19 | 보유 종목을 매수한 금액 |
+| evlu_amt | 평가금액 | string | Y | 19 | 보유 종목을 현재가로 평가하여 산출한 금액 |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | 매입금액과 평가금액을 비교한 손익 |
+| trad_pfls_amt | 매매손익금액 | string | Y | 19 | 매수와 매도가 완료된 수량에 대한 실현 손익 |
+| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | 청산 가능한 수량 |
+| output2 | 응답상세2 | object | Y | | |
+| dnca_cash | 예수금현금 | string | Y | 19 | 원화로 보유한 현금 (현금미수금액, 수수료미수금액 차감) |
+| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | 외화로 보유한 현금 |
+| dnca_sbst | 예수금대용 | string | Y | 19 | 주식대용금액+채권대용금액+전일대용매도대용금액+당일대용매도대용금액 |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | 상기 3개 예수금 항목의 합계 금액 |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | 체결된 주문의 합계금액 |
+| cash_mgna | 현금증거금 | string | Y | 19 | 원화 현금 중 주문증거금으로 사용된 금액 |
+| sbst_mgna | 대용증거금 | string | Y | 19 | 대용 예수금 중 주문증거금으로 사용된 금액 |
+| mgna_tota | 증거금총액 | string | Y | 19 | 증거금으로 사용된 항목의 합계 금액 |
+| opt_dfpa | 옵션차금 | string | Y | 19 | 당일옵션매도금에서 당일옵션매수금을 차감한 금액 |
+| thdt_dfpa | 당일차금 | string | Y | 19 | 당일의 각 매수거래에 대하여 1에 의하여 산출한 금액의 합계액과 당일의 각 매도거래에 대하여 2에 의하여 산출한 금액의 합계액을 합산한 금액
1. 매수거래수량*(당일의 정산가격-체결가격)*최소가격변동금액*환산승수
2. 매도거래수량*(체결가격-당일의 정산가격)*최소가격변동금액*환산승수 |
+| rnwl_dfpa | 갱신차금 | string | Y | 19 | 직전 거래일의 매수미결제약정에 대하여 1에 의하여 산출한 금액과 직전거래일의 매도미결제약정에 대하여 2에 의하여 산출한 금액을 합산한 금액
1. 매수미결제약정*(당일의 정산가격-직전거래일의 정산가격)*최소가격변동 금액*환산승수
2. 매도미결제약정*(직전거래일의 정산가격-당일의 정산가격)*최소가격변동 금액*환산승수 |
+| fee | 수수료 | string | Y | 19 | 체결된 주문에 의한 매매수수료 |
+| nxdy_dnca | 익일예수금 | string | Y | 19 | 당일 매매내역을 근거로 익일(결제일) 고객님 계좌에 있는 현금 |
+| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
+| prsm_dpast | 추정예탁자산 | string | Y | 19 | 보유한 잔고를 정산 기준으로 평가한 금액과 예수금을 합한 금액 |
+| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
+| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | 미수없는 주문가능금액 |
+| add_mgna_cash | 추가증거금현금 | string | Y | 19 | 장 종료 후 예탁평가액이 유지증거금을 하회할 경우 또는 예탁현금이 결제금액 보다 적은 경우 고객이 추가적으로 납부해야
하는 증거금 |
+| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
+| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | 선물 매수와 매도가 완료된 수량에 대한 실현 손익 |
+| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | 옵션 매수와 매도가 완료된 수량에 대한 실현 손익 |
+| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | 선물 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
+| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | 옵션 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
+| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | 선물매매손익금액과 옵션매매손익금액을 합한 금액 |
+| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | 선물평가손익금액과 옵션평가손익금액을 합한 금액 |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | 출금 가능한 현금(예탁현금+예탁대용-예탁증거금총액) |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | 예수금현금에서 현금증거금을 차감한 금액 |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | 예수금대용에서 대용증거금을 차감한 금액 |
+| ord_psbl_tota | 주문가능총액 | string | Y | 19 | 주문가능현금과 주문가능대용을 합한 금액 |
+| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | 종목별 매입금액의 합계 금액 |
+| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | 종목별 평가금액의 합계 금액 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD":"3",
+ "MGNA_DVSN": "01",
+ "EXCC_STAT_CD": "1",
+ "CTX_AREA_FK200": "",
+ "CTX_AREA_NK200": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "연속조회검색조건200을 입력하세요.",
+ "output1": {
+ "lqd_psbl_qty": [
+ "6",
+ "133",
+ "110",
+ "1000",
+ "1000",
+ "1000",
+ "1000",
+ "1",
+ "25"
+ ],
+ "pdno": [
+ "KR4101RC0000",
+ "KR4101S30001",
+ "KR4111RA0000",
+ "KR41ACRC0005",
+ "KR41ACS60004",
+ "KR41ADRC0004",
+ "KR41ADS30005",
+ "KR41AES90007",
+ "KR41DRRA0007"
+ ],
+ "prdt_type_cd": [
+ "301",
+ "301",
+ "301",
+ "301",
+ "301",
+ "301",
+ "301",
+ "301",
+ "301"
+ ],
+ "pchs_amt": [
+ "586950000",
+ "12937575000",
+ "78980000",
+ "3003000000",
+ "3012000000",
+ "5686000000",
+ "5672000000",
+ "2610000",
+ "21350000"
+ ],
+ "sll_buy_dvsn_name": [
+ "SLL",
+ "BUY",
+ "BUY",
+ "BUY",
+ "SLL",
+ "BUY",
+ "SLL",
+ "SLL",
+ "BUY"
+ ],
+ "trad_pfls_amt": [
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0"
+ ],
+ "shtn_pdno": [
+ "101R12",
+ "101S03",
+ "111R10",
+ "1ACR12",
+ "1ACS06",
+ "1ADR12",
+ "1ADS03",
+ "1AES09",
+ "1DRR10"
+ ],
+ "acnt_prdt_cd": [
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ ""
+ ],
+ "cblc_qty": [
+ "6",
+ "133",
+ "110",
+ "1000",
+ "1000",
+ "1000",
+ "1000",
+ "1",
+ "25"
+ ],
+ "excc_unpr": [
+ "391.30000000",
+ "389.10000000",
+ "71800.00000000",
+ "3003.00000000",
+ "3012.00000000",
+ "5686.00000000",
+ "5672.00000000",
+ "2610.00000000",
+ "85400.00000000"
+ ],
+ "cano": [
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ "",
+ ""
+ ],
+ "idx_clpr": [
+ "380.55000000",
+ "389.10000000",
+ "71800.00000000",
+ "3003.00000000",
+ "3012.00000000",
+ "5686.00000000",
+ "5672.00000000",
+ "2610.00000000",
+ "85400.00000000"
+ ],
+ "ccld_avg_unpr1": [
+ "402.28975400",
+ "406.38538995",
+ "71618.18181818",
+ "4626.00000000",
+ "4766.50000000",
+ "6992.50000000",
+ "5695.50000000",
+ "3430.50000000",
+ "87700.00000000"
+ ],
+ "evlu_pfls_amt": [
+ "16125000",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0",
+ "0"
+ ],
+ "evlu_amt": [
+ "570825000",
+ "12937575000",
+ "78980000",
+ "3003000000",
+ "3012000000",
+ "5686000000",
+ "5672000000",
+ "2610000",
+ "21350000"
+ ],
+ "prdt_name": [
+ "F 202112",
+ "F 202203",
+ "SamsungEle F 202110 ( 10)",
+ "BBIG K-NewDeal F 202112",
+ "BBIG K-NewDeal F 202206",
+ "Battery K-NewDeal F 202112",
+ "Battery K-NewDeal F 202203",
+ "Bio K-NewDeal F 202209",
+ "C2S F 202110 ( 10)"
+ ]
+ },
+ "rt_cd": "0",
+ "output2": {
+ "nxdy_dnca": "90016125000",
+ "sbst_mgna": "1391065523",
+ "cash_mgna": "0",
+ "ord_psbl_tota": "88608934477",
+ "opt_dfpa": "0",
+ "fee": "0",
+ "pchs_amt_smtl": "31000465000",
+ "prsm_dpast": "90016125000",
+ "evlu_pfls_amt_smtl": "16125000",
+ "thdt_dfpa": "0",
+ "prsm_dpast_amt": "90016125000",
+ "frcr_dncl_amt": "0",
+ "pprt_ord_psbl_cash": "88608934477",
+ "evlu_amt_smtl": "30984340000",
+ "futr_trad_pfls_amt": "0",
+ "rnwl_dfpa": "16125000",
+ "futr_evlu_pfls_amt": "16125000",
+ "wdrw_psbl_tot_amt": "88608934477",
+ "dnca_sbst": "0",
+ "opt_evlu_pfls_amt": "0",
+ "dnca_cash": "90000000000",
+ "tot_dncl_amt": "90000000000",
+ "nxdy_dncl_amt": "90016125000",
+ "tot_ccld_amt": "0",
+ "opt_trad_pfls_amt": "0",
+ "trad_pfls_amt_smtl": "0",
+ "ord_psbl_cash": "88608934477",
+ "mgna_tota": "1391065523",
+ "ord_psbl_sbst": "0",
+ "add_mgna_tota": "0",
+ "add_mgna_cash": "0"
+ },
+ "msg1": "조회 되었습니다. (마지막 자료) ",
+ "msg_cd": "KIOK0460",
+ "ctx_area_nk200": ""
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/195_v1_국내선물-001_선물옵션-주문.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/195_v1_국내선물-001_선물옵션-주문.md
new file mode 100644
index 0000000..15d5bb2
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/195_v1_국내선물-001_선물옵션-주문.md
@@ -0,0 +1,122 @@
+# 선물옵션 주문
+
+- 원본 시트명: 선물옵션 주문
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-001
+- HTTP Method: POST
+- 실전 TR_ID: (주간 매수/매도) TTTO1101U (야간 매수/매도) (구) JTCE1001U (신) STTN1101U
+- 모의 TR_ID: (주간 매수/매도) VTTO1101U (야간은 모의투자 미제공)
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/trading/order
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 주문 API입니다.
+* 선물옵션 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTO1101U : 선물 옵션 매수 매도 주문 주간
(신) STTN1101U : 선물 옵션 매수 매도 주문 야간
[모의투자]
VTTO1101U : 선물 옵션 매수 매도 주문 주간 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| ORD_PRCS_DVSN_CD | 주문처리구분코드 | string | Y | 2 | 02 : 주문전송 |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| SHTN_PDNO | 단축상품번호 | string | Y | 12 | 종목번호
선물 6자리 (예: A01603)
옵션 9자리 (예: B01603955) |
+| ORD_QTY | 주문수량 | string | Y | 10 | |
+| UNIT_PRICE | 주문가격1 | string | Y | 23 | 시장가나 최유리 지정가인 경우 0으로 입력 |
+| NMPR_TYPE_CD | 호가유형코드 | string | N | 2 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨
01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리 |
+| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | string | N | 1 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨
0 : 없음
3 : IOC
4 : FOK |
+| CTAC_TLNO | 연락전화번호 | string | N | 20 | 고객의 연락 가능한 전화번호 |
+| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | N | 2 | 공란(Default) |
+| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | 01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리,
10 : 지정가(IOC)
11 : 지정가(FOK)
12 : 시장가(IOC)
13 : 시장가(FOK)
14 : 최유리(IOC)
15 : 최유리(FOK) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | array | Y | | |
+| ACNT_NAME | 계좌명 | string | Y | 60 | 계좌의 고객명 |
+| TRAD_DVSN_NAME | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
+| ITEM_NAME | 종목명 | string | Y | 60 | 주문 종목 명칭 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문 접수 시간 |
+| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
+| ODNO | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "ORD_PRCS_DVSN_CD":"02",
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD":"03",
+ "SLL_BUY_DVSN_CD":"02",
+ "SHTN_PDNO":"167R12",
+ "ORD_QTY":"1",
+ "UNIT_PRICE":"123",
+ "NMPR_TYPE_CD":"",
+ "KRX_NMPR_CNDT_CD":"",
+ "CTAC_TLNO":"",
+ "FUOP_ITEM_DVSN_CD":"",
+ "ORD_DVSN_CD":"01"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0029",
+ "msg1": "주문전송이 정상적으로 처리되었습니다.",
+ "output": {
+ "ACNT_NAME": "류민수",
+ "TRAD_DVSN_NAME": "매도",
+ "ITEM_NAME": "코스피200 F 202203",
+ "ORD_TMD": "131604",
+ "ORD_GNO_BRNO": "06010",
+ "ODNO": "0000007045"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/196_v1_국내선물-015_선물옵션-잔고평가손익내역.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/196_v1_국내선물-015_선물옵션-잔고평가손익내역.md
new file mode 100644
index 0000000..3aa15e3
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/196_v1_국내선물-015_선물옵션-잔고평가손익내역.md
@@ -0,0 +1,245 @@
+# 선물옵션 잔고평가손익내역
+
+- 원본 시트명: 선물옵션 잔고평가손익내역
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-015
+- HTTP Method: GET
+- 실전 TR_ID: CTFO6159R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance-valuation-pl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 잔고평가손익내역 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTFO6159R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| MGNA_DVSN | 증거금구분 | string | Y | 2 | 01 : 개시, 02 : 유지 |
+| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object | Y | | |
+| dnca_cash | 예수금현금 | string | Y | 19 | |
+| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | |
+| dnca_sbst | 예수금대용 | string | Y | 19 | |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| cash_mgna | 현금증거금 | string | Y | 19 | |
+| sbst_mgna | 대용증거금 | string | Y | 19 | |
+| mgna_tota | 증거금총액 | string | Y | 19 | |
+| opt_dfpa | 옵션차금 | string | Y | 19 | |
+| thdt_dfpa | 당일차금 | string | Y | 19 | |
+| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| nxdy_dnca | 익일예수금 | string | Y | 19 | |
+| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
+| prsm_dpast | 추정예탁자산 | string | Y | 19 | |
+| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
+| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | |
+| add_mgna_cash | 추가증거금현금 | string | Y | 19 | |
+| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
+| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | |
+| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | |
+| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | |
+| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | |
+| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | |
+| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
+| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
+| output1 | 응답상세2 | array | Y | | array |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | |
+| cblc_qty1 | 잔고수량1 | string | Y | 10 | |
+| excc_unpr | 정산단가 | string | Y | 24 | |
+| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 24 | |
+| idx_clpr | 지수종가 | string | Y | 24 | |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
+| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"03",
+ "MGNA_DVSN":"02",
+ "EXCC_STAT_CD":"1",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678!^03!^02!^1 ",
+ "ctx_area_nk200": " !^ !^ !^ ",
+ "output1": [
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "03",
+ "pdno": "KR4101T90003",
+ "prdt_type_cd": "301",
+ "shtn_pdno": "101T09",
+ "prdt_name": "F 202309",
+ "sll_buy_dvsn_name": "매수",
+ "cblc_qty1": "2",
+ "excc_unpr": "340.30000000",
+ "ccld_avg_unpr1": "345.50000000",
+ "idx_clpr": "0.00000000",
+ "pchs_amt": "170150000",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "trad_pfls_amt": "0",
+ "lqd_psbl_qty": "2"
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "03",
+ "pdno": "KR4101TC0008",
+ "prdt_type_cd": "301",
+ "shtn_pdno": "101T12",
+ "prdt_name": "F 202312",
+ "sll_buy_dvsn_name": "매수",
+ "cblc_qty1": "5",
+ "excc_unpr": "350.00000000",
+ "ccld_avg_unpr1": "335.50000000",
+ "idx_clpr": "353.35000000",
+ "pchs_amt": "437500000",
+ "evlu_amt": "441687500",
+ "evlu_pfls_amt": "4187500",
+ "trad_pfls_amt": "0",
+ "lqd_psbl_qty": "5"
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "03",
+ "pdno": "KR4175TA0001",
+ "prdt_type_cd": "301",
+ "shtn_pdno": "175T10",
+ "prdt_name": "미국달러 F 202310",
+ "sll_buy_dvsn_name": "매수",
+ "cblc_qty1": "1",
+ "excc_unpr": "1349.20000000",
+ "ccld_avg_unpr1": "1338.60000000",
+ "idx_clpr": "0.00000000",
+ "pchs_amt": "13492000",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "trad_pfls_amt": "0",
+ "lqd_psbl_qty": "1"
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "03",
+ "pdno": "KR4201TA3409",
+ "prdt_type_cd": "301",
+ "shtn_pdno": "201T10340",
+ "prdt_name": "C 202310 340.0",
+ "sll_buy_dvsn_name": "매수",
+ "cblc_qty1": "1",
+ "excc_unpr": "2.80000000",
+ "ccld_avg_unpr1": "2.80000000",
+ "idx_clpr": "0.01000000",
+ "pchs_amt": "700000",
+ "evlu_amt": "2500",
+ "evlu_pfls_amt": "-697500",
+ "trad_pfls_amt": "0",
+ "lqd_psbl_qty": "1"
+ }
+ ],
+ "output2": {
+ "dnca_cash": "100000000",
+ "frcr_dncl_amt": "0",
+ "dnca_sbst": "0",
+ "tot_dncl_amt": "100000000",
+ "tot_ccld_amt": "0",
+ "cash_mgna": "0",
+ "sbst_mgna": "23910150",
+ "mgna_tota": "23910150",
+ "opt_dfpa": "0",
+ "thdt_dfpa": "0",
+ "rnwl_dfpa": "-30138000",
+ "fee": "0",
+ "nxdy_dnca": "69862000",
+ "nxdy_dncl_amt": "69862000",
+ "prsm_dpast": "69864500",
+ "prsm_dpast_amt": "69864500",
+ "pprt_ord_psbl_cash": "64184775",
+ "add_mgna_cash": "0",
+ "add_mgna_tota": "0",
+ "futr_trad_pfls_amt": "0",
+ "opt_trad_pfls_amt": "0",
+ "futr_evlu_pfls_amt": "4187500",
+ "opt_evlu_pfls_amt": "-697500",
+ "trad_pfls_amt_smtl": "0",
+ "evlu_pfls_amt_smtl": "3490000",
+ "wdrw_psbl_tot_amt": "34046775",
+ "ord_psbl_cash": "64184775",
+ "ord_psbl_sbst": "0",
+ "ord_psbl_tota": "64184775"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/197_선물옵션-증거금률_선물옵션-증거금률.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/197_선물옵션-증거금률_선물옵션-증거금률.md
new file mode 100644
index 0000000..31321f4
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/197_선물옵션-증거금률_선물옵션-증거금률.md
@@ -0,0 +1,79 @@
+# 선물옵션 증거금률
+
+- 원본 시트명: 선물옵션 증거금률
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: 선물옵션 증거금률
+- HTTP Method: GET
+- 실전 TR_ID: TTTO6032R
+- 모의 TR_ID: 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/quotations/margin-rate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 승수, 계약당 선물 증거금은 최근월물 기준으로 표기되며, 월물에 따라 상이할 수 있습니다.
+※ 계약당 선물 증거금은 선물 1계약 기준 신규 주문증거금이며 스프레드 증거금은 조회되지 않습니다.
+※ 2023.05.24일부터 조회 가능하며, 익영업일 기준 증거금은 17:00~18:00시에 조회됩니다.
+※ 데이터는 하루에 한 번 고정된 이후 데이터 변동이 없으므로 조회가 제한되는 점 이용에 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTO6032R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| BASS_DT | 기준일자 | string | Y | 8 | 날짜 입력) ex) 20260313 |
+| BAST_ID | 기초자산ID | string | Y | 20 | 공백 입력 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 다음 조회 시 필요, 입력 후 header tr_cont : N 설정 필수 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | Array |
+| bast_id | 기초자산ID | string | Y | 20 | |
+| bast_name | 기초자산명 | string | Y | 60 | |
+| brkg_mgna_rt | 위탁증거금율 | string | Y | 23 | 소수점 8자리까지 표현 |
+| tr_mgna_rt | 거래증거금율 | string | Y | 23 | 소수점 8자리까지 표현 |
+| bast_pric | 기초자산가격 | string | Y | 18 | 소수점 8자리까지 표현 |
+| tr_mtpl_idx | 거래승수지수 | string | Y | 18 | 소수점 8자리까지 표현 |
+| ctrt_per_futr_mgna | 계약당선물증거금 | string | Y | 18 | 소수점 8자리까지 표현 |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/198_v1_국내선물-002_선물옵션-정정취소주문.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/198_v1_국내선물-002_선물옵션-정정취소주문.md
new file mode 100644
index 0000000..268cbb5
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/198_v1_국내선물-002_선물옵션-정정취소주문.md
@@ -0,0 +1,106 @@
+# 선물옵션 정정취소주문
+
+- 원본 시트명: 선물옵션 정정취소주문
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-002
+- HTTP Method: POST
+- 실전 TR_ID: (주간 정정/취소) TTTO1103U (야간 정정/취소) (구) JTCE1002U (신) STTN1103U
+- 모의 TR_ID: (주간 정정/취소) VTTO1103U (야간은 모의투자 미제공)
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/trading/order-rvsecncl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 주문 건에 대하여 정정 및 취소하는 API입니다. 단, 이미 체결된 건은 정정 및 취소가 불가합니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTO1103U : 선물 옵션 정정 취소 주문 주간
(신) STTN1103U : 선물 옵션 정정 취소 주문 야간
[모의투자]
VTTO1103U : 선물 옵션 정정 취소 주문 주간 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| ORD_PRCS_DVSN_CD | 주문처리구분코드 | string | Y | 2 | 02 : 주문전송 |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 01 : 정정
02 : 취소 |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | 정정 혹은 취소할 주문의 번호 |
+| ORD_QTY | 주문수량 | string | Y | 10 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]
전량일경우 0으로 입력
[Header tr_id JTCE1002U(선물옵션 정정취소 야간)]
일부수량 정정 및 취소 불가, 주문수량 반드시 입력 (공백 불가)
일부 미체결 시 잔량 전체에 대해서 취소 가능
EX) 2개 매수주문 후 1개 체결, 1개 미체결인 상태에서 취소주문 시 ORD_QTY는 1로 입력
※ 모의계좌의 경우, 주문수량 반드시 입력 (공백 불가) |
+| UNIT_PRICE | 주문가격1 | string | Y | 23 | 시장가나 최유리의 경우 0으로 입력 (취소 시에도 0 입력) |
+| NMPR_TYPE_CD | 호가유형코드 | string | Y | 2 | 01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리 |
+| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | string | Y | 1 | 취소시 0으로 입력
정정시
0 : 없음
3 : IOC
4 : FOK |
+| RMN_QTY_YN | 잔여수량여부 | string | Y | 1 | Y : 전량
N : 일부 |
+| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | N | 2 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]
공란(Default)
[Header tr_id JTCE1002U(선물옵션 정정취소 야간)]
01 : 선물
02 : 콜옵션
03 : 풋옵션
04 : 스프레드 |
+| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | [정정]
01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리,
10 : 지정가(IOC)
11 : 지정가(FOK)
12 : 시장가(IOC)
13 : 시장가(FOK)
14 : 최유리(IOC)
15 : 최유리(FOK)
[취소]
01 로 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | array | Y | | |
+| ACNT_NAME | 계좌명 | string | Y | 60 | 계좌의 고객명 |
+| TRAD_DVSN_NAME | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
+| ITEM_NAME | 종목명 | string | Y | 60 | 주문 종목 명칭 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문 접수 시간 |
+| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
+| ODNO | 주문번호 | string | Y | 10 | 접수한 주문(정정 또는 취소)의 일련번호 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "ORD_PRCS_DVSN_CD": "02",
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "03",
+ "RVSE_CNCL_DVSN_CD": "02",
+ "ORGN_ODNO": "0000005605",
+ "ORD_QTY": "1",
+ "UNIT_PRICE": "460.00",
+ "NMPR_TYPE_CD": "",
+ "KRX_NMPR_CNDT_CD": "",
+ "RMN_QTY_YN": "N",
+ "CTAC_TLNO": "000 00000000",
+ "FUOP_ITEM_DVSN_CD": "",
+ "ORD_DVSN_CD": "01"
+}
+```
+
+## 메모
+
+- Response Example
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/199_v1_국내선물-003_선물옵션-주문체결내역조회.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/199_v1_국내선물-003_선물옵션-주문체결내역조회.md
new file mode 100644
index 0000000..d628f55
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/199_v1_국내선물-003_선물옵션-주문체결내역조회.md
@@ -0,0 +1,208 @@
+# 선물옵션 주문체결내역조회
+
+- 원본 시트명: 선물옵션 주문체결내역조회
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-003
+- HTTP Method: GET
+- 실전 TR_ID: TTTO5201R
+- 모의 TR_ID: VTTO5201R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ccnl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 주문체결내역조회 API입니다. 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTO5201R : 선물 옵션 주문 체결 내역 조회
[모의투자]
VTTO5201R : 선물 옵션 주문 체결 내역 조회 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| STRT_ORD_DT | 시작주문일자 | string | Y | 8 | 주문내역 조회 시작 일자, YYYYMMDD |
+| END_ORD_DT | 종료주문일자 | string | Y | 8 | 주문내역 조회 마지막 일자, YYYYMMDD |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 00 : 전체
01 : 매도
02 : 매수 |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 00 : 전체
01 : 체결
02 : 미체결 |
+| SORT_SQN | 정렬순서 | string | Y | 2 | AS : 정순
DS : 역순 |
+| STRT_ODNO | 시작주문번호 | string | Y | 10 | 조회 시작 번호 입력 |
+| PDNO | 상품번호 | string | Y | 12 | 공란 시, 전체 조회
선물 6자리 (예: 101S03)
옵션 9자리 (예: 201S03370) |
+| MKET_ID_CD | 시장ID코드 | string | Y | 3 | 공란(Default) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output1 | 응답상세1 | array | Y | | |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
+| cano | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| csac_name | 종합계좌명 | string | Y | 60 | 계좌의 고객명 |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ord_dt | 주문일자 | string | Y | 8 | 주문의 접수일자 |
+| odno | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호 |
+| orgn_odno | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | 00 : 전체
01 : 매도
02 : 매수 |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
+| nmpr_type_cd | 호가유형코드 | string | Y | 2 | 01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리 |
+| nmpr_type_name | 호가유형명 | string | Y | 60 | 호가 유형의 명칭 |
+| pdno | 상품번호 | string | Y | 12 | 선물옵션종목코드 |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| ord_qty | 주문수량 | string | Y | 10 | 주문 수량 |
+| ord_idx | 주문지수 | string | Y | 24 | 주문 가격 |
+| qty | 잔량 | string | Y | 10 | 주문 체결되지 않고 남은 수량 |
+| ord_tmd | 주문시각 | string | Y | 6 | 주문 접수 시간 |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | 주문 체결된 수량 |
+| avg_idx | 평균지수 | string | Y | 27 | 체결된 주문 수량의 평균 체결 가격 |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | 체결된 주문의 합계금액 |
+| rjct_qty | 거부수량 | string | Y | 10 | 접수된 주문이 정상 처리되지 못하고 거부된 수량 |
+| ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | string | Y | 5 | 정상 처리되지 못하고 거부된 주문의 사유코드 |
+| ingr_trad_rjct_rson_name | 장내매매거부사유명 | string | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유 |
+| ord_stfno | 주문직원번호 | string | Y | 6 | 주문 접수한 직원의 사번 또는 온라인 주문 시 매체 유형코드 |
+| sprd_item_yn | 스프레드종목여부 | string | Y | 1 | 스프레드 종목 여부 구분값 |
+| ord_ip_addr | 주문IP주소 | string | Y | 200 | 주문 시 사용한 매체의 IP 주소 |
+| output2 | 응답상세2 | object | Y | | |
+| tot_ord_qty | 총주문수량 | string | Y | 10 | 전체 주문 수량 |
+| tot_ccld_amt_smtl | 총체결금액합계 | string | Y | 19 | 체결된 주문 전체의 합계 금액 |
+| tot_ccld_qty_smtl | 총체결수량합계 | string | Y | 19 | 체결된 주문 전체의 합계 수량 |
+| fee_smtl | 수수료합계 | string | Y | 19 | 체결된 주문에 대한 매매수수료의 합계 금액 |
+| ctac_tlno | 연락전화번호 | string | Y | 20 | 고객의 연락 가능한 전화번호 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD":"03",
+ "STRT_ORD_DT": "20211122",
+ "END_ORD_DT": "20211122",
+ "SLL_BUY_DVSN_CD": "00",
+ "CCLD_NCCS_DVSN": "00",
+ "SORT_SQN": "DS",
+ "STRT_ODNO": "",
+ "PDNO": "",
+ "MKET_ID_CD": "00",
+ "CTX_AREA_FK200": "",
+ "CTX_AREA_NK200": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "81055689^03^20220101^20220114^DS^ ",
+ "ctx_area_nk200": " ",
+ "output1": [
+ {
+ "ord_gno_brno": "06010",
+ "cano": "810XXXXX",
+ "csac_name": "",
+ "acnt_prdt_cd": "03",
+ "ord_dt": "20220113",
+ "odno": "0000007045",
+ "orgn_odno": "0000000000",
+ "sll_buy_dvsn_cd": "01",
+ "trad_dvsn_name": "HTS SELL",
+ "nmpr_type_cd": "01",
+ "nmpr_type_name": "Limit Order",
+ "pdno": "101S03",
+ "prdt_name": "F 202203",
+ "prdt_type_cd": "301",
+ "ord_qty": "1",
+ "ord_idx": "400.00",
+ "qty": "0",
+ "ord_tmd": "131604",
+ "tot_ccld_qty": "1",
+ "avg_idx": "400.00000000",
+ "tot_ccld_amt": "100000000",
+ "rjct_qty": "0",
+ "ingr_trad_rjct_rson_cd": "00000",
+ "ingr_trad_rjct_rson_name": "NORMAL",
+ "ord_stfno": "Nsmart",
+ "sprd_item_yn": "N",
+ "ord_ip_addr": "P01032651641"
+ },
+ {
+ "ord_gno_brno": "06010",
+ "cano": "810XXXXX",
+ "csac_name": "",
+ "acnt_prdt_cd": "03",
+ "ord_dt": "20220111",
+ "odno": "0000007006",
+ "orgn_odno": "0000007004",
+ "sll_buy_dvsn_cd": "01",
+ "trad_dvsn_name": "CANCEL CONFIRM",
+ "nmpr_type_cd": "01",
+ "nmpr_type_name": "Limit Order",
+ "pdno": "101S03",
+ "prdt_name": "F 202203",
+ "prdt_type_cd": "301",
+ "ord_qty": "1",
+ "ord_idx": "0.00",
+ "qty": "0",
+ "ord_tmd": "150233",
+ "tot_ccld_qty": "0",
+ "avg_idx": "0.00000000",
+ "tot_ccld_amt": "0",
+ "rjct_qty": "0",
+ "ingr_trad_rjct_rson_cd": "00000",
+ "ingr_trad_rjct_rson_name": "NORMAL",
+ "ord_stfno": "Nsmart",
+ "sprd_item_yn": "N",
+ "ord_ip_addr": "P01032651641"
+ }
+ ],
+ "output2": {
+ "tot_ord_qty": "4",
+ "tot_ccld_amt_smtl": "200000000",
+ "tot_ccld_qty_smtl": "2",
+ "fee_smtl": "28570",
+ "ctac_tlno": "01047859775"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/200_국내선물-009_야간선물옵션-주문체결-내역조회.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/200_국내선물-009_야간선물옵션-주문체결-내역조회.md
new file mode 100644
index 0000000..87b2a30
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/200_국내선물-009_야간선물옵션-주문체결-내역조회.md
@@ -0,0 +1,159 @@
+# (야간)선물옵션 주문체결 내역조회
+
+- 원본 시트명: (야간)선물옵션 주문체결 내역조회
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: 국내선물-009
+- HTTP Method: GET
+- 실전 TR_ID: (구) JTCE5005R (신) STTN5201R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ngt-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(야간)선물옵션 주문체결 내역조회 API입니다.
+
+1. 야간 시장이 종료(06:00)된 이후 약 06:10경 야간시장의 주문체결내역이 주간으로 이관됩니다.
+ > 주간 API를 사용한다면 야간 장 중 주문체결내역을 실시간으로 조회할 수 없습니다.
+ > 주문체결내역의 이관이 완료되는 시점부터 주간 테이블에서 야간의 주문체결내역을 조회할 수 있습니다.
+
+2. KRX야간시장의 경우 주문일자는 (T+1)일 입니다.
+ > 금요일의 경우 주문일자는 주말 및 공휴일을 제외하고 익 영업일인 월요일로 설정됩니다.
+ > 위 내용은 당사의 기준이 아닌 KRX 거래소의 기준으로 전 회원사 동일한 기준으로 주문체결이 이루어지고 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | (구) JTCE5005R (신) STTN5201R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| STRT_ORD_DT | 시작주문일자 | string | Y | 8 | |
+| END_ORD_DT | 종료주문일자 | string | Y | 8 | 조회하려는 마지막 일자 다음일자로 조회
(ex. 20221011 까지의 내역을 조회하고자 할 경우,
20221012로 종료주문일자 설정) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 공란 : default (00: 전체 ,01 : 매도, 02 : 매수) |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 00 : 전체
01 : 체결
02 : 미체결 |
+| SORT_SQN | 정렬순서 | string | Y | 2 | 공란 : default (DS : 정순, 그외 : 역순) |
+| STRT_ODNO | 시작주문번호 | string | Y | 10 | 공란 : default |
+| PDNO | 상품번호 | string | Y | 12 | 공란 : default |
+| MKET_ID_CD | 시장ID코드 | string | Y | 3 | 공란 : default |
+| FUOP_DVSN_CD | 선물옵션구분코드 | string | Y | 2 | 공란 : 전체, 01 : 선물, 02 : 옵션 |
+| SCRN_DVSN | 화면구분 | string | Y | 2 | 02(Default) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세1 | object | Y | | |
+| tot_ord_qty | 총주문수량 | string | Y | 10 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| tot_ccld_qty_SMTL | 총체결수량 | string | Y | 19 | 신규 TR 사용 필드 |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| tot_ccld_amt_SMTL | 총체결금액 | string | Y | 11 | 신규 TR 사용 필드 |
+| fee | 수수료 | string | Y | 19 | |
+| ctac_tlno | 연락전화번호 | string | Y | 20 | 신규 TR 사용 필드 |
+| output1 | 응답상세2 | object array | Y | | 시간별체결 정보 |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| csac_name | 종합계좌명 | string | Y | 60 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| odno | 주문번호 | string | Y | 10 | |
+| orgn_odno | 원주문번호 | string | Y | 10 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| nmpr_type_name | 호가유형명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| ord_idx4 | 주문지수 | string | Y | 20 | 신규 TR 사용 필드 |
+| qty | 잔량 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| avg_idx | 평균지수 | string | Y | 19 | |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| rjct_qty | 거부수량 | string | Y | 10 | |
+| ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | string | Y | 5 | |
+| ingr_trad_rjct_rson_name | 장내매매거부사유명 | string | Y | 60 | |
+| ord_stfno | 주문직원번호 | string | Y | 6 | |
+| sprd_item_yn | 스프레드종목여부 | string | Y | 1 | |
+| ord_ip_addr | 주문IP주소 | string | Y | 200 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"03",
+ "STRT_ORD_DT":"20220730",
+ "END_ORD_DT":"20221214",
+ "SLL_BUY_DVSN_CD":"00",
+ "CCLD_NCCS_DVSN":"00",
+ "SORT_SQN":"DS",
+ "STRT_ODNO":"",
+ "PDNO":"",
+ "MKET_ID_CD":"00",
+ "FUOP_DVSN_CD":"",
+ "SCRN_DVSN":"00",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "81012345^03^20221214^20221214^DS^ ",
+ "ctx_area_nk200": " ",
+ "output1": [],
+ "output2": {
+ "tot_ord_qty": "0",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "fee": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0560",
+ "msg1": "조회할 내용이 없습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/201_국내선물-011_야간선물옵션-주문가능-조회.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/201_국내선물-011_야간선물옵션-주문가능-조회.md
new file mode 100644
index 0000000..6ed0f47
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/201_국내선물-011_야간선물옵션-주문가능-조회.md
@@ -0,0 +1,105 @@
+# (야간)선물옵션 주문가능 조회
+
+- 원본 시트명: (야간)선물옵션 주문가능 조회
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: 국내선물-011
+- HTTP Method: GET
+- 실전 TR_ID: (구) JTCE1004R (신) STTN5105R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-psbl-ngt-order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(야간)선물옵션 주문가능 조회 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | (구) JTCE1004R (신) STTN5105R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| PDNO | 상품번호 | string | Y | 12 | |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 301 : 선물옵션 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도 , 02 : 매수 |
+| UNIT_PRICE | 주문가격1 | string | Y | 23 | |
+| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | '01 : 지정가 02 : 시장가
03 : 조건부 04 : 최유리,
10 : 지정가(IOC) 11 : 지정가(FOK)
12 : 시장가(IOC) 13 : 시장가(FOK)
14 : 최유리(IOC) 15 : 최유리(FOK)' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| max_ord_psbl_qty | 최대주문가능수량 | string | Y | 19 | 최대주문가능수량 (신규 TR 미사용 필드) |
+| tot_psbl_qty | 최대주문가능수량 | string | Y | 19 | |
+| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | 청산가능수량 |
+| lqd_psbl_qty_1 | 청산가능수량 | string | Y | 19 | 신규 TR 사용 필드 |
+| ord_psbl_qty | 주문가능수량 | string | Y | 19 | |
+| bass_idx | 기준지수 | string | Y | 23 | 신규 TR 사용 필드 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"03",
+ "PDNO":"101T03",
+ "PRDT_TYPE_CD":"301",
+ "SLL_BUY_DVSN_CD":"02",
+ "UNIT_PRICE":"",
+ "ORD_DVSN_CD":"01"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "max_ord_psbl_qty": "996",
+ "lqd_psbl_qty": "0",
+ "ord_psbl_qty": "996"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/202_v1_국내선물-013_선물옵션-잔고정산손익내역.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/202_v1_국내선물-013_선물옵션-잔고정산손익내역.md
new file mode 100644
index 0000000..6e4347c
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/202_v1_국내선물-013_선물옵션-잔고정산손익내역.md
@@ -0,0 +1,147 @@
+# 선물옵션 잔고정산손익내역
+
+- 원본 시트명: 선물옵션 잔고정산손익내역
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-013
+- HTTP Method: GET
+- 실전 TR_ID: CTFO6117R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance-settlement-pl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 잔고정산손익내역 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTFO6117R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| INQR_DT | 조회일자 | string | Y | 8 | 조회일자(YYYYMMDD) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object | Y | | |
+| nxdy_dnca | 익일예수금 | string | Y | 19 | |
+| mmga_cash | 유지증거금현금 | string | Y | 19 | |
+| brkg_mgna_cash | 위탁증거금현금 | string | Y | 19 | |
+| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | |
+| opt_lqd_evlu_amt | 옵션청산평가금액 | string | Y | 19 | |
+| dnca_sbst | 예수금대용 | string | Y | 19 | |
+| mmga_tota | 유지증거금총액 | string | Y | 19 | |
+| brkg_mgna_tota | 위탁증거금총액 | string | Y | 19 | |
+| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| thdt_dfpa | 당일차금 | string | Y | 19 | |
+| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
+| dnca_cash | 예수금현금 | string | Y | 19 | |
+| output1 | 응답상세2 | array | Y | | array |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| bfdy_cblc_qty | 전일잔고수량 | string | Y | 19 | |
+| new_qty | 신규수량 | string | Y | 10 | |
+| mnpl_rpch_qty | 전매환매수량 | string | Y | 10 | |
+| cblc_qty | 잔고수량 | string | Y | 19 | |
+| cblc_amt | 잔고금액 | string | Y | 19 | |
+| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"03",
+ "INQR_DT":"20230906",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678!^03!^20230906 ",
+ "ctx_area_nk200": " !^ ",
+ "output1": [
+ {
+ "pdno": "101T09",
+ "prdt_name": "F 202309",
+ "trad_dvsn_name": "매수",
+ "bfdy_cblc_qty": "2",
+ "new_qty": "0",
+ "mnpl_rpch_qty": "0",
+ "cblc_qty": "2",
+ "cblc_amt": "-425000",
+ "trad_pfls_amt": "0",
+ "evlu_amt": "149350000",
+ "evlu_pfls_amt": "-1675000"
+ }
+ ],
+ "output2": {
+ "nxdy_dnca": "0",
+ "mmga_cash": "0",
+ "brkg_mgna_cash": "0",
+ "opt_buy_chgs": "0",
+ "opt_lqd_evlu_amt": "0",
+ "dnca_sbst": "0",
+ "mmga_tota": "0",
+ "brkg_mgna_tota": "0",
+ "opt_sll_chgs": "0",
+ "fee": "0",
+ "thdt_dfpa": "0",
+ "rnwl_dfpa": "0",
+ "dnca_cash": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/203_v1_국내선물-005_선물옵션-주문가능.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/203_v1_국내선물-005_선물옵션-주문가능.md
new file mode 100644
index 0000000..331bf79
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/203_v1_국내선물-005_선물옵션-주문가능.md
@@ -0,0 +1,102 @@
+# 선물옵션 주문가능
+
+- 원본 시트명: 선물옵션 주문가능
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-005
+- HTTP Method: GET
+- 실전 TR_ID: TTTO5105R
+- 모의 TR_ID: VTTO5105R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-psbl-order
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 주문가능 API입니다. 주문가능 내역과 수량을 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access Token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Credentials Grant 절차를 준용)
제휴사(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTO5105R : 선물 옵션 주문 가능
[모의투자]
VTTO5105R : 선물 옵션 주문 가능 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사 APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | 제휴사는 사용자(회원)의 IP Address 필수이며 일반고객은 제외 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | N | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | N | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 상품번호 | string | N | 12 | 선물옵션종목코드
선물 6자리 (예: 101S03)
옵션 9자리 (예: 201S03370) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | N | 2 | 01 : 매도
02 : 매수 |
+| UNIT_PRICE | 주문가격1 | string | N | 23 | 주문가격
※ 주문가격 '0'일 경우
- 옵션매수 : 현재가
- 그 이외 : 기준가 |
+| ORD_DVSN_CD | 주문구분코드 | string | N | 2 | 01 : 지정가
02 : 시장가
03 : 조건부
04 : 최유리,
10 : 지정가(IOC)
11 : 지정가(FOK)
12 : 시장가(IOC)
13 : 시장가(FOK)
14 : 최유리(IOC)
15 : 최유리(FOK) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | array | Y | | |
+| tot_psbl_qty | 총가능수량 | string | Y | 10 | 총가능수량 |
+| lqd_psbl_qty1 | 청산가능수량1 | string | Y | 10 | 청산가능수량 |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | 주문가능수량 |
+| bass_idx | 기준지수 | string | Y | 32 | 기준지수 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD":"03",
+ "PDNO": "101R12",
+ "SLL_BUY_DVSN_CD": "02",
+ "UNIT_PRICE": "397.95",
+ "ORD_DVSN_CD": "01"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "tot_psbl_qty": "11679",
+ "lqd_psbl_qty1": "0",
+ "ord_psbl_qty": "11665",
+ "bass_idx": "379.67000000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내선물옵션/주문/계좌/204_v1_국내선물-016_선물옵션-기준일체결내역.md b/docs/broker/kis/rest/국내선물옵션/주문/계좌/204_v1_국내선물-016_선물옵션-기준일체결내역.md
new file mode 100644
index 0000000..2ab222f
--- /dev/null
+++ b/docs/broker/kis/rest/국내선물옵션/주문/계좌/204_v1_국내선물-016_선물옵션-기준일체결내역.md
@@ -0,0 +1,143 @@
+# 선물옵션 기준일체결내역
+
+- 원본 시트명: 선물옵션 기준일체결내역
+- API 통신방식: REST
+- 메뉴 위치: [국내선물옵션] 주문/계좌
+- API ID: v1_국내선물-016
+- HTTP Method: GET
+- 실전 TR_ID: CTFO5139R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ccnl-bstime
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+선물옵션 기준일체결내역 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTFO5139R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ORD_DT | 주문일자 | string | Y | 8 | 주문일자(YYYYMMDD) |
+| FUOP_TR_STRT_TMD | 선물옵션거래시작시각 | string | Y | 6 | 선물옵션거래시작시간(HHMMSS) |
+| FUOP_TR_END_TMD | 선물옵션거래종료시각 | string | Y | 6 | 선물옵션거래종료시간(HHMMSS) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | array | Y | | array |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| odno | 주문번호 | string | Y | 10 | |
+| tr_type_name | 거래유형명 | string | Y | 60 | |
+| last_sttldt | 최종결제일 | string | Y | 8 | |
+| ccld_idx | 체결지수 | string | Y | 24 | |
+| ccld_qty | 체결량 | string | Y | 10 | |
+| trad_amt | 매매금액 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| ccld_btwn | 체결시간 | string | Y | 6 | |
+| output2 | 응답상세2 | object | Y | | |
+| tot_ccld_qty_smtl | 총체결수량합계 | string | Y | 19 | |
+| tot_ccld_amt_smtl | 총체결금액합계 | string | Y | 19 | |
+| fee_adjt | 수수료조정 | string | Y | 19 | |
+| fee_smtl | 수수료합계 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"03",
+ "ORD_DT":"20230920",
+ "FUOP_TR_STRT_TMD":"000000",
+ "FUOP_TR_END_TMD":"240000",
+ "CTX_AREA_FK200":"",
+ 'CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678!^03!^20230920!^000000!^240000 ",
+ "ctx_area_nk200": " !^ !^ !^ ",
+ "output1": [
+ {
+ "pdno": "201T10340",
+ "prdt_name": "코스피200 C 202310 340.0",
+ "odno": "0000219602",
+ "tr_type_name": "지수콜옵션매수",
+ "last_sttldt": "20231012",
+ "ccld_idx": "2.80000000",
+ "ccld_qty": "1",
+ "trad_amt": "700000",
+ "fee": "2758",
+ "ccld_btwn": "140144"
+ },
+ {
+ "pdno": "101T12",
+ "prdt_name": "코스피200 F 202312",
+ "odno": "0000219606",
+ "tr_type_name": "지수선물매수",
+ "last_sttldt": "20231214",
+ "ccld_idx": "335.50000000",
+ "ccld_qty": "5",
+ "trad_amt": "419375000",
+ "fee": "41144",
+ "ccld_btwn": "140121"
+ }
+ ],
+ "output2": {
+ "tot_ccld_qty_smtl": "6",
+ "tot_ccld_amt_smtl": "420075000",
+ "fee_adjt": "43902",
+ "fee_smtl": "43890"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/048_v1_국내주식-014_ELW-현재가-시세.md b/docs/broker/kis/rest/국내주식/ELW-시세/048_v1_국내주식-014_ELW-현재가-시세.md
new file mode 100644
index 0000000..f8b7880
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/048_v1_국내주식-014_ELW-현재가-시세.md
@@ -0,0 +1,157 @@
+# ELW 현재가 시세
+
+- 원본 시트명: ELW 현재가 시세
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: v1_국내주식-014
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW15010000
+- 모의 TR_ID: FHKEW15010000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-elw-price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 현재가 시세 API입니다. ELW 관련 정보를 얻을 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW15010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | W |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (6자리) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| elw_prpr | ELW 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 13 | |
+| unas_shrn_iscd | 기초자산 단축 종목코드 | string | Y | 9 | |
+| unas_isnm | 기초자산 종목명 | string | Y | 40 | |
+| unas_prpr | 기초자산 현재가 | string | Y | 14 | |
+| unas_prdy_vrss | 기초자산 전일 대비 | string | Y | 14 | |
+| unas_prdy_vrss_sign | 기초자산 전일 대비 부호 | string | Y | 1 | |
+| unas_prdy_ctrt | 기초자산 전일 대비율 | string | Y | 11 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| vol_tnrt | 거래량 회전율 | string | Y | 11 | |
+| elw_oprc | ELW 시가2 | string | Y | 10 | |
+| elw_hgpr | ELW 최고가 | string | Y | 10 | |
+| elw_lwpr | ELW 최저가 | string | Y | 10 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| hts_thpr | HTS 이론가 | string | Y | 14 | |
+| dprt | 괴리율 | string | Y | 11 | |
+| atm_cls_name | ATM 구분 명 | string | Y | 10 | |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 16 | |
+| acpr | 행사가 | string | Y | 14 | |
+| pvt_scnd_dmrs_prc | 피벗 2차 디저항 가격 | string | Y | 10 | |
+| pvt_frst_dmrs_prc | 피벗 1차 디저항 가격 | string | Y | 10 | |
+| pvt_pont_val | 피벗 포인트 값 | string | Y | 10 | |
+| pvt_frst_dmsp_prc | 피벗 1차 디지지 가격 | string | Y | 10 | |
+| pvt_scnd_dmsp_prc | 피벗 2차 디지지 가격 | string | Y | 10 | |
+| dmsp_val | 디지지 값 | string | Y | 10 | |
+| dmrs_val | 디저항 값 | string | Y | 10 | |
+| elw_sdpr | ELW 기준가 | string | Y | 10 | |
+| apprch_rate | 접근도 | string | Y | 14 | |
+| tick_conv_prc | 틱환산가 | string | Y | 11 | |
+| invt_epmd_cntt | 투자 유의 내용 | string | Y | 200 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "elw_prpr": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "prdy_vrss_vol_rate": "0.00",
+ "unas_isnm": "BASKET",
+ "unas_prpr": "0.00",
+ "unas_prdy_vrss": "0.00",
+ "unas_prdy_vrss_sign": "3",
+ "unas_prdy_ctrt": "0.00",
+ "bidp": "0",
+ "askp": "0",
+ "acml_tr_pbmn": "0",
+ "vol_tnrt": "0.00",
+ "elw_oprc": "0",
+ "elw_hgpr": "0",
+ "elw_lwpr": "0",
+ "stck_prdy_clpr": "0",
+ "hts_thpr": "0.00",
+ "dprt": "0.00",
+ "atm_cls_name": "ATM",
+ "hts_ints_vltl": "0.00",
+ "acpr": "0.00",
+ "pvt_scnd_dmrs_prc": "0",
+ "pvt_frst_dmrs_prc": "0",
+ "pvt_pont_val": "0",
+ "pvt_frst_dmsp_prc": "0",
+ "pvt_scnd_dmsp_prc": "0",
+ "dmsp_val": "0",
+ "dmrs_val": "0",
+ "elw_sdpr": "0",
+ "apprch_rate": "0.00",
+ "tick_conv_prc": "0.00"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/049_국내주식-181_ELW-신규상장종목.md b/docs/broker/kis/rest/국내주식/ELW-시세/049_국내주식-181_ELW-신규상장종목.md
new file mode 100644
index 0000000..cfb709e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/049_국내주식-181_ELW-신규상장종목.md
@@ -0,0 +1,291 @@
+# ELW 신규상장종목
+
+- 원본 시트명: ELW 신규상장종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-181
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW154800C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/newly-listed
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 신규상장종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0297] ELW 신규상장종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW154800C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key(11548) |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 전체(02), 콜(00), 풋(01) |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | 'ex) 000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
+| FID_INPUT_ISCD_2 | 입력종목코드2 | string | Y | 8 | '00003(한국투자증권), 00017(KB증권),
00005(미래에셋증권)' |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 날짜 (ex) 20240402) |
+| FID_BLNC_CLS_CODE | 결재방법 | string | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| unas_isnm | 기초자산종목명 | string | Y | 40 | |
+| pblc_co_name | 발행회사명 | string | Y | 40 | |
+| lstn_stcn | 상장주수 | string | Y | 18 | |
+| acpr | 행사가 | string | Y | 112 | |
+| stck_last_tr_date | 주식최종거래일자 | string | Y | 8 | |
+| elw_ko_barrier | 조기종료발생기준가격 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:11548
+FID_DIV_CLS_CODE:02
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD_2:00003
+FID_INPUT_DATE_1:20240410
+FID_BLNG_CLS_CODE:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K924HLB콜",
+ "elw_shrn_iscd": "57K924",
+ "unas_isnm": "HLB",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "7100000",
+ "acpr": "78000.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K925HMM콜",
+ "elw_shrn_iscd": "57K925",
+ "unas_isnm": "HMM",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "6700000",
+ "acpr": "20000.00",
+ "stck_last_tr_date": "20240912",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K926HMM콜",
+ "elw_shrn_iscd": "57K926",
+ "unas_isnm": "HMM",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "5600000",
+ "acpr": "20000.00",
+ "stck_last_tr_date": "20241212",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KB45HMM풋",
+ "elw_shrn_iscd": "57KB45",
+ "unas_isnm": "HMM",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "6900000",
+ "acpr": "17700.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K927KB금융콜",
+ "elw_shrn_iscd": "57K927",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "24400000",
+ "acpr": "73600.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K928KB금융콜",
+ "elw_shrn_iscd": "57K928",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "22300000",
+ "acpr": "73600.00",
+ "stck_last_tr_date": "20240912",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K929KB금융콜",
+ "elw_shrn_iscd": "57K929",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "18200000",
+ "acpr": "72000.00",
+ "stck_last_tr_date": "20240711",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K930KB금융콜",
+ "elw_shrn_iscd": "57K930",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "20000000",
+ "acpr": "70500.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국K931KB금융콜",
+ "elw_shrn_iscd": "57K931",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "15700000",
+ "acpr": "69000.00",
+ "stck_last_tr_date": "20240711",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KB46KB금융풋",
+ "elw_shrn_iscd": "57KB46",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "11200000",
+ "acpr": "65000.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KB47KB금융풋",
+ "elw_shrn_iscd": "57KB47",
+ "unas_isnm": "KB금융",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "12000000",
+ "acpr": "63700.00",
+ "stck_last_tr_date": "20240711",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KB98KOSPI200풋",
+ "elw_shrn_iscd": "57KB98",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "7000000",
+ "acpr": "400.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KB99KOSPI200풋",
+ "elw_shrn_iscd": "57KB99",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "7000000",
+ "acpr": "395.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KC00KOSPI200풋",
+ "elw_shrn_iscd": "57KC00",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "7000000",
+ "acpr": "390.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KC01KOSPI200풋",
+ "elw_shrn_iscd": "57KC01",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "9000000",
+ "acpr": "387.50",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KC02KOSPI200풋",
+ "elw_shrn_iscd": "57KC02",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "10000000",
+ "acpr": "385.00",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "stck_lstn_date": "20240320",
+ "elw_kor_isnm": "한국KC03KOSPI200풋",
+ "elw_shrn_iscd": "57KC03",
+ "unas_isnm": "KOSPI200",
+ "pblc_co_name": "한국투자증권(주)",
+ "lstn_stcn": "9000000",
+ "acpr": "382.50",
+ "stck_last_tr_date": "20240613",
+ "elw_ko_barrier": "0.00"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/050_국내주식-173_ELW-투자지표추이일별.md b/docs/broker/kis/rest/국내주식/ELW-시세/050_국내주식-173_ELW-투자지표추이일별.md
new file mode 100644
index 0000000..7ecbba3
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/050_국내주식-173_ELW-투자지표추이일별.md
@@ -0,0 +1,168 @@
+# ELW 투자지표추이(일별)
+
+- 원본 시트명: ELW 투자지표추이(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-173
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02740200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/indicator-trend-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 투자지표추이(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0274] ELW 투자지표추이 화면에서 "일자별 비교추이" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02740200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 시장분류코드 | string | Y | 2 | W |
+| FID_INPUT_ISCD | 종콕코드 | string | Y | 12 | ex. 57K281 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| gear | 기어링 | string | Y | 84 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| prit | 패리티 | string | Y | 112 | |
+| elw_oprc | ELW시가2 | string | Y | 10 | |
+| elw_hgpr | ELW최고가 | string | Y | 10 | |
+| elw_lwpr | ELW최저가 | string | Y | 10 | |
+| apprch_rate | 접근도 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240503",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "1000020",
+ "lvrg_val": "-11.0377",
+ "gear": "19.45",
+ "tmvl_val": "18.00",
+ "invl_val": "22.00",
+ "prit": "102.82",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "35",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "elw_prpr": "45",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "789280",
+ "lvrg_val": "-9.5810",
+ "gear": "17.33",
+ "tmvl_val": "25.00",
+ "invl_val": "20.00",
+ "prit": "102.56",
+ "elw_oprc": "45",
+ "elw_hgpr": "45",
+ "elw_lwpr": "35",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240430",
+ "elw_prpr": "45",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-10.00",
+ "acml_vol": "62090",
+ "lvrg_val": "-10.0683",
+ "gear": "17.22",
+ "tmvl_val": "20.00",
+ "invl_val": "25.00",
+ "prit": "103.22",
+ "elw_oprc": "50",
+ "elw_hgpr": "50",
+ "elw_lwpr": "45",
+ "apprch_rate": "0.00"
+ },...
+ {
+ "stck_bsop_date": "20240117",
+ "elw_prpr": "0",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "lvrg_val": "-0.0000",
+ "gear": "0.00",
+ "tmvl_val": "-90.00",
+ "invl_val": "90.00",
+ "prit": "0.00",
+ "elw_oprc": "0",
+ "elw_hgpr": "0",
+ "elw_lwpr": "0",
+ "apprch_rate": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/051_국내주식-170_ELW-민감도-순위.md b/docs/broker/kis/rest/국내주식/ELW-시세/051_국내주식-170_ELW-민감도-순위.md
new file mode 100644
index 0000000..f2fb9b9
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/051_국내주식-170_ELW-민감도-순위.md
@@ -0,0 +1,174 @@
+# ELW 민감도 순위
+
+- 원본 시트명: ELW 민감도 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-170
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02850000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/ranking/sensitivity
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 민감도 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0285] ELW 민감도 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02850000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key(20285) |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_DIV_CLS_CODE | 콜풋구분코드 | string | Y | 2 | 0(전체), 1(콜), 2(풋) |
+| FID_INPUT_PRICE_1 | 가격(이상) | string | Y | 12 | |
+| FID_INPUT_PRICE_2 | 가격(이하) | string | Y | 12 | |
+| FID_INPUT_VOL_1 | 거래량(이상) | string | Y | 18 | |
+| FID_INPUT_VOL_2 | 거래량(이하) | string | Y | 18 | |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | '0(이론가), 1(델타), 2(감마), 3(로), 4(베가) , 5(로)
, 6(내재변동성), 7(90일변동성)' |
+| FID_INPUT_RMNN_DYNU_1 | 잔존일수(이상) | string | Y | 5 | |
+| FID_INPUT_DATE_1 | 조회기준일 | string | Y | 10 | |
+| FID_BLNG_CLS_CODE | 결재방법 | string | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| hts_thpr | HTS이론가 | string | Y | 112 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| rho | 로우 | string | Y | 84 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+| d90_hist_vltl | 90일역사적변동성 | string | Y | 114 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:20285
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD:00000
+FID_INPUT_RMNN_DYNU_1:0
+FID_DIV_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_RANK_SORT_CLS_CODE:0
+FID_INPUT_RMNN_DYNU_1:
+FID_INPUT_DATE_1:
+FID_BLNG_CLS_CODE:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "57K852",
+ "elw_kor_isnm": "한국K852KOSPI200콜",
+ "elw_prpr": "7770",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "hts_thpr": "8290.81",
+ "delta_val": "1.000000",
+ "gama": "0.0000",
+ "theta": "3.8670",
+ "vega": "0.0000",
+ "rho": "19.3352",
+ "hts_ints_vltl": "0.00",
+ "d90_hist_vltl": "16.793295"
+ },
+ {
+ "elw_shrn_iscd": "57JAVS",
+ "elw_kor_isnm": "한국JAVSKOSPI200콜",
+ "elw_prpr": "4690",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "hts_thpr": "7891.32",
+ "delta_val": "1.000000",
+ "gama": "0.0000",
+ "theta": "3.9449",
+ "vega": "0.0000",
+ "rho": "119.9611",
+ "hts_ints_vltl": "0.00",
+ "d90_hist_vltl": "16.793295"
+ },
+ {
+ "elw_shrn_iscd": "57JAVD",
+ "elw_kor_isnm": "한국JAVDKOSPI200콜",
+ "elw_prpr": "7800",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "hts_thpr": "7793.07",
+ "delta_val": "0.993055",
+ "gama": "0.0005",
+ "theta": "4.3385",
+ "vega": "4.0200",
+ "rho": "91.7439",
+ "hts_ints_vltl": "17.48",
+ "d90_hist_vltl": "16.793295"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/052_국내주식-186_ELW-기초자산별-종목시세.md b/docs/broker/kis/rest/국내주식/ELW-시세/052_국내주식-186_ELW-기초자산별-종목시세.md
new file mode 100644
index 0000000..61d6468
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/052_국내주식-186_ELW-기초자산별-종목시세.md
@@ -0,0 +1,514 @@
+# ELW 기초자산별 종목시세
+
+- 원본 시트명: ELW 기초자산별 종목시세
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-186
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW154101C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/udrl-asset-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 기초자산별 종목시세 API입니다.
+한국투자 HTS(eFriend Plus) > [0288] ELW 기초자산별 ELW 시세 화면의 "우측 기초자산별 종목 리스트" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW154101C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분(W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Uniquekey(11541) |
+| FID_MRKT_CLS_CODE | 시장구분코드 | string | Y | 2 | 전체(A),콜(C),풋(P) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | |
+| FID_VOL_CNT | 거래량수 | string | Y | 12 | 전일거래량(정수량미만) |
+| FID_TRGT_EXLS_CLS_CODE | 대상제외구분코드 | string | Y | 32 | 거래불가종목제외(0:미체크,1:체크) |
+| FID_INPUT_PRICE_1 | 입력가격1 | string | Y | 12 | 가격~원이상 |
+| FID_INPUT_PRICE_2 | 입력가격2 | string | Y | 12 | 가격~월이하 |
+| FID_INPUT_VOL_1 | 입력거래량1 | string | Y | 18 | 거래량~계약이상 |
+| FID_INPUT_VOL_2 | 입력거래량2 | string | Y | 18 | 거래량~계약이하 |
+| FID_INPUT_RMNN_DYNU_1 | 입력잔존일수1 | string | Y | 5 | 잔존일(~일이상) |
+| FID_INPUT_RMNN_DYNU_2 | 입력잔존일수2 | string | Y | 5 | 잔존일(~일이하) |
+| FID_OPTION | 옵션 | string | Y | 5 | 옵션상태(0:없음,1:ATM,2:ITM,3:OTM) |
+| FID_INPUT_OPTION_1 | 입력옵션1 | string | Y | 10 | |
+| FID_INPUT_OPTION_2 | 입력옵션2 | string | Y | 10 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| acpr | 행사가 | string | Y | 112 | |
+| prls_qryr_stpr_prc | 손익분기주가가격 | string | Y | 112 | |
+| hts_rmnn_dynu | HTS잔존일수 | string | Y | 5 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| lp_hvol | LP보유량 | string | Y | 18 | |
+| lp_rlim | LP비중 | string | Y | 52 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| gear | 기어링 | string | Y | 84 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| prls_qryr_rate | 손익분기비율 | string | Y | 84 | |
+| cfp | 자본지지점 | string | Y | 112 | |
+| prit | 패리티 | string | Y | 112 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| hts_thpr | HTS이론가 | string | Y | 112 | |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| stck_last_tr_date | 주식최종거래일자 | string | Y | 8 | |
+| lp_ntby_qty | LP순매도량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:11541
+FID_MRKT_CLS_CODE:A
+FID_INPUT_ISCD:00000
+FID_UNAS_INPUT_ISCD:005930
+FID_VOL_CNT:
+FID_TRGT_EXLS_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_INPUT_RMNN_DYNU_1:
+FID_INPUT_RMNN_DYNU_2:
+FID_OPTION:0
+FID_INPUT_OPTION_1:
+FID_INPUT_OPTION_2:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "57JAAQ",
+ "hts_kor_isnm": "한국JAAQ삼성전자풋",
+ "elw_prpr": "10",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "63300.00",
+ "prls_qryr_stpr_prc": "62300.00",
+ "hts_rmnn_dynu": "42",
+ "hts_ints_vltl": "60.72",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "17298270",
+ "lp_rlim": "99.99",
+ "lvrg_val": "-9.448319",
+ "gear": "77.7000",
+ "delta_val": "-0.121600",
+ "gama": "0.0000",
+ "vega": "0.5078",
+ "theta": "0.5759",
+ "prls_qryr_rate": "-19.8100",
+ "cfp": "-19.5600",
+ "prit": "81.46",
+ "invl_val": "0.00",
+ "tmvl_val": "10.00",
+ "hts_thpr": "0.18",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAML",
+ "hts_kor_isnm": "한국JAML삼성전자콜",
+ "elw_prpr": "120",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "64700.00",
+ "prls_qryr_stpr_prc": "76700.00",
+ "hts_rmnn_dynu": "7",
+ "hts_ints_vltl": "0.00",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "11995780",
+ "lp_rlim": "99.96",
+ "lvrg_val": "5.184000",
+ "gear": "6.4800",
+ "delta_val": "0.800000",
+ "gama": "0.0000",
+ "vega": "0.0000",
+ "theta": "0.0669",
+ "prls_qryr_rate": "-1.4100",
+ "cfp": "-1.6700",
+ "prit": "120.24",
+ "invl_val": "132.00",
+ "tmvl_val": "-12.00",
+ "hts_thpr": "131.60",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240509",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAMM",
+ "hts_kor_isnm": "한국JAMM삼성전자콜",
+ "elw_prpr": "115",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "67300.00",
+ "prls_qryr_stpr_prc": "78800.00",
+ "hts_rmnn_dynu": "42",
+ "hts_ints_vltl": "32.23",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "12499500",
+ "lp_rlim": "100.00",
+ "lvrg_val": "6.288443",
+ "gear": "6.7600",
+ "delta_val": "0.930243",
+ "gama": "0.0000",
+ "vega": "0.3368",
+ "theta": "0.2915",
+ "prls_qryr_rate": "1.2800",
+ "cfp": "1.5000",
+ "prit": "115.60",
+ "invl_val": "105.00",
+ "tmvl_val": "10.00",
+ "hts_thpr": "108.09",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240613",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAMN",
+ "hts_kor_isnm": "한국JAMN삼성전자콜",
+ "elw_prpr": "120",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.35",
+ "acml_vol": "10",
+ "acpr": "68700.00",
+ "prls_qryr_stpr_prc": "80700.00",
+ "hts_rmnn_dynu": "161",
+ "hts_ints_vltl": "27.90",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "8800820",
+ "lp_rlim": "84.62",
+ "lvrg_val": "5.212408",
+ "gear": "6.4800",
+ "delta_val": "0.804384",
+ "gama": "0.0000",
+ "vega": "1.3937",
+ "theta": "0.2545",
+ "prls_qryr_rate": "3.7200",
+ "cfp": "4.4000",
+ "prit": "113.24",
+ "invl_val": "91.00",
+ "tmvl_val": "29.00",
+ "hts_thpr": "111.27",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20241010",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAMP",
+ "hts_kor_isnm": "한국JAMP삼성전자콜",
+ "elw_prpr": "90",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-10.00",
+ "acml_vol": "20",
+ "acpr": "70200.00",
+ "prls_qryr_stpr_prc": "79200.00",
+ "hts_rmnn_dynu": "70",
+ "hts_ints_vltl": "28.96",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "12997850",
+ "lp_rlim": "99.98",
+ "lvrg_val": "7.137444",
+ "gear": "8.6400",
+ "delta_val": "0.826093",
+ "gama": "0.0000",
+ "vega": "0.8580",
+ "theta": "0.3448",
+ "prls_qryr_rate": "1.7900",
+ "cfp": "2.0300",
+ "prit": "110.82",
+ "invl_val": "76.00",
+ "tmvl_val": "14.00",
+ "hts_thpr": "86.23",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240711",
+ "lp_ntby_qty": "-20"
+ },
+ {
+ "elw_shrn_iscd": "57JAMR",
+ "hts_kor_isnm": "한국JAMR삼성전자콜",
+ "elw_prpr": "75",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "73300.00",
+ "prls_qryr_stpr_prc": "80800.00",
+ "hts_rmnn_dynu": "98",
+ "hts_ints_vltl": "27.07",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "13926710",
+ "lp_rlim": "98.77",
+ "lvrg_val": "7.394173",
+ "gear": "10.3700",
+ "delta_val": "0.713035",
+ "gama": "0.0000",
+ "vega": "1.3629",
+ "theta": "0.3448",
+ "prls_qryr_rate": "3.8500",
+ "cfp": "4.2600",
+ "prit": "106.13",
+ "invl_val": "45.00",
+ "tmvl_val": "30.00",
+ "hts_thpr": "68.15",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240808",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAMS",
+ "hts_kor_isnm": "한국JAMS삼성전자콜",
+ "elw_prpr": "120",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "73300.00",
+ "prls_qryr_stpr_prc": "85300.00",
+ "hts_rmnn_dynu": "133",
+ "hts_ints_vltl": "26.88",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "13399930",
+ "lp_rlim": "100.00",
+ "lvrg_val": "4.540122",
+ "gear": "6.4800",
+ "delta_val": "0.700636",
+ "gama": "0.0000",
+ "vega": "1.6226",
+ "theta": "0.3056",
+ "prls_qryr_rate": "9.6400",
+ "cfp": "11.3900",
+ "prit": "106.13",
+ "invl_val": "45.00",
+ "tmvl_val": "75.00",
+ "hts_thpr": "74.43",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240912",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAPS",
+ "hts_kor_isnm": "한국JAPS삼성전자풋",
+ "elw_prpr": "10",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "70000.00",
+ "prls_qryr_stpr_prc": "69000.00",
+ "hts_rmnn_dynu": "42",
+ "hts_ints_vltl": "39.14",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "8789750",
+ "lp_rlim": "99.88",
+ "lvrg_val": "-13.763233",
+ "gear": "77.7000",
+ "delta_val": "-0.177133",
+ "gama": "0.0000",
+ "vega": "0.6533",
+ "theta": "0.4692",
+ "prls_qryr_rate": "-11.1900",
+ "cfp": "-11.0500",
+ "prit": "90.09",
+ "invl_val": "0.00",
+ "tmvl_val": "10.00",
+ "hts_thpr": "3.39",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240613",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAPT",
+ "hts_kor_isnm": "한국JAPT삼성전자풋",
+ "elw_prpr": "20",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "70000.00",
+ "prls_qryr_stpr_prc": "68000.00",
+ "hts_rmnn_dynu": "133",
+ "hts_ints_vltl": "31.53",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "7593700",
+ "lp_rlim": "99.92",
+ "lvrg_val": "-9.186005",
+ "gear": "38.8500",
+ "delta_val": "-0.236448",
+ "gama": "0.0000",
+ "vega": "1.4404",
+ "theta": "0.2237",
+ "prls_qryr_rate": "-12.4800",
+ "cfp": "-12.1700",
+ "prit": "90.09",
+ "invl_val": "0.00",
+ "tmvl_val": "20.00",
+ "hts_thpr": "13.97",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240912",
+ "lp_ntby_qty": "0"
+ },
+ {
+ "elw_shrn_iscd": "57JAZR",
+ "hts_kor_isnm": "한국JAZR삼성전자콜",
+ "elw_prpr": "70",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-12.50",
+ "acml_vol": "5130",
+ "acpr": "77300.00",
+ "prls_qryr_stpr_prc": "84300.00",
+ "hts_rmnn_dynu": "196",
+ "hts_ints_vltl": "26.13",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "13970240",
+ "lp_rlim": "97.69",
+ "lvrg_val": "6.527688",
+ "gear": "11.1000",
+ "delta_val": "0.588080",
+ "gama": "0.0000",
+ "vega": "2.1844",
+ "theta": "0.2725",
+ "prls_qryr_rate": "8.4900",
+ "cfp": "9.3300",
+ "prit": "100.51",
+ "invl_val": "6.00",
+ "tmvl_val": "64.00",
+ "hts_thpr": "60.18",
+ "stck_lstn_date": "20231220",
+ "stck_last_tr_date": "20241114",
+ "lp_ntby_qty": "5020"
+ },
+ {
+ "elw_shrn_iscd": "57JAZS",
+ "hts_kor_isnm": "한국JAZS삼성전자콜",
+ "elw_prpr": "55",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "504200",
+ "acpr": "75600.00",
+ "prls_qryr_stpr_prc": "81100.00",
+ "hts_rmnn_dynu": "70",
+ "hts_ints_vltl": "28.73",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "15421560",
+ "lp_rlim": "98.23",
+ "lvrg_val": "8.965918",
+ "gear": "14.1200",
+ "delta_val": "0.634980",
+ "gama": "0.0000",
+ "vega": "1.2562",
+ "theta": "0.4515",
+ "prls_qryr_rate": "4.3700",
+ "cfp": "4.7000",
+ "prit": "102.77",
+ "invl_val": "23.00",
+ "tmvl_val": "32.00",
+ "hts_thpr": "46.86",
+ "stck_lstn_date": "20231220",
+ "stck_last_tr_date": "20240711",
+ "lp_ntby_qty": "45700"
+ },...
+ {
+ "elw_shrn_iscd": "57KA61",
+ "hts_kor_isnm": "한국KA61삼성전자콜",
+ "elw_prpr": "40",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "331400",
+ "acpr": "78300.00",
+ "prls_qryr_stpr_prc": "82300.00",
+ "hts_rmnn_dynu": "70",
+ "hts_ints_vltl": "28.17",
+ "stck_cnvr_rate": "0.010000",
+ "lp_hvol": "23296960",
+ "lp_rlim": "99.99",
+ "lvrg_val": "10.171226",
+ "gear": "19.4200",
+ "delta_val": "0.523750",
+ "gama": "0.0000",
+ "vega": "1.3308",
+ "theta": "0.4570",
+ "prls_qryr_rate": "5.9200",
+ "cfp": "6.2400",
+ "prit": "99.23",
+ "invl_val": "0.00",
+ "tmvl_val": "40.00",
+ "hts_thpr": "32.21",
+ "stck_lstn_date": "20240320",
+ "stck_last_tr_date": "20240711",
+ "lp_ntby_qty": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/053_국내주식-166_ELW-종목검색.md b/docs/broker/kis/rest/국내주식/ELW-시세/053_국내주식-166_ELW-종목검색.md
new file mode 100644
index 0000000..b946b31
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/053_국내주식-166_ELW-종목검색.md
@@ -0,0 +1,464 @@
+# ELW 종목검색
+
+- 원본 시트명: ELW 종목검색
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-166
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW15100000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/cond-search
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 종목검색 API입니다.
+한국투자 HTS(eFriend Plus) > [0291] ELW 종목검색 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+한 번의 호출에 최대 100건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW15100000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | ELW(W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 화면번호(11510) |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | '정렬1정렬안함(0)종목코드(1)현재가(2)대비율(3)거래량(4)행사가격(5)
전환비율(6)상장일(7)만기일(8)잔존일수(9)레버리지(10)' |
+| FID_INPUT_CNT_1 | 입력수1 | string | Y | 12 | 정렬1기준 - 상위(1)하위(2) |
+| FID_RANK_SORT_CLS_CODE_2 | 순위정렬구분코드2 | string | Y | 2 | 정렬2 |
+| FID_INPUT_CNT_2 | 입력수2 | string | Y | 12 | 정렬2기준 - 상위(1)하위(2) |
+| FID_RANK_SORT_CLS_CODE_3 | 순위정렬구분코드3 | string | Y | 2 | 정렬3 |
+| FID_INPUT_CNT_3 | 입력수3 | string | Y | 12 | 정렬3기준 - 상위(1)하위(2) |
+| FID_TRGT_CLS_CODE | 대상구분코드 | string | Y | 32 | 0:발행회사종목코드,1:기초자산종목코드,2:FID시장구분코드,3:FID입력날짜1(상장일),
4:FID입력날짜2(만기일),5:LP회원사종목코드,6:행사가기초자산비교>=(1) <=(2),
7:잔존일 이상 이하, 8:현재가, 9:전일대비율, 10:거래량, 11:최종거래일, 12:레버리지 |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 발행사종목코드전체(00000) |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | |
+| FID_MRKT_CLS_CODE | 시장구분코드 | string | Y | 2 | 권리유형전체(A)콜(CO)풋(PO) |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 상장일전체(0)금일(1)7일이하(2)8~30일(3)31~90일(4) |
+| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | 만기일전체(0)1개월(1)1~2(2)2~3(3)3~6(4)6~9(5)9~12(6)12이상(7) |
+| FID_INPUT_ISCD_2 | 입력종목코드2 | string | Y | 8 | |
+| FID_ETC_CLS_CODE | 기타구분코드 | string | Y | 2 | 행사가전체(0)>=(1) |
+| FID_INPUT_RMNN_DYNU_1 | 입력잔존일수1 | string | Y | 5 | 잔존일이상 |
+| FID_INPUT_RMNN_DYNU_2 | 입력잔존일수2 | string | Y | 5 | 잔존일이하 |
+| FID_PRPR_CNT1 | 현재가수1 | string | Y | 11 | 현재가이상 |
+| FID_PRPR_CNT2 | 현재가수2 | string | Y | 11 | 현재가이하 |
+| FID_RSFL_RATE1 | 등락비율1 | string | Y | 132 | 전일대비율이상 |
+| FID_RSFL_RATE2 | 등락비율2 | string | Y | 132 | 전일대비율이하 |
+| FID_VOL1 | 거래량1 | string | Y | 18 | 거래량이상 |
+| FID_VOL2 | 거래량2 | string | Y | 18 | 거래량이하 |
+| FID_APLY_RANG_PRC_1 | 적용범위가격1 | string | Y | 18 | 최종거래일from |
+| FID_APLY_RANG_PRC_2 | 적용범위가격2 | string | Y | 18 | 최종거래일to |
+| FID_LVRG_VAL1 | 레버리지값1 | string | Y | 114 | |
+| FID_LVRG_VAL2 | 레버리지값2 | string | Y | 114 | |
+| FID_VOL3 | 거래량3 | string | Y | 18 | LP종료일from |
+| FID_VOL4 | 거래량4 | string | Y | 18 | LP종료일to |
+| FID_INTS_VLTL1 | 내재변동성1 | string | Y | 114 | 내재변동성이상 |
+| FID_INTS_VLTL2 | 내재변동성2 | string | Y | 114 | 내재변동성이하 |
+| FID_PRMM_VAL1 | 프리미엄값1 | string | Y | 132 | 프리미엄이상 |
+| FID_PRMM_VAL2 | 프리미엄값2 | string | Y | 132 | 프리미엄이하 |
+| FID_GEAR1 | 기어링1 | string | Y | 84 | 기어링이상 |
+| FID_GEAR2 | 기어링2 | string | Y | 84 | 기어링이하 |
+| FID_PRLS_QRYR_RATE1 | 손익분기비율1 | string | Y | 132 | 손익분기이상 |
+| FID_PRLS_QRYR_RATE2 | 손익분기비율2 | string | Y | 132 | 손익분기이하 |
+| FID_DELTA1 | 델타1 | string | Y | 84 | 델타이상 |
+| FID_DELTA2 | 델타2 | string | Y | 84 | 델타이하 |
+| FID_ACPR1 | 행사가1 | string | Y | 133 | |
+| FID_ACPR2 | 행사가2 | string | Y | 133 | |
+| FID_STCK_CNVR_RATE1 | 주식전환비율1 | string | Y | 94 | 전환비율이상 |
+| FID_STCK_CNVR_RATE2 | 주식전환비율2 | string | Y | 94 | 전환비율이하 |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 0:전체,1:일반,2:조기종료 |
+| FID_PRIT1 | 패리티1 | string | Y | 112 | 패리티이상 |
+| FID_PRIT2 | 패리티2 | string | Y | 112 | 패리티이하 |
+| FID_CFP1 | 자본지지점1 | string | Y | 112 | 배리어이상 |
+| FID_CFP2 | 자본지지점2 | string | Y | 112 | 배리어이하 |
+| FID_INPUT_NMIX_PRICE_1 | 지수가격1 | string | Y | 112 | LP보유비율이상 |
+| FID_INPUT_NMIX_PRICE_2 | 지수가격2 | string | Y | 112 | LP보유비율이하 |
+| FID_EGEA_VAL1 | E기어링값1 | string | Y | 132 | 접근도이상 |
+| FID_EGEA_VAL2 | E기어링값2 | string | Y | 132 | 접근도이하 |
+| FID_INPUT_DVDN_ERT | 배당수익율 | string | Y | 112 | 손익분기점이상 |
+| FID_INPUT_HIST_VLTL | 역사적변동성 | string | Y | 112 | 손익분기점이하 |
+| FID_THETA1 | 세타1 | string | Y | 84 | MONEYNESS이상 |
+| FID_THETA2 | 세타2 | string | Y | 84 | MONEYNESS이하 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| bond_shrn_iscd | 채권단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| rght_type_name | 권리유형명 | string | Y | 40 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| acpr | 행사가 | string | Y | 112 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| stck_last_tr_date | 주식최종거래일자 | string | Y | 8 | |
+| hts_rmnn_dynu | HTS잔존일수 | string | Y | 5 | |
+| unas_isnm | 기초자산종목명 | string | Y | 40 | |
+| unas_prpr | 기초자산현재가 | string | Y | 112 | |
+| unas_prdy_vrss | 기초자산전일대비 | string | Y | 112 | |
+| unas_prdy_vrss_sign | 기초자산전일대비부호 | string | Y | 1 | |
+| unas_prdy_ctrt | 기초자산전일대비율 | string | Y | 82 | |
+| unas_acml_vol | 기초자산누적거래량 | string | Y | 18 | |
+| moneyness | MONEYNESS | string | Y | 132 | |
+| atm_cls_name | ATM구분명 | string | Y | 10 | |
+| prit | 패리티 | string | Y | 112 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| gear | 기어링 | string | Y | 84 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| prls_qryr_rate | 손익분기비율 | string | Y | 84 | |
+| cfp | 자본지지점 | string | Y | 112 | |
+| lstn_stcn | 상장주수 | string | Y | 18 | |
+| pblc_co_name | 발행회사명 | string | Y | 40 | |
+| lp_mbcr_name | LP회원사명 | string | Y | 50 | |
+| lp_hldn_rate | LP보유비율 | string | Y | 84 | |
+| elw_rght_form | ELW권리형태 | string | Y | 20 | |
+| elw_ko_barrier | 조기종료발생기준가격 | string | Y | 112 | |
+| apprch_rate | 접근도 | string | Y | 112 | |
+| unas_shrn_iscd | 기초자산단축종목코드 | string | Y | 9 | |
+| mtrt_date | 만기일자 | string | Y | 8 | |
+| prmm_val | 프리미엄값 | string | Y | 114 | |
+| stck_lp_fin_date | 주식LP종료일자 | string | Y | 8 | |
+| tick_conv_prc | 틱환산가 | string | Y | 11 | |
+| prls_qryr_stpr_prc | 손익분기주가가격 | string | Y | 112 | |
+| lp_hvol | LP보유량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:11510
+FID_RANK_SORT_CLS_CODE:0
+FID_INPUT_CNT_1:1
+FID_RANK_SORT_CLS_CODE_2:
+FID_INPUT_CNT_2:
+FID_RANK_SORT_CLS_CODE_3:
+FID_INPUT_CNT_3:
+FID_TRGT_CLS_CODE:
+FID_INPUT_ISCD:
+FID_UNAS_INPUT_ISCD:
+FID_MRKT_CLS_CODE:
+FID_INPUT_DATE_1:
+FID_INPUT_DATE_2:
+FID_INPUT_ISCD_2:
+FID_ETC_CLS_CODE:
+FID_INPUT_RMNN_DYNU_1:
+FID_INPUT_RMNN_DYNU_2:
+FID_PRPR_CNT1:
+FID_PRPR_CNT2:
+FID_RSFL_RATE1:
+FID_RSFL_RATE2:
+FID_VOL1:
+FID_VOL2:
+FID_APLY_RANG_PRC_1:
+FID_APLY_RANG_PRC_2:
+FID_LVRG_VAL1:
+FID_LVRG_VAL2:
+FID_VOL3:
+FID_VOL4:
+FID_INTS_VLTL1:
+FID_INTS_VLTL2:
+FID_PRMM_VAL1:
+FID_PRMM_VAL2:
+FID_GEAR1:
+FID_GEAR2:
+FID_PRLS_QRYR_RATE1:
+FID_PRLS_QRYR_RATE2:
+FID_DELTA1:
+FID_DELTA2:
+FID_ACPR1:
+FID_ACPR2:
+FID_STCK_CNVR_RATE1:
+FID_STCK_CNVR_RATE2:
+FID_DIV_CLS_CODE:
+FID_PRIT1:
+FID_PRIT2:
+FID_CFP1:
+FID_CFP2:
+FID_INPUT_NMIX_PRICE_1:
+FID_INPUT_NMIX_PRICE_2:
+FID_EGEA_VAL1:
+FID_EGEA_VAL2:
+FID_INPUT_DVDN_ERT:
+FID_INPUT_HIST_VLTL:
+FID_THETA1:
+FID_THETA2:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bond_shrn_iscd": "57JAES",
+ "hts_kor_isnm": "한국JAESKOSPI200콜",
+ "rght_type_name": "CALL",
+ "elw_prpr": "1560",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "325.00",
+ "stck_cnvr_rate": "100.000000",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "hts_rmnn_dynu": "1",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "377.90",
+ "unas_prdy_vrss": "6.78",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.83",
+ "unas_acml_vol": "80478000",
+ "moneyness": "16.277",
+ "atm_cls_name": "ITM",
+ "prit": "116.27",
+ "delta_val": "1.000000",
+ "hts_ints_vltl": "0.00",
+ "tmvl_val": "-3751.00",
+ "gear": "24.2200",
+ "lvrg_val": "24.219999",
+ "prls_qryr_rate": "-9.8600",
+ "cfp": "-10.2900",
+ "lstn_stcn": "10000000",
+ "pblc_co_name": "한국투자증권(주)",
+ "lp_mbcr_name": "한국증권",
+ "lp_hldn_rate": "100.00",
+ "elw_rght_form": "표준형",
+ "elw_ko_barrier": "0.00",
+ "apprch_rate": "0.00",
+ "unas_shrn_iscd": "2001",
+ "mtrt_date": "20240617",
+ "prmm_val": "4.13",
+ "stck_lp_fin_date": "20240613",
+ "tick_conv_prc": "5.00",
+ "prls_qryr_stpr_prc": "340.60",
+ "lp_hvol": "9999800"
+ },
+ {
+ "bond_shrn_iscd": "57JAET",
+ "hts_kor_isnm": "한국JAETKOSPI200콜",
+ "rght_type_name": "CALL",
+ "elw_prpr": "4090",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "322.50",
+ "stck_cnvr_rate": "100.000000",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "hts_rmnn_dynu": "1",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "377.90",
+ "unas_prdy_vrss": "6.78",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.83",
+ "unas_acml_vol": "80478000",
+ "moneyness": "17.178",
+ "atm_cls_name": "ITM",
+ "prit": "117.17",
+ "delta_val": "1.000000",
+ "hts_ints_vltl": "0.00",
+ "tmvl_val": "-1471.00",
+ "gear": "9.2300",
+ "lvrg_val": "9.230000",
+ "prls_qryr_rate": "-3.8300",
+ "cfp": "-4.2900",
+ "lstn_stcn": "9000000",
+ "pblc_co_name": "한국투자증권(주)",
+ "lp_mbcr_name": "한국증권",
+ "lp_hldn_rate": "99.99",
+ "elw_rght_form": "표준형",
+ "elw_ko_barrier": "0.00",
+ "apprch_rate": "0.00",
+ "unas_shrn_iscd": "2001",
+ "mtrt_date": "20240617",
+ "prmm_val": "10.82",
+ "stck_lp_fin_date": "20240613",
+ "tick_conv_prc": "5.00",
+ "prls_qryr_stpr_prc": "363.40",
+ "lp_hvol": "8999270"
+ },
+ {
+ "bond_shrn_iscd": "57JAEV",
+ "hts_kor_isnm": "한국JAEVKOSPI200콜",
+ "rght_type_name": "CALL",
+ "elw_prpr": "4510",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "320.00",
+ "stck_cnvr_rate": "100.000000",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "hts_rmnn_dynu": "1",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "377.90",
+ "unas_prdy_vrss": "6.78",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.83",
+ "unas_acml_vol": "80478000",
+ "moneyness": "18.094",
+ "atm_cls_name": "ITM",
+ "prit": "118.09",
+ "delta_val": "0.963518",
+ "hts_ints_vltl": "177.59",
+ "tmvl_val": "-1301.00",
+ "gear": "8.3700",
+ "lvrg_val": "8.064646",
+ "prls_qryr_rate": "-3.3800",
+ "cfp": "-3.8400",
+ "lstn_stcn": "11000000",
+ "pblc_co_name": "한국투자증권(주)",
+ "lp_mbcr_name": "한국증권",
+ "lp_hldn_rate": "99.99",
+ "elw_rght_form": "표준형",
+ "elw_ko_barrier": "0.00",
+ "apprch_rate": "0.00",
+ "unas_shrn_iscd": "2001",
+ "mtrt_date": "20240617",
+ "prmm_val": "11.93",
+ "stck_lp_fin_date": "20240613",
+ "tick_conv_prc": "4.82",
+ "prls_qryr_stpr_prc": "365.10",
+ "lp_hvol": "10999000"
+ },
+ {
+ "bond_shrn_iscd": "57JAEW",
+ "hts_kor_isnm": "한국JAEWKOSPI200콜",
+ "rght_type_name": "CALL",
+ "elw_prpr": "2555",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "317.50",
+ "stck_cnvr_rate": "100.000000",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "hts_rmnn_dynu": "1",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "377.90",
+ "unas_prdy_vrss": "6.78",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.83",
+ "unas_acml_vol": "80478000",
+ "moneyness": "19.024",
+ "atm_cls_name": "ITM",
+ "prit": "119.02",
+ "delta_val": "0.959424",
+ "hts_ints_vltl": "191.44",
+ "tmvl_val": "-3506.00",
+ "gear": "14.7900",
+ "lvrg_val": "14.189881",
+ "prls_qryr_rate": "-9.2100",
+ "cfp": "-9.8800",
+ "lstn_stcn": "9000000",
+ "pblc_co_name": "한국투자증권(주)",
+ "lp_mbcr_name": "한국증권",
+ "lp_hldn_rate": "99.99",
+ "elw_rght_form": "표준형",
+ "elw_ko_barrier": "0.00",
+ "apprch_rate": "0.00",
+ "unas_shrn_iscd": "2001",
+ "mtrt_date": "20240617",
+ "prmm_val": "6.76",
+ "stck_lp_fin_date": "20240613",
+ "tick_conv_prc": "4.80",
+ "prls_qryr_stpr_prc": "343.05",
+ "lp_hvol": "8998900"
+ },
+ {
+ "bond_shrn_iscd": "57JAEX",
+ "hts_kor_isnm": "한국JAEXKOSPI200콜",
+ "rght_type_name": "CALL",
+ "elw_prpr": "4850",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acpr": "315.00",
+ "stck_cnvr_rate": "100.000000",
+ "stck_lstn_date": "20231018",
+ "stck_last_tr_date": "20240613",
+ "hts_rmnn_dynu": "1",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "377.90",
+ "unas_prdy_vrss": "6.78",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.83",
+ "unas_acml_vol": "80478000",
+ "moneyness": "19.968",
+ "atm_cls_name": "ITM",
+ "prit": "119.96",
+ "delta_val": "0.959709",
+ "hts_ints_vltl": "200.01",
+ "tmvl_val": "-1461.00",
+ "gear": "7.7900",
+ "lvrg_val": "7.476133",
+ "prls_qryr_rate": "-3.8000",
+ "cfp": "-4.3600",
+ "lstn_stcn": "10000000",
+ "pblc_co_name": "한국투자증권(주)",
+ "lp_mbcr_name": "한국증권",
+ "lp_hldn_rate": "99.99",
+ "elw_rght_form": "표준형",
+ "elw_ko_barrier": "0.00",
+ "apprch_rate": "0.00",
+ "unas_shrn_iscd": "2001",
+ "mtrt_date": "20240617",
+ "prmm_val": "12.83",
+ "stck_lp_fin_date": "20240613",
+ "tick_conv_prc": "4.80",
+ "prls_qryr_stpr_prc": "363.50",
+ "lp_hvol": "9999400"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/054_국내주식-179_ELW-변동성-추이분별.md b/docs/broker/kis/rest/국내주식/ELW-시세/054_국내주식-179_ELW-변동성-추이분별.md
new file mode 100644
index 0000000..0299dda
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/054_국내주식-179_ELW-변동성-추이분별.md
@@ -0,0 +1,148 @@
+# ELW 변동성 추이(분별)
+
+- 원본 시트명: ELW 변동성 추이(분별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-179
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02840300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/volatility-trend-minute
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 변동성 추이(분별) API입니다.
+한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "분별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02840300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | W(Unique key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+| FID_HOUR_CLS_CODE | 시간구분코드 | string | Y | 5 | '60(1분), 180(3분), 300(5분), 600(10분), 1800(30분), 3600(60분)
' |
+| FID_PW_DATA_INCU_YN | 과거데이터 포함 여부 | string | Y | 2 | N(과거데이터포함X),Y(과거데이터포함O) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 6 | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 10 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| elw_oprc | ELW 시가2 | string | Y | 1 | |
+| elw_hgpr | ELW 최고가 | string | Y | 82 | |
+| elw_lwpr | ELW 최저가 | string | Y | 10 | |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 10 | |
+| hist_vltl | 역사적 변동성 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57JS61
+FID_HOUR_CLS_CODE:60
+FID_PW_DATA_INCU_YN:N
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240422",
+ "stck_cntg_hour": "142800",
+ "stck_prpr": "265",
+ "elw_oprc": "265",
+ "elw_hgpr": "265",
+ "elw_lwpr": "265",
+ "hts_ints_vltl": "21.90",
+ "hist_vltl": ""
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "stck_cntg_hour": "142700",
+ "stck_prpr": "265",
+ "elw_oprc": "270",
+ "elw_hgpr": "270",
+ "elw_lwpr": "260",
+ "hts_ints_vltl": "21.90",
+ "hist_vltl": ""
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "stck_cntg_hour": "142600",
+ "stck_prpr": "275",
+ "elw_oprc": "275",
+ "elw_hgpr": "275",
+ "elw_lwpr": "275",
+ "hts_ints_vltl": "22.06",
+ "hist_vltl": ""
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "stck_cntg_hour": "142500",
+ "stck_prpr": "270",
+ "elw_oprc": "275",
+ "elw_hgpr": "275",
+ "elw_lwpr": "270",
+ "hts_ints_vltl": "22.06",
+ "hist_vltl": ""
+ },
+ ...
+ {
+ "stck_bsop_date": "20240422",
+ "stck_cntg_hour": "124900",
+ "stck_prpr": "275",
+ "elw_oprc": "280",
+ "elw_hgpr": "280",
+ "elw_lwpr": "275",
+ "hts_ints_vltl": "22.24",
+ "hist_vltl": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/055_국내주식-177_ELW-변동성추이체결.md b/docs/broker/kis/rest/국내주식/ELW-시세/055_국내주식-177_ELW-변동성추이체결.md
new file mode 100644
index 0000000..3978342
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/055_국내주식-177_ELW-변동성추이체결.md
@@ -0,0 +1,336 @@
+# ELW 변동성추이(체결)
+
+- 원본 시트명: ELW 변동성추이(체결)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-177
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02840100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/volatility-trend-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 변동성 추이(체결) API입니다.
+한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "시간별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02840100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | W(Unique key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | |
+| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:58J540
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "150121",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "52690",
+ "hts_ints_vltl": "33.05"
+ },
+ {
+ "stck_cntg_hour": "140354",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "0",
+ "acml_vol": "52680",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "140340",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "0",
+ "acml_vol": "47680",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "140334",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "47670",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "140334",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "42690",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "140334",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "42680",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "140334",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "37680",
+ "hts_ints_vltl": "31.96"
+ },
+ {
+ "stck_cntg_hour": "114800",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "37670",
+ "hts_ints_vltl": "33.49"
+ },
+ {
+ "stck_cntg_hour": "114046",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "32670",
+ "hts_ints_vltl": "26.54"
+ },
+ {
+ "stck_cntg_hour": "104344",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "30170",
+ "hts_ints_vltl": "32.33"
+ },
+ {
+ "stck_cntg_hour": "104344",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "27670",
+ "hts_ints_vltl": "32.33"
+ },
+ {
+ "stck_cntg_hour": "102100",
+ "elw_prpr": "55",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "17750",
+ "hts_ints_vltl": "31.27"
+ },
+ {
+ "stck_cntg_hour": "095235",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "17730",
+ "hts_ints_vltl": "27.36"
+ },
+ {
+ "stck_cntg_hour": "095235",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "17720",
+ "hts_ints_vltl": "27.36"
+ },
+ {
+ "stck_cntg_hour": "095235",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "7810",
+ "hts_ints_vltl": "27.36"
+ },
+ {
+ "stck_cntg_hour": "091645",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "7720",
+ "hts_ints_vltl": "25.08"
+ },
+ {
+ "stck_cntg_hour": "091645",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "7630",
+ "hts_ints_vltl": "25.08"
+ },
+ {
+ "stck_cntg_hour": "091502",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "45",
+ "askp": "50",
+ "acml_vol": "7620",
+ "hts_ints_vltl": "27.27"
+ },
+ {
+ "stck_cntg_hour": "091222",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "120",
+ "hts_ints_vltl": "32.07"
+ },
+ {
+ "stck_cntg_hour": "091222",
+ "elw_prpr": "50",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-9.09",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "110",
+ "hts_ints_vltl": "32.07"
+ },
+ {
+ "stck_cntg_hour": "090223",
+ "elw_prpr": "55",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "bidp": "55",
+ "askp": "0",
+ "acml_vol": "100",
+ "hts_ints_vltl": "22.69"
+ },
+ {
+ "stck_cntg_hour": "090223",
+ "elw_prpr": "55",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "bidp": "50",
+ "askp": "55",
+ "acml_vol": "10",
+ "hts_ints_vltl": "22.69"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/056_국내주식-171_ELW-당일급변종목.md b/docs/broker/kis/rest/국내주식/ELW-시세/056_국내주식-171_ELW-당일급변종목.md
new file mode 100644
index 0000000..e03fd72
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/056_국내주식-171_ELW-당일급변종목.md
@@ -0,0 +1,155 @@
+# ELW 당일급변종목
+
+- 원본 시트명: ELW 당일급변종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-171
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02870000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/ranking/quick-change
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 당일급변종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0287] ELW 당일급변종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02870000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key(20287) |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
+| FID_INPUT_ISCD | 발행사 | string | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_MRKT_CLS_CODE | 시장구분코드 | string | Y | 2 | Unique key(A) |
+| FID_INPUT_PRICE_1 | 가격(이상) | string | Y | 12 | |
+| FID_INPUT_PRICE_2 | 가격(이하) | string | Y | 12 | |
+| FID_INPUT_VOL_1 | 거래량(이상) | string | Y | 18 | |
+| FID_INPUT_VOL_2 | 거래량(이하) | string | Y | 18 | |
+| FID_HOUR_CLS_CODE | 시간구분코드 | string | Y | 5 | 1(분), 2(일) |
+| FID_INPUT_HOUR_1 | 입력 일 또는 분 | string | Y | 10 | |
+| FID_INPUT_HOUR_2 | 기준시간(분 선택 시) | string | Y | 10 | |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | '1(가격급등), 2(가격급락), 3(거래량급증)
, 4(매수잔량급증), 5(매도잔량급증)' |
+| FID_BLNG_CLS_CODE | 결재방법 | string | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| askp | 매도호가 | string | Y | 10 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| total_askp_rsqn | 총매도호가잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총매수호가잔량 | string | Y | 12 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| stnd_val | 기준값 | string | Y | 10 | |
+| stnd_val_vrss | 기준값대비 | string | Y | 11 | |
+| stnd_val_ctrt | 기준값대비율 | string | Y | 162 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:20287
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD:00000
+FID_MRKT_CLS_CODE:A
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_HOUR_CLS_CODE:2
+FID_INPUT_HOUR_1:1
+FID_INPUT_HOUR_2:
+FID_RANK_SORT_CLS_CODE:1
+FID_BLNG_CLS_CODE:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "57JAKW",
+ "elw_kor_isnm": "한국JAKWLS일렉콜",
+ "elw_prpr": "460",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "350",
+ "prdy_ctrt": "318.18",
+ "askp": "0",
+ "bidp": "145",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "49060",
+ "acml_vol": "3320",
+ "stnd_val": "110",
+ "stnd_val_vrss": "350",
+ "stnd_val_ctrt": "318.18"
+ },
+ {
+ "elw_shrn_iscd": "58JF27",
+ "elw_kor_isnm": "KBJF27KOSPI200콜",
+ "elw_prpr": "2395",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1745",
+ "prdy_ctrt": "268.46",
+ "askp": "0",
+ "bidp": "15",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "29000",
+ "acml_vol": "100",
+ "stnd_val": "650",
+ "stnd_val_vrss": "1745",
+ "stnd_val_ctrt": "268.46"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/057_국내주식-174_ELW-투자지표추이분별.md b/docs/broker/kis/rest/국내주식/ELW-시세/057_국내주식-174_ELW-투자지표추이분별.md
new file mode 100644
index 0000000..0328cae
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/057_국내주식-174_ELW-투자지표추이분별.md
@@ -0,0 +1,357 @@
+# ELW 투자지표추이(분별)
+
+- 원본 시트명: ELW 투자지표추이(분별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-174
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02740300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/indicator-trend-minute
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 투자지표추이(분별) API입니다.
+한국투자 HTS(eFriend Plus) > [0274] ELW 투자지표추이 화면 데이터의 "분별 비교추이" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02740300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+| FID_HOUR_CLS_CODE | 시간구분코드 | string | Y | 5 | '60(1분), 180(3분), 300(5분), 600(10분), 1800(30분), 3600(60분), 7200(60분)
' |
+| FID_PW_DATA_INCU_YN | 과거데이터 포함 여부 | string | Y | 2 | N(과거데이터포함X),Y(과거데이터포함O) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| elw_oprc | ELW시가2 | string | Y | 10 | |
+| elw_hgpr | ELW최고가 | string | Y | 10 | |
+| elw_lwpr | ELW최저가 | string | Y | 10 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| gear | 기어링 | string | Y | 84 | |
+| prmm_val | 프리미엄값 | string | Y | 114 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| prit | 패리티 | string | Y | 112 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| cntg_vol | 체결거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+FID_HOUR_CLS_CODE:60
+FID_PW_DATA_INCU_YN:Y
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131900",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "-10.8818",
+ "gear": "19.5700",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "102.17",
+ "acml_vol": "827720",
+ "cntg_vol": "55700"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131800",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131700",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131600",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131500",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131400",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131300",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131200",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131100",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "131000",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130900",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130800",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130700",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130600",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130500",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "130400",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ },...
+ {
+ "stck_bsop_date": "20240503",
+ "stck_cntg_hour": "114000",
+ "elw_prpr": "40",
+ "elw_oprc": "40",
+ "elw_hgpr": "40",
+ "elw_lwpr": "40",
+ "lvrg_val": "19.5700",
+ "gear": "33.5300",
+ "prmm_val": "5.1086",
+ "invl_val": "17.00",
+ "prit": "-10.72",
+ "acml_vol": "772020",
+ "cntg_vol": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/058_국내주식-185_ELW-기초자산-목록조회.md b/docs/broker/kis/rest/국내주식/ELW-시세/058_국내주식-185_ELW-기초자산-목록조회.md
new file mode 100644
index 0000000..5c9fd86
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/058_국내주식-185_ELW-기초자산-목록조회.md
@@ -0,0 +1,197 @@
+# ELW 기초자산 목록조회
+
+- 원본 시트명: ELW 기초자산 목록조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-185
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW154100C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/quotations/udrl-asset-list
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 기초자산 목록조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0288] ELW 기초자산별 ELW 시세 화면 의 "왼쪽 기초자산 목록" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW154100C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 11541(Primary key) |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | 0(종목명순), 1(콜발행종목순), 2(풋발행종목순), 3(전일대비 상승율순), 4(전일대비 하락율순), 5(현재가 크기순), 6(종목코드순) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 00000(전체), 00003(한국투자증권), 00017(KB증권), 00005(미래에셋) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| unas_shrn_iscd | 기초자산단축종목코드 | string | Y | 9 | |
+| unas_isnm | 기초자산종목명 | string | Y | 40 | |
+| unas_prpr | 기초자산현재가 | string | Y | 112 | |
+| unas_prdy_vrss | 기초자산전일대비 | string | Y | 112 | |
+| unas_prdy_vrss_sign | 기초자산전일대비부호 | string | Y | 1 | |
+| unas_prdy_ctrt | 기초자산전일대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_SCR_DIV_CODE:11541
+FID_RANK_SORT_CLS_CODE:0
+FID_INPUT_ISCD:00000
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "unas_shrn_iscd": "2001",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "371.33",
+ "unas_prdy_vrss": "0.17",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "0.05"
+ },
+ {
+ "unas_shrn_iscd": "000990",
+ "unas_isnm": "DB하이텍",
+ "unas_prpr": "40850.00",
+ "unas_prdy_vrss": "-300.00",
+ "unas_prdy_vrss_sign": "5",
+ "unas_prdy_ctrt": "-0.73"
+ },
+ {
+ "unas_shrn_iscd": "009540",
+ "unas_isnm": "HD한국조선해양",
+ "unas_prpr": "135400.00",
+ "unas_prdy_vrss": "1100.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "0.82"
+ },
+ {
+ "unas_shrn_iscd": "267260",
+ "unas_isnm": "HD현대일렉트릭",
+ "unas_prpr": "302500.00",
+ "unas_prdy_vrss": "9000.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "3.07"
+ },
+ {
+ "unas_shrn_iscd": "028300",
+ "unas_isnm": "HLB",
+ "unas_prpr": "64700.00",
+ "unas_prdy_vrss": "8500.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "15.12"
+ },
+ {
+ "unas_shrn_iscd": "011200",
+ "unas_isnm": "HMM",
+ "unas_prpr": "18010.00",
+ "unas_prdy_vrss": "460.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "2.62"
+ },
+ {
+ "unas_shrn_iscd": "403870",
+ "unas_isnm": "HPSP",
+ "unas_prpr": "45200.00",
+ "unas_prdy_vrss": "2900.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "6.86"
+ },
+ {
+ "unas_shrn_iscd": "035900",
+ "unas_isnm": "JYP Ent.",
+ "unas_prpr": "58800.00",
+ "unas_prdy_vrss": "-1700.00",
+ "unas_prdy_vrss_sign": "5",
+ "unas_prdy_ctrt": "-2.81"
+ },
+ {
+ "unas_shrn_iscd": "105560",
+ "unas_isnm": "KB금융",
+ "unas_prpr": "77100.00",
+ "unas_prdy_vrss": "800.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.05"
+ },
+ {
+ "unas_shrn_iscd": "3003",
+ "unas_isnm": "KSQ150",
+ "unas_prpr": "1355.15",
+ "unas_prdy_vrss": "0.44",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "0.03"
+ },
+ {
+ "unas_shrn_iscd": "030200",
+ "unas_isnm": "KT",
+ "unas_prpr": "36150.00",
+ "unas_prdy_vrss": "-450.00",
+ "unas_prdy_vrss_sign": "5",
+ "unas_prdy_ctrt": "-1.23"
+ },
+ {
+ "unas_shrn_iscd": "033780",
+ "unas_isnm": "KT&G",
+ "unas_prpr": "86100.00",
+ "unas_prdy_vrss": "-100.00",
+ "unas_prdy_vrss_sign": "5",
+ "unas_prdy_ctrt": "-0.12"
+ },
+ {
+ "unas_shrn_iscd": "003550",
+ "unas_isnm": "LG",
+ "unas_prpr": "81400.00",
+ "unas_prdy_vrss": "1500.00",
+ "unas_prdy_vrss_sign": "2",
+ "unas_prdy_ctrt": "1.88"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/059_국내주식-178_ELW-변동성-추이일별.md b/docs/broker/kis/rest/국내주식/ELW-시세/059_국내주식-178_ELW-변동성-추이일별.md
new file mode 100644
index 0000000..1cc0eeb
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/059_국내주식-178_ELW-변동성-추이일별.md
@@ -0,0 +1,508 @@
+# ELW 변동성 추이(일별)
+
+- 원본 시트명: ELW 변동성 추이(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-178
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02840200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/volatility-trend-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 변동성 추이(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "일별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02840200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| elw_prpr | ELW 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 8 | |
+| elw_oprc | elw 시가2 | string | Y | 10 | |
+| elw_hgpr | elw 최고가 | string | Y | 10 | |
+| elw_lwpr | elw 최저가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| d10_hist_vltl | 10일 역사적 변동성 | string | Y | 11 | |
+| d20_hist_vltl | 20일 역사적 변동성 | string | Y | 11 | |
+| d30_hist_vltl | 30일 역사적 변동성 | string | Y | 11 | |
+| d60_hist_vltl | 60일 역사적 변동성 | string | Y | 11 | |
+| d90_hist_vltl | 90일 역사적 변동성 | string | Y | 11 | |
+| hts_ints_vltl | HTS 내재 변동성 | string | Y | 11 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57JS61
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240503",
+ "elw_prpr": "5",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "elw_oprc": "5",
+ "elw_hgpr": "5",
+ "elw_lwpr": "5",
+ "acml_vol": "76410",
+ "d10_hist_vltl": "21.05",
+ "d20_hist_vltl": "20.32",
+ "d30_hist_vltl": "19.58",
+ "d60_hist_vltl": "17.91",
+ "d90_hist_vltl": "18.33",
+ "hts_ints_vltl": "23.37"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "elw_prpr": "5",
+ "prdy_vrss": "-15",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-75.00",
+ "elw_oprc": "20",
+ "elw_hgpr": "20",
+ "elw_lwpr": "5",
+ "acml_vol": "6509850",
+ "d10_hist_vltl": "23.00",
+ "d20_hist_vltl": "21.31",
+ "d30_hist_vltl": "20.17",
+ "d60_hist_vltl": "19.07",
+ "d90_hist_vltl": "18.33",
+ "hts_ints_vltl": "20.16"
+ },
+ {
+ "stck_bsop_date": "20240430",
+ "elw_prpr": "20",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-20.00",
+ "elw_oprc": "25",
+ "elw_hgpr": "25",
+ "elw_lwpr": "15",
+ "acml_vol": "1839420",
+ "d10_hist_vltl": "23.69",
+ "d20_hist_vltl": "21.39",
+ "d30_hist_vltl": "20.42",
+ "d60_hist_vltl": "19.43",
+ "d90_hist_vltl": "18.33",
+ "hts_ints_vltl": "23.45"
+ },
+ {
+ "stck_bsop_date": "20240429",
+ "elw_prpr": "25",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-61.54",
+ "elw_oprc": "35",
+ "elw_hgpr": "40",
+ "elw_lwpr": "25",
+ "acml_vol": "3301030",
+ "d10_hist_vltl": "26.85",
+ "d20_hist_vltl": "21.38",
+ "d30_hist_vltl": "20.48",
+ "d60_hist_vltl": "19.44",
+ "d90_hist_vltl": "18.37",
+ "hts_ints_vltl": "21.85"
+ },
+ {
+ "stck_bsop_date": "20240426",
+ "elw_prpr": "65",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-51.85",
+ "elw_oprc": "65",
+ "elw_hgpr": "95",
+ "elw_lwpr": "50",
+ "acml_vol": "11476800",
+ "d10_hist_vltl": "26.51",
+ "d20_hist_vltl": "21.14",
+ "d30_hist_vltl": "21.13",
+ "d60_hist_vltl": "19.34",
+ "d90_hist_vltl": "18.45",
+ "hts_ints_vltl": "22.04"
+ },
+ {
+ "stck_bsop_date": "20240425",
+ "elw_prpr": "135",
+ "prdy_vrss": "80",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "145.45",
+ "elw_oprc": "100",
+ "elw_hgpr": "135",
+ "elw_lwpr": "85",
+ "acml_vol": "16588080",
+ "d10_hist_vltl": "26.14",
+ "d20_hist_vltl": "20.66",
+ "d30_hist_vltl": "21.01",
+ "d60_hist_vltl": "19.30",
+ "d90_hist_vltl": "18.39",
+ "hts_ints_vltl": "21.20"
+ },
+ {
+ "stck_bsop_date": "20240424",
+ "elw_prpr": "55",
+ "prdy_vrss": "-115",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-67.65",
+ "elw_oprc": "75",
+ "elw_hgpr": "75",
+ "elw_lwpr": "50",
+ "acml_vol": "8909400",
+ "d10_hist_vltl": "23.99",
+ "d20_hist_vltl": "19.38",
+ "d30_hist_vltl": "20.25",
+ "d60_hist_vltl": "18.86",
+ "d90_hist_vltl": "18.11",
+ "hts_ints_vltl": "20.73"
+ },
+ {
+ "stck_bsop_date": "20240423",
+ "elw_prpr": "170",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-10.53",
+ "elw_oprc": "180",
+ "elw_hgpr": "200",
+ "elw_lwpr": "145",
+ "acml_vol": "44577440",
+ "d10_hist_vltl": "21.44",
+ "d20_hist_vltl": "18.18",
+ "d30_hist_vltl": "19.40",
+ "d60_hist_vltl": "18.35",
+ "d90_hist_vltl": "17.77",
+ "hts_ints_vltl": "20.33"
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "elw_prpr": "190",
+ "prdy_vrss": "-210",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-52.50",
+ "elw_oprc": "265",
+ "elw_hgpr": "305",
+ "elw_lwpr": "190",
+ "acml_vol": "79163330",
+ "d10_hist_vltl": "21.44",
+ "d20_hist_vltl": "18.25",
+ "d30_hist_vltl": "19.58",
+ "d60_hist_vltl": "18.37",
+ "d90_hist_vltl": "17.88",
+ "hts_ints_vltl": "21.25"
+ },
+ {
+ "stck_bsop_date": "20240419",
+ "elw_prpr": "400",
+ "prdy_vrss": "215",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "116.22",
+ "elw_oprc": "290",
+ "elw_hgpr": "725",
+ "elw_lwpr": "285",
+ "acml_vol": "63410060",
+ "d10_hist_vltl": "21.22",
+ "d20_hist_vltl": "17.73",
+ "d30_hist_vltl": "19.66",
+ "d60_hist_vltl": "18.26",
+ "d90_hist_vltl": "17.76",
+ "hts_ints_vltl": "24.18"
+ },
+ {
+ "stck_bsop_date": "20240418",
+ "elw_prpr": "185",
+ "prdy_vrss": "-165",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-47.14",
+ "elw_oprc": "295",
+ "elw_hgpr": "325",
+ "elw_lwpr": "180",
+ "acml_vol": "35347180",
+ "d10_hist_vltl": "20.69",
+ "d20_hist_vltl": "19.36",
+ "d30_hist_vltl": "18.92",
+ "d60_hist_vltl": "17.87",
+ "d90_hist_vltl": "17.50",
+ "hts_ints_vltl": "21.30"
+ },
+ {
+ "stck_bsop_date": "20240417",
+ "elw_prpr": "350",
+ "prdy_vrss": "80",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "29.63",
+ "elw_oprc": "235",
+ "elw_hgpr": "350",
+ "elw_lwpr": "215",
+ "acml_vol": "68687230",
+ "d10_hist_vltl": "20.70",
+ "d20_hist_vltl": "19.25",
+ "d30_hist_vltl": "18.23",
+ "d60_hist_vltl": "17.87",
+ "d90_hist_vltl": "17.33",
+ "hts_ints_vltl": "21.02"
+ },
+ {
+ "stck_bsop_date": "20240416",
+ "elw_prpr": "270",
+ "prdy_vrss": "170",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "170.00",
+ "elw_oprc": "180",
+ "elw_hgpr": "320",
+ "elw_lwpr": "165",
+ "acml_vol": "45554270",
+ "d10_hist_vltl": "20.10",
+ "d20_hist_vltl": "19.26",
+ "d30_hist_vltl": "18.17",
+ "d60_hist_vltl": "17.74",
+ "d90_hist_vltl": "17.24",
+ "hts_ints_vltl": "21.23"
+ },
+ {
+ "stck_bsop_date": "20240415",
+ "elw_prpr": "100",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "elw_oprc": "140",
+ "elw_hgpr": "195",
+ "elw_lwpr": "100",
+ "acml_vol": "16103560",
+ "d10_hist_vltl": "15.63",
+ "d20_hist_vltl": "17.28",
+ "d30_hist_vltl": "17.35",
+ "d60_hist_vltl": "17.87",
+ "d90_hist_vltl": "16.86",
+ "hts_ints_vltl": "19.64"
+ },
+ {
+ "stck_bsop_date": "20240412",
+ "elw_prpr": "100",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.76",
+ "elw_oprc": "85",
+ "elw_hgpr": "120",
+ "elw_lwpr": "80",
+ "acml_vol": "5222010",
+ "d10_hist_vltl": "15.51",
+ "d20_hist_vltl": "18.67",
+ "d30_hist_vltl": "17.31",
+ "d60_hist_vltl": "18.05",
+ "d90_hist_vltl": "16.86",
+ "hts_ints_vltl": "20.27"
+ },
+ {
+ "stck_bsop_date": "20240411",
+ "elw_prpr": "105",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.00",
+ "elw_oprc": "125",
+ "elw_hgpr": "160",
+ "elw_lwpr": "90",
+ "acml_vol": "2031830",
+ "d10_hist_vltl": "14.74",
+ "d20_hist_vltl": "18.70",
+ "d30_hist_vltl": "17.41",
+ "d60_hist_vltl": "17.96",
+ "d90_hist_vltl": "16.79",
+ "hts_ints_vltl": "22.02"
+ },
+ {
+ "stck_bsop_date": "20240409",
+ "elw_prpr": "100",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.11",
+ "elw_oprc": "65",
+ "elw_hgpr": "100",
+ "elw_lwpr": "60",
+ "acml_vol": "999560",
+ "d10_hist_vltl": "14.75",
+ "d20_hist_vltl": "18.80",
+ "d30_hist_vltl": "17.56",
+ "d60_hist_vltl": "18.00",
+ "d90_hist_vltl": "16.90",
+ "hts_ints_vltl": "20.93"
+ },
+ {
+ "stck_bsop_date": "20240408",
+ "elw_prpr": "90",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "elw_oprc": "95",
+ "elw_hgpr": "95",
+ "elw_lwpr": "75",
+ "acml_vol": "159080",
+ "d10_hist_vltl": "15.41",
+ "d20_hist_vltl": "18.88",
+ "d30_hist_vltl": "17.65",
+ "d60_hist_vltl": "17.96",
+ "d90_hist_vltl": "16.87",
+ "hts_ints_vltl": "21.04"
+ },
+ {
+ "stck_bsop_date": "20240405",
+ "elw_prpr": "110",
+ "prdy_vrss": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "57.14",
+ "elw_oprc": "95",
+ "elw_hgpr": "115",
+ "elw_lwpr": "80",
+ "acml_vol": "562130",
+ "d10_hist_vltl": "15.60",
+ "d20_hist_vltl": "19.16",
+ "d30_hist_vltl": "17.65",
+ "d60_hist_vltl": "18.05",
+ "d90_hist_vltl": "16.93",
+ "hts_ints_vltl": "21.19"
+ },
+ {
+ "stck_bsop_date": "20240404",
+ "elw_prpr": "70",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-30.00",
+ "elw_oprc": "70",
+ "elw_hgpr": "70",
+ "elw_lwpr": "60",
+ "acml_vol": "1086750",
+ "d10_hist_vltl": "14.58",
+ "d20_hist_vltl": "19.40",
+ "d30_hist_vltl": "17.41",
+ "d60_hist_vltl": "17.94",
+ "d90_hist_vltl": "16.83",
+ "hts_ints_vltl": "20.35"
+ },
+ {
+ "stck_bsop_date": "20240403",
+ "elw_prpr": "100",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "elw_oprc": "75",
+ "elw_hgpr": "100",
+ "elw_lwpr": "75",
+ "acml_vol": "305570",
+ "d10_hist_vltl": "19.05",
+ "d20_hist_vltl": "18.53",
+ "d30_hist_vltl": "16.79",
+ "d60_hist_vltl": "17.67",
+ "d90_hist_vltl": "16.62",
+ "hts_ints_vltl": "18.85"
+ },
+ {
+ "stck_bsop_date": "20240402",
+ "elw_prpr": "100",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "42.86",
+ "elw_oprc": "65",
+ "elw_hgpr": "100",
+ "elw_lwpr": "55",
+ "acml_vol": "1056250",
+ "d10_hist_vltl": "18.75",
+ "d20_hist_vltl": "17.42",
+ "d30_hist_vltl": "16.29",
+ "d60_hist_vltl": "17.29",
+ "d90_hist_vltl": "16.39",
+ "hts_ints_vltl": "21.66"
+ },
+ {
+ "stck_bsop_date": "20240401",
+ "elw_prpr": "70",
+ "prdy_vrss": "-15",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-17.65",
+ "elw_oprc": "60",
+ "elw_hgpr": "120",
+ "elw_lwpr": "60",
+ "acml_vol": "839440",
+ "d10_hist_vltl": "19.44",
+ "d20_hist_vltl": "17.67",
+ "d30_hist_vltl": "16.80",
+ "d60_hist_vltl": "17.35",
+ "d90_hist_vltl": "16.40",
+ "hts_ints_vltl": "18.57"
+ },...
+ {
+ "stck_bsop_date": "20231206",
+ "elw_prpr": "1775",
+ "prdy_vrss": "65",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.80",
+ "elw_oprc": "1775",
+ "elw_hgpr": "1775",
+ "elw_lwpr": "1775",
+ "acml_vol": "20",
+ "d10_hist_vltl": "11.54",
+ "d20_hist_vltl": "12.91",
+ "d30_hist_vltl": "22.19",
+ "d60_hist_vltl": "19.42",
+ "d90_hist_vltl": "0.00",
+ "hts_ints_vltl": "10.60"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/060_국내주식-168_ELW-거래량순위.md b/docs/broker/kis/rest/국내주식/ELW-시세/060_국내주식-168_ELW-거래량순위.md
new file mode 100644
index 0000000..7919a30
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/060_국내주식-168_ELW-거래량순위.md
@@ -0,0 +1,285 @@
+# ELW 거래량순위
+
+- 원본 시트명: ELW 거래량순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-168
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02780000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/ranking/volume-rank
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 거래량순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0278] ELW 거래량순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02780000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | W |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 20278 |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | 000000 |
+| FID_INPUT_ISCD | 발행사 | string | Y | 12 | 00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_INPUT_RMNN_DYNU_1 | 입력잔존일수 | string | Y | 5 | |
+| FID_DIV_CLS_CODE | 콜풋구분코드 | string | Y | 2 | 0(전체), 1(콜), 2(풋) |
+| FID_INPUT_PRICE_1 | 가격(이상) | string | Y | 12 | 거래가격1(이상) |
+| FID_INPUT_PRICE_2 | 가격(이하) | string | Y | 12 | 거래가격1(이하) |
+| FID_INPUT_VOL_1 | 거래량(이상) | string | Y | 18 | 거래량1(이상) |
+| FID_INPUT_VOL_2 | 거래량(이하) | string | Y | 18 | 거래량1(이하) |
+| FID_INPUT_DATE_1 | 조회기준일 | string | Y | 10 | 입력날짜(기준가 조회기준) |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | 0: 거래량순 1: 평균거래증가율 2: 평균거래회전율 3:거래금액순 4: 순매수잔량순 5: 순매도잔량순 |
+| FID_BLNG_CLS_CODE | 소속구분코드 | string | Y | 2 | 0: 전체 |
+| FID_INPUT_ISCD_2 | LP발행사 | string | Y | 8 | 0000 |
+| FID_INPUT_DATE_2 | 만기일-최종거래일조회 | string | Y | 10 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| lstn_stcn | 상장주수 | string | Y | 18 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| n_prdy_vol | N전일거래량 | string | Y | 18 | |
+| n_prdy_vol_vrss | N전일거래량대비 | string | Y | 18 | |
+| vol_inrt | 거래량증가율 | string | Y | 84 | |
+| vol_tnrt | 거래량회전율 | string | Y | 82 | |
+| nday_vol_tnrt | N일거래량회전율 | string | Y | 8 | |
+| acml_tr_pbmn | 누적거래대금 | string | Y | 18 | |
+| n_prdy_tr_pbmn | N전일거래대금 | string | Y | 18 | |
+| n_prdy_tr_pbmn_vrss | N전일거래대금대비 | string | Y | 18 | |
+| total_askp_rsqn | 총매도호가잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총매수호가잔량 | string | Y | 12 | |
+| ntsl_rsqn | 순매도잔량 | string | Y | 13 | |
+| ntby_rsqn | 순매수잔량 | string | Y | 12 | |
+| seln_rsqn_rate | 매도잔량비율 | string | Y | 84 | |
+| shnu_rsqn_rate | 매수2잔량비율 | string | Y | 84 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| hts_rmnn_dynu | HTS잔존일수 | string | Y | 5 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| acpr | 행사가 | string | Y | 112 | |
+| lp_mbcr_name | LP회원사명 | string | Y | 50 | |
+| unas_isnm | 기초자산명 | string | Y | 40 | |
+| stck_last_tr_date | 최종거래일 | string | Y | 8 | |
+| unas_shrn_iscd | 기초자산코드 | string | Y | 12 | |
+| prdy_vol | 전일거래량 | string | Y | 18 | |
+| lp_hldn_rate | LP보유비율 | string | Y | 84 | |
+| prit | 패리티 | string | Y | 112 | |
+| prls_qryr_stpr_prc | 손익분기주가가격 | string | Y | 112 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| theta | 세타 | string | Y | 84 | |
+| prls_qryr_rate | 손익분기비율 | string | Y | 84 | |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| lp_ntby_qty | LP순매도량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:20278
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD:00000
+FID_INPUT_RMNN_DYNU_1:0
+FID_DIV_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_INPUT_DATE_1:
+FID_RANK_SORT_CLS_CODE:0
+FID_BLNG_CLS_CODE:0
+FID_INPUT_ISCD_2:0000
+FID_INPUT_DATE_2:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_kor_isnm": "한국JS54KOSPI200콜",
+ "elw_shrn_iscd": "57JS54",
+ "elw_prpr": "135",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-42.55",
+ "lstn_stcn": "10000000",
+ "acml_vol": "44020240",
+ "n_prdy_vol": "0",
+ "n_prdy_vol_vrss": "44020240",
+ "vol_inrt": "0.00",
+ "vol_tnrt": "440.20",
+ "nday_vol_tnrt": "440.20",
+ "acml_tr_pbmn": "7881452400",
+ "n_prdy_tr_pbmn": "7881452400",
+ "n_prdy_tr_pbmn_vrss": "0",
+ "total_askp_rsqn": "1512690",
+ "total_bidp_rsqn": "337490",
+ "ntsl_rsqn": "-1175200",
+ "ntby_rsqn": "-1175200",
+ "seln_rsqn_rate": "81.76",
+ "shnu_rsqn_rate": "18.24",
+ "stck_cnvr_rate": "100.000000",
+ "hts_rmnn_dynu": "28",
+ "invl_val": "0.00",
+ "tmvl_val": "135.00",
+ "acpr": "385.00",
+ "lp_mbcr_name": "한국증권",
+ "unas_isnm": "KOSPI200",
+ "stck_last_tr_date": "20240509",
+ "unas_shrn_iscd": "2001",
+ "prdy_vol": "9013220",
+ "lp_hldn_rate": "11.21",
+ "prit": "95.38",
+ "prls_qryr_stpr_prc": "386.35",
+ "delta_val": "0.160726",
+ "theta": "12.4577",
+ "prls_qryr_rate": "5.2000",
+ "stck_lstn_date": "20230817",
+ "hts_ints_vltl": "16.98",
+ "lvrg_val": "43.722294",
+ "lp_ntby_qty": "5919560"
+ },
+ {
+ "elw_kor_isnm": "한국JS57KOSPI200풋",
+ "elw_shrn_iscd": "57JS57",
+ "elw_prpr": "250",
+ "prdy_vrss": "15",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.38",
+ "lstn_stcn": "10000000",
+ "acml_vol": "41360790",
+ "n_prdy_vol": "0",
+ "n_prdy_vol_vrss": "41360790",
+ "vol_inrt": "0.00",
+ "vol_tnrt": "413.61",
+ "nday_vol_tnrt": "413.61",
+ "acml_tr_pbmn": "9642006500",
+ "n_prdy_tr_pbmn": "9642006500",
+ "n_prdy_tr_pbmn_vrss": "0",
+ "total_askp_rsqn": "591950",
+ "total_bidp_rsqn": "320140",
+ "ntsl_rsqn": "-271810",
+ "ntby_rsqn": "-271810",
+ "seln_rsqn_rate": "64.90",
+ "shnu_rsqn_rate": "35.10",
+ "stck_cnvr_rate": "100.000000",
+ "hts_rmnn_dynu": "28",
+ "invl_val": "0.00",
+ "tmvl_val": "250.00",
+ "acpr": "355.00",
+ "lp_mbcr_name": "한국증권",
+ "unas_isnm": "KOSPI200",
+ "stck_last_tr_date": "20240509",
+ "unas_shrn_iscd": "2001",
+ "prdy_vol": "3829210",
+ "lp_hldn_rate": "38.24",
+ "prit": "96.66",
+ "prls_qryr_stpr_prc": "352.50",
+ "delta_val": "-0.227848",
+ "theta": "15.2298",
+ "prls_qryr_rate": "-4.0100",
+ "stck_lstn_date": "20230817",
+ "hts_ints_vltl": "19.27",
+ "lvrg_val": "-33.470867",
+ "lp_ntby_qty": "3929370"
+ },
+ {
+ "elw_kor_isnm": "한국JS59KOSPI200풋",
+ "elw_shrn_iscd": "57JS59",
+ "elw_prpr": "165",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.12",
+ "lstn_stcn": "11000000",
+ "acml_vol": "34510630",
+ "n_prdy_vol": "0",
+ "n_prdy_vol_vrss": "34510630",
+ "vol_inrt": "0.00",
+ "vol_tnrt": "313.73",
+ "nday_vol_tnrt": "313.73",
+ "acml_tr_pbmn": "5293873100",
+ "n_prdy_tr_pbmn": "5293873100",
+ "n_prdy_tr_pbmn_vrss": "0",
+ "total_askp_rsqn": "348740",
+ "total_bidp_rsqn": "639850",
+ "ntsl_rsqn": "291110",
+ "ntby_rsqn": "291110",
+ "seln_rsqn_rate": "35.28",
+ "shnu_rsqn_rate": "64.72",
+ "stck_cnvr_rate": "100.000000",
+ "hts_rmnn_dynu": "28",
+ "invl_val": "0.00",
+ "tmvl_val": "165.00",
+ "acpr": "350.00",
+ "lp_mbcr_name": "한국증권",
+ "unas_isnm": "KOSPI200",
+ "stck_last_tr_date": "20240509",
+ "unas_shrn_iscd": "2001",
+ "prdy_vol": "7133790",
+ "lp_hldn_rate": "37.29",
+ "prit": "95.30",
+ "prls_qryr_stpr_prc": "348.35",
+ "delta_val": "-0.160062",
+ "theta": "12.8688",
+ "prls_qryr_rate": "-5.1400",
+ "stck_lstn_date": "20230817",
+ "hts_ints_vltl": "19.97",
+ "lvrg_val": "-35.625000",
+ "lp_ntby_qty": "3185360"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/061_국내주식-169_ELW-지표순위.md b/docs/broker/kis/rest/국내주식/ELW-시세/061_국내주식-169_ELW-지표순위.md
new file mode 100644
index 0000000..6ba711c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/061_국내주식-169_ELW-지표순위.md
@@ -0,0 +1,191 @@
+# ELW 지표순위
+
+- 원본 시트명: ELW 지표순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-169
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02790000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/ranking/indicator
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 지표순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0279] ELW 지표순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02790000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key(20279) |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
+| FID_INPUT_ISCD | 발행사 | string | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_DIV_CLS_CODE | 콜풋구분코드 | string | Y | 2 | 0(전체), 1(콜), 2(풋) |
+| FID_INPUT_PRICE_1 | 가격(이상) | string | Y | 12 | |
+| FID_INPUT_PRICE_2 | 가격(이하) | string | Y | 12 | |
+| FID_INPUT_VOL_1 | 거래량(이상) | string | Y | 18 | |
+| FID_INPUT_VOL_2 | 거래량(이하) | string | Y | 18 | |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | 0(전환비율), 1(레버리지), 2(행사가 ), 3(내재가치), 4(시간가치) |
+| FID_BLNG_CLS_CODE | 결재방법 | string | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| acpr | 행사가 | string | Y | 112 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| elw_ko_barrier | 조기종료발생기준가격 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:20279
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD:00000
+FID_DIV_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_RANK_SORT_CLS_CODE:0
+FID_BLNG_CLS_CODE:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "52JW82",
+ "elw_kor_isnm": "미래JW82KOSPI200콜",
+ "elw_prpr": "360",
+ "prdy_vrss": "-170",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-32.08",
+ "acml_vol": "726070",
+ "stck_cnvr_rate": "100.000000",
+ "lvrg_val": "35.047882",
+ "acpr": "375.00",
+ "tmvl_val": "360.00",
+ "invl_val": "0.00",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "elw_shrn_iscd": "52JW83",
+ "elw_kor_isnm": "미래JW83KOSPI200콜",
+ "elw_prpr": "450",
+ "prdy_vrss": "180",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "66.67",
+ "acml_vol": "194290",
+ "stck_cnvr_rate": "100.000000",
+ "lvrg_val": "32.774658",
+ "acpr": "372.50",
+ "tmvl_val": "450.00",
+ "invl_val": "0.00",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "elw_shrn_iscd": "52JW84",
+ "elw_kor_isnm": "미래JW84KOSPI200콜",
+ "elw_prpr": "565",
+ "prdy_vrss": "215",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "61.43",
+ "acml_vol": "41160",
+ "stck_cnvr_rate": "100.000000",
+ "lvrg_val": "30.090385",
+ "acpr": "370.00",
+ "tmvl_val": "565.00",
+ "invl_val": "0.00",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "elw_shrn_iscd": "52JW85",
+ "elw_kor_isnm": "미래JW85KOSPI200콜",
+ "elw_prpr": "640",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "stck_cnvr_rate": "100.000000",
+ "lvrg_val": "30.062588",
+ "acpr": "367.50",
+ "tmvl_val": "640.00",
+ "invl_val": "0.00",
+ "elw_ko_barrier": "0.00"
+ },
+ {
+ "elw_shrn_iscd": "52JW86",
+ "elw_kor_isnm": "미래JW86KOSPI200콜",
+ "elw_prpr": "450",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "stck_cnvr_rate": "100.000000",
+ "lvrg_val": "55.580410",
+ "acpr": "365.00",
+ "tmvl_val": "228.00",
+ "invl_val": "222.00",
+ "elw_ko_barrier": "0.00"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/062_국내주식-172_ELW-투자지표추이체결.md b/docs/broker/kis/rest/국내주식/ELW-시세/062_국내주식-172_ELW-투자지표추이체결.md
new file mode 100644
index 0000000..3e3c5b8
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/062_국내주식-172_ELW-투자지표추이체결.md
@@ -0,0 +1,685 @@
+# ELW 투자지표추이(체결)
+
+- 원본 시트명: ELW 투자지표추이(체결)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-172
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02740100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/indicator-trend-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 투자지표추이(체결) API입니다.
+한국투자 HTS(eFriend Plus) > [0274] ELW 투자지표추이 화면에서 "시간별 비교추이" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02740100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| gear | 기어링 | string | Y | 84 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| prit | 패리티 | string | Y | 112 | |
+| apprch_rate | 접근도 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "125151",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "827720",
+ "lvrg_val": "-10.8818",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "113228",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "772020",
+ "lvrg_val": "-10.7220",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "112254",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "762920",
+ "lvrg_val": "-10.7587",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "112254",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "753820",
+ "lvrg_val": "-10.7587",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "112028",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "707220",
+ "lvrg_val": "-10.6040",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "112028",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "692220",
+ "lvrg_val": "-10.6040",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "111947",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "651530",
+ "lvrg_val": "-10.6040",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "105955",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "599740",
+ "lvrg_val": "-10.7413",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "105955",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "559050",
+ "lvrg_val": "-10.7413",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100603",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "544050",
+ "lvrg_val": "-10.6177",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100541",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "544040",
+ "lvrg_val": "-10.6177",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100540",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "532200",
+ "lvrg_val": "-10.6177",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100540",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "531340",
+ "lvrg_val": "-10.6177",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100507",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "529040",
+ "lvrg_val": "-10.6015",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100407",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "514900",
+ "lvrg_val": "-10.7188",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "100347",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "473340",
+ "lvrg_val": "-10.7188",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "095709",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "472140",
+ "lvrg_val": "-10.7387",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "095709",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "471730",
+ "lvrg_val": "-10.7387",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "095709",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "431030",
+ "lvrg_val": "-10.7387",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094251",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "416030",
+ "lvrg_val": "-10.7455",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094209",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "414380",
+ "lvrg_val": "-10.7290",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094209",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "399380",
+ "lvrg_val": "-10.7290",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094134",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "358680",
+ "lvrg_val": "-10.6168",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094134",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "317980",
+ "lvrg_val": "-10.6168",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "094021",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "302980",
+ "lvrg_val": "-10.6006",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "092950",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "287980",
+ "lvrg_val": "-10.8278",
+ "gear": "19.5500",
+ "tmvl_val": "22.00",
+ "invl_val": "18.00",
+ "prit": "102.3000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "092945",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "287960",
+ "lvrg_val": "-10.8278",
+ "gear": "19.5500",
+ "tmvl_val": "22.00",
+ "invl_val": "18.00",
+ "prit": "102.3000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091933",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "287950",
+ "lvrg_val": "-10.8896",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091930",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "232250",
+ "lvrg_val": "-10.8896",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091653",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "217250",
+ "lvrg_val": "-10.7536",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091652",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "176550",
+ "lvrg_val": "-10.7536",
+ "gear": "19.6000",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091434",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "161550",
+ "lvrg_val": "-10.5888",
+ "gear": "19.5500",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.3000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091432",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "160650",
+ "lvrg_val": "-10.5888",
+ "gear": "19.5500",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.3000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091314",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "145650",
+ "lvrg_val": "-10.7370",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091312",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "130650",
+ "lvrg_val": "-10.7370",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "091006",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "128890",
+ "lvrg_val": "-12.0998",
+ "gear": "22.3400",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.3000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090814",
+ "elw_prpr": "35",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-10",
+ "prdy_ctrt": "-22.22",
+ "acml_vol": "108910",
+ "lvrg_val": "-10.5019",
+ "gear": "19.6000",
+ "tmvl_val": "19.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090800",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "108900",
+ "lvrg_val": "-10.4962",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090758",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "55720",
+ "lvrg_val": "-10.4962",
+ "gear": "19.6000",
+ "tmvl_val": "24.00",
+ "invl_val": "16.00",
+ "prit": "102.0400",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090729",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "55710",
+ "lvrg_val": "-10.4801",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090710",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "20010",
+ "lvrg_val": "-10.4801",
+ "gear": "19.5700",
+ "tmvl_val": "23.00",
+ "invl_val": "17.00",
+ "prit": "102.1700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_cntg_hour": "090504",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-11.11",
+ "acml_vol": "10",
+ "lvrg_val": "-9.2509",
+ "gear": "17.4600",
+ "tmvl_val": "25.00",
+ "invl_val": "15.00",
+ "prit": "101.7800",
+ "apprch_rate": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/063_국내주식-167_ELW-상승률순위.md b/docs/broker/kis/rest/국내주식/ELW-시세/063_국내주식-167_ELW-상승률순위.md
new file mode 100644
index 0000000..256c671
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/063_국내주식-167_ELW-상승률순위.md
@@ -0,0 +1,218 @@
+# ELW 상승률순위
+
+- 원본 시트명: ELW 상승률순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-167
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02770000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/elw/v1/ranking/updown-rate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 상승률순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0277] ELW 상승률순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02770000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 사용자권한정보 | string | Y | 2 | 시장구분코드 (W) |
+| FID_COND_SCR_DIV_CODE | 거래소코드 | string | Y | 5 | Unique key(20277) |
+| FID_UNAS_INPUT_ISCD | 상승율/하락율 구분 | string | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
+| FID_INPUT_ISCD | N일자값 | string | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
+| FID_INPUT_RMNN_DYNU_1 | 거래량조건 | string | Y | 5 | '0(전체), 1(1개월이하), 2(1개월~2개월),
3(2개월~3개월), 4(3개월~6개월),
5(6개월~9개월),6(9개월~12개월), 7(12개월이상)' |
+| FID_DIV_CLS_CODE | NEXT KEY BUFF | string | Y | 2 | 0(전체), 1(콜), 2(풋) |
+| FID_INPUT_PRICE_1 | 사용자권한정보 | string | Y | 12 | |
+| FID_INPUT_PRICE_2 | 거래소코드 | string | Y | 12 | |
+| FID_INPUT_VOL_1 | 상승율/하락율 구분 | string | Y | 18 | |
+| FID_INPUT_VOL_2 | N일자값 | string | Y | 18 | |
+| FID_INPUT_DATE_1 | 거래량조건 | string | Y | 10 | |
+| FID_RANK_SORT_CLS_CODE | NEXT KEY BUFF | string | Y | 2 | '0(상승율), 1(하락율), 2(시가대비상승율)
, 3(시가대비하락율), 4(변동율)' |
+| FID_BLNG_CLS_CODE | 사용자권한정보 | string | Y | 2 | 0(전체) |
+| FID_INPUT_DATE_2 | 거래소코드 | string | Y | 10 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| stck_sdpr | 주식기준가 | string | Y | 10 | |
+| sdpr_vrss_prpr_sign | 기준가대비현재가부호 | string | Y | 1 | |
+| sdpr_vrss_prpr | 기준가대비현재가 | string | Y | 10 | |
+| sdpr_vrss_prpr_rate | 기준가대비현재가비율 | string | Y | 84 | |
+| stck_oprc | 주식시가2 | string | Y | 10 | |
+| oprc_vrss_prpr_sign | 시가2대비현재가부호 | string | Y | 1 | |
+| oprc_vrss_prpr | 시가2대비현재가 | string | Y | 10 | |
+| oprc_vrss_prpr_rate | 시가2대비현재가비율 | string | Y | 84 | |
+| stck_hgpr | 주식최고가 | string | Y | 10 | |
+| stck_lwpr | 주식최저가 | string | Y | 10 | |
+| prd_rsfl_sign | 기간등락부호 | string | Y | 1 | |
+| prd_rsfl | 기간등락 | string | Y | 10 | |
+| prd_rsfl_rate | 기간등락비율 | string | Y | 84 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| hts_rmnn_dynu | HTS잔존일수 | string | Y | 5 | |
+| acpr | 행사가 | string | Y | 112 | |
+| unas_isnm | 기초자산명 | string | Y | 40 | |
+| unas_shrn_iscd | 기초자산코드 | string | Y | 12 | |
+| lp_hldn_rate | LP보유비율 | string | Y | 84 | |
+| prit | 패리티 | string | Y | 112 | |
+| prls_qryr_stpr_prc | 손익분기주가가격 | string | Y | 112 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| theta | 세타 | string | Y | 84 | |
+| prls_qryr_rate | 손익분기비율 | string | Y | 84 | |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| stck_last_tr_date | 주식최종거래일자 | string | Y | 8 | |
+| hts_ints_vltl | HTS내재변동성 | string | Y | 114 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:20277
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD:00000
+FID_INPUT_RMNN_DYNU_1:0
+FID_DIV_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+FID_INPUT_VOL_2:
+FID_INPUT_DATE_1:1
+FID_RANK_SORT_CLS_CODE:0
+FID_BLNG_CLS_CODE:0
+FID_INPUT_DATE_2:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "hts_kor_isnm": "한국JAKWLS일렉콜",
+ "elw_shrn_iscd": "57JAKW",
+ "elw_prpr": "460",
+ "prdy_vrss": "350",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "318.18",
+ "acml_vol": "3320",
+ "stck_sdpr": "110",
+ "sdpr_vrss_prpr_sign": "2",
+ "sdpr_vrss_prpr": "460",
+ "sdpr_vrss_prpr_rate": "0.00",
+ "stck_oprc": "470",
+ "oprc_vrss_prpr_sign": "5",
+ "oprc_vrss_prpr": "-10",
+ "oprc_vrss_prpr_rate": "-2.13",
+ "stck_hgpr": "605",
+ "stck_lwpr": "0",
+ "prd_rsfl_sign": "2",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "34.44",
+ "stck_cnvr_rate": "0.010000",
+ "hts_rmnn_dynu": "63",
+ "acpr": "95600.00",
+ "unas_isnm": "LS ELECTRIC",
+ "unas_shrn_iscd": "010120",
+ "lp_hldn_rate": "99.96",
+ "prit": "146.12",
+ "prls_qryr_stpr_prc": "141600.00",
+ "delta_val": "0.930744",
+ "theta": "0.7829",
+ "prls_qryr_rate": "1.3600",
+ "stck_lstn_date": "20231116",
+ "stck_last_tr_date": "20240613",
+ "hts_ints_vltl": "71.91",
+ "lvrg_val": "2.820154"
+ },
+ {
+ "hts_kor_isnm": "KBJF27KOSPI200콜",
+ "elw_shrn_iscd": "58JF27",
+ "elw_prpr": "2395",
+ "prdy_vrss": "1745",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "268.46",
+ "acml_vol": "100",
+ "stck_sdpr": "650",
+ "sdpr_vrss_prpr_sign": "2",
+ "sdpr_vrss_prpr": "2395",
+ "sdpr_vrss_prpr_rate": "0.00",
+ "stck_oprc": "2395",
+ "oprc_vrss_prpr_sign": "3",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "stck_hgpr": "2395",
+ "stck_lwpr": "0",
+ "prd_rsfl_sign": "3",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00",
+ "stck_cnvr_rate": "100.000000",
+ "hts_rmnn_dynu": "28",
+ "acpr": "345.00",
+ "unas_isnm": "KOSPI200",
+ "unas_shrn_iscd": "2001",
+ "lp_hldn_rate": "99.99",
+ "prit": "106.44",
+ "prls_qryr_stpr_prc": "368.95",
+ "delta_val": "0.900891",
+ "theta": "13.8535",
+ "prls_qryr_rate": "0.4600",
+ "stck_lstn_date": "20231228",
+ "stck_last_tr_date": "20240509",
+ "hts_ints_vltl": "19.71",
+ "lvrg_val": "13.810659"
+ },
+ ...
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/064_국내주식-176_ELW-민감도-추이일별.md b/docs/broker/kis/rest/국내주식/ELW-시세/064_국내주식-176_ELW-민감도-추이일별.md
new file mode 100644
index 0000000..5f759b5
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/064_국내주식-176_ELW-민감도-추이일별.md
@@ -0,0 +1,278 @@
+# ELW 민감도 추이(일별)
+
+- 원본 시트명: ELW 민감도 추이(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-176
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02830200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/sensitivity-trend-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 민감도 추이(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0283] ELW 민감도 추이 화면의 "일자별" 민감도추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02830200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex)(58J438(KBJ438삼성전자풋) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| hts_thpr | HTS이론가 | string | Y | 112 | |
+| delta_val | 델타값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| rho | 로우 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240507",
+ "elw_prpr": "25",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-44.44",
+ "hts_thpr": "20.39",
+ "delta_val": "-0.4034",
+ "gama": "0.0000",
+ "theta": "0.5843",
+ "vega": "0.9954",
+ "rho": "-0.3529"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "elw_prpr": "45",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "39.43",
+ "delta_val": "-0.5792",
+ "gama": "0.0000",
+ "theta": "0.5531",
+ "vega": "0.9786",
+ "rho": "-0.5143"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "elw_prpr": "45",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "37.16",
+ "delta_val": "-0.5529",
+ "gama": "0.0000",
+ "theta": "0.5859",
+ "vega": "1.0136",
+ "rho": "-0.5143"
+ },
+ {
+ "stck_bsop_date": "20240430",
+ "elw_prpr": "45",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-10.00",
+ "hts_thpr": "39.30",
+ "delta_val": "-0.5847",
+ "gama": "0.0000",
+ "theta": "0.4979",
+ "vega": "1.0113",
+ "rho": "-0.5579"
+ },
+ {
+ "stck_bsop_date": "20240429",
+ "elw_prpr": "50",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "44.66",
+ "delta_val": "-0.6211",
+ "gama": "0.0000",
+ "theta": "0.4599",
+ "vega": "0.9938",
+ "rho": "-0.6106"
+ },
+ {
+ "stck_bsop_date": "20240426",
+ "elw_prpr": "50",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "44.96",
+ "delta_val": "-0.6202",
+ "gama": "0.0000",
+ "theta": "0.4439",
+ "vega": "1.0115",
+ "rho": "-0.6308"
+ },
+ {
+ "stck_bsop_date": "20240425",
+ "elw_prpr": "50",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.11",
+ "hts_thpr": "47.92",
+ "delta_val": "-0.6534",
+ "gama": "0.0000",
+ "theta": "0.3673",
+ "vega": "0.9917",
+ "rho": "-0.6802"
+ },
+ {
+ "stck_bsop_date": "20240424",
+ "elw_prpr": "45",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-18.18",
+ "hts_thpr": "33.74",
+ "delta_val": "-0.5173",
+ "gama": "0.0000",
+ "theta": "0.5516",
+ "vega": "1.1208",
+ "rho": "-0.5781"
+ },
+ {
+ "stck_bsop_date": "20240423",
+ "elw_prpr": "55",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-8.33",
+ "hts_thpr": "53.36",
+ "delta_val": "-0.6933",
+ "gama": "0.0000",
+ "theta": "0.3086",
+ "vega": "0.9632",
+ "rho": "-0.7635"
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "elw_prpr": "60",
+ "prdy_vrss": "15",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "33.33",
+ "hts_thpr": "49.10",
+ "delta_val": "-0.6135",
+ "gama": "0.0000",
+ "theta": "0.4786",
+ "vega": "1.0740",
+ "rho": "-0.7166"
+ },
+ {
+ "stck_bsop_date": "20240419",
+ "elw_prpr": "45",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "28.57",
+ "hts_thpr": "38.76",
+ "delta_val": "-0.5727",
+ "gama": "0.0000",
+ "theta": "0.4045",
+ "vega": "1.1391",
+ "rho": "-0.6851"
+ },
+ {
+ "stck_bsop_date": "20240418",
+ "elw_prpr": "35",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "28.22",
+ "delta_val": "-0.4785",
+ "gama": "0.0000",
+ "theta": "0.4284",
+ "vega": "1.2033",
+ "rho": "-0.5988"
+ },
+ {
+ "stck_bsop_date": "20240417",
+ "elw_prpr": "35",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_thpr": "31.87",
+ "delta_val": "-0.5156",
+ "gama": "0.0000",
+ "theta": "0.3620",
+ "vega": "1.2100",
+ "rho": "-0.6539"
+ },
+ {
+ "stck_bsop_date": "20240416",
+ "elw_prpr": "35",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "40.00",
+ "hts_thpr": "26.58",
+ "delta_val": "-0.4591",
+ "gama": "0.0000",
+ "theta": "0.4314",
+ "vega": "1.2378",
+ "rho": "-0.6115"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/065_국내주식-183_ELW-비교대상종목조회.md b/docs/broker/kis/rest/국내주식/ELW-시세/065_국내주식-183_ELW-비교대상종목조회.md
new file mode 100644
index 0000000..11049a8
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/065_국내주식-183_ELW-비교대상종목조회.md
@@ -0,0 +1,228 @@
+# ELW 비교대상종목조회
+
+- 원본 시트명: ELW 비교대상종목조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-183
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW151701C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/compare-stocks
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 비교대상종목조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0288] ELW 기초자산별 ELW 시세의 좌측 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW151701C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 11517(Primary key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 종목코드(ex)005930(삼성전자)) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_SCR_DIV_CODE:11517
+FID_INPUT_ISCD:005930
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "58J782",
+ "elw_kor_isnm": "KBJ782삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58J993",
+ "elw_kor_isnm": "KBJ993삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58JC71",
+ "elw_kor_isnm": "KBJC71삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JC72",
+ "elw_kor_isnm": "KBJC72삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JC73",
+ "elw_kor_isnm": "KBJC73삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JC74",
+ "elw_kor_isnm": "KBJC74삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JC75",
+ "elw_kor_isnm": "KBJC75삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JC76",
+ "elw_kor_isnm": "KBJC76삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58JE26",
+ "elw_kor_isnm": "KBJE26삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JE27",
+ "elw_kor_isnm": "KBJE27삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58JE28",
+ "elw_kor_isnm": "KBJE28삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58JE30",
+ "elw_kor_isnm": "KBJE30삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K001",
+ "elw_kor_isnm": "KBK001삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K002",
+ "elw_kor_isnm": "KBK002삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K003",
+ "elw_kor_isnm": "KBK003삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K004",
+ "elw_kor_isnm": "KBK004삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K005",
+ "elw_kor_isnm": "KBK005삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K006",
+ "elw_kor_isnm": "KBK006삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K167",
+ "elw_kor_isnm": "KBK167삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K168",
+ "elw_kor_isnm": "KBK168삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K169",
+ "elw_kor_isnm": "KBK169삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K314",
+ "elw_kor_isnm": "KBK314삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K416",
+ "elw_kor_isnm": "KBK416삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K417",
+ "elw_kor_isnm": "KBK417삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K418",
+ "elw_kor_isnm": "KBK418삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K419",
+ "elw_kor_isnm": "KBK419삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K420",
+ "elw_kor_isnm": "KBK420삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K421",
+ "elw_kor_isnm": "KBK421삼성전자풋"
+ },
+ {
+ "elw_shrn_iscd": "58K579",
+ "elw_kor_isnm": "KBK579삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K580",
+ "elw_kor_isnm": "KBK580삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K581",
+ "elw_kor_isnm": "KBK581삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K582",
+ "elw_kor_isnm": "KBK582삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K583",
+ "elw_kor_isnm": "KBK583삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K584",
+ "elw_kor_isnm": "KBK584삼성전자콜"
+ },
+ {
+ "elw_shrn_iscd": "58K585",
+ "elw_kor_isnm": "KBK585삼성전자풋"
+ },
+ ...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/066_국내주식-184_ELW-만기예정_만기종목.md b/docs/broker/kis/rest/국내주식/ELW-시세/066_국내주식-184_ELW-만기예정_만기종목.md
new file mode 100644
index 0000000..f35829a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/066_국내주식-184_ELW-만기예정_만기종목.md
@@ -0,0 +1,170 @@
+# ELW 만기예정_만기종목
+
+- 원본 시트명: ELW 만기예정_만기종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-184
+- HTTP Method: GET
+- 실전 TR_ID: FHKEW154700C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/expiration-stocks
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 만기예정/만기종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0290] ELW 만기예정/만기종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+최근 100건까지 데이터 조회 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKEW154700C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | W 입력 |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 11547 입력 |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 입력날짜 ~ (ex) 20240402) |
+| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~입력날짜 (ex) 20240408) |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 0(콜),1(풋),2(전체) |
+| FID_ETC_CLS_CODE | 기타구분코드 | string | Y | 2 | 공백 입력 |
+| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | string | Y | 12 | 000000(전체), 2001(KOSPI 200), 기초자산코드(종목코드 ex. 삼성전자-005930) |
+| FID_INPUT_ISCD_2 | 발행회사코드 | string | Y | 8 | 00000(전체), 00003(한국투자증권), 00017(KB증권), 00005(미래에셋증권) |
+| FID_BLNG_CLS_CODE | 결제방법 | string | Y | 2 | 0(전체),1(일반),2(조기종료) |
+| FID_INPUT_OPTION_1 | 입력옵션1 | string | Y | 10 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| elw_shrn_iscd | ELW단축종목코드 | string | Y | 9 | |
+| elw_kor_isnm | ELW한글종목명 | string | Y | 40 | |
+| unas_isnm | 기초자산종목명 | string | Y | 40 | |
+| unas_prpr | 기초자산현재가 | string | Y | 112 | |
+| acpr | 행사가 | string | Y | 112 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| stck_lstn_date | 주식상장일자 | string | Y | 8 | |
+| stck_last_tr_date | 주식최종거래일자 | string | Y | 8 | |
+| total_rdmp_amt | 총상환금액 | string | Y | 18 | |
+| rdmp_amt | 상환금액 | string | Y | 186 | |
+| lstn_stcn | 상장주수 | string | Y | 18 | |
+| lp_hvol | LP보유량 | string | Y | 18 | |
+| ccls_paym_prc | 확정지급2가격 | string | Y | 223 | |
+| mtrt_vltn_amt | 만기평가금액 | string | Y | 192 | |
+| evnt_prd_fin_date | 행사2기간종료일자 | string | Y | 8 | |
+| stlm_date | 결제일자 | string | Y | 8 | |
+| pblc_prc | 발행가격 | string | Y | 18 | |
+| unas_shrn_iscd | 기초자산단축종목코드 | string | Y | 9 | |
+| stnd_iscd | 표준종목코드 | string | Y | 12 | |
+| rdmp_ask_amt | 상환청구금액 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_COND_SCR_DIV_CODE:11547
+FID_INPUT_DATE_1:20240611
+FID_INPUT_DATE_2:20240618
+FID_DIV_CLS_CODE:2
+FID_ETC_CLS_CODE:
+FID_UNAS_INPUT_ISCD:000000
+FID_INPUT_ISCD_2:00000
+FID_BLNG_CLS_CODE:0
+FID_INPUT_OPTION_1:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "elw_shrn_iscd": "58K374",
+ "elw_kor_isnm": "KBK374KOSPI200풋",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "367.71",
+ "acpr": "372.50",
+ "stck_cnvr_rate": "100.000000",
+ "elw_prpr": "515",
+ "stck_lstn_date": "20240320",
+ "stck_last_tr_date": "20240613",
+ "total_rdmp_amt": "0",
+ "rdmp_amt": "0.000000",
+ "lstn_stcn": "5000000",
+ "lp_hvol": "4982390",
+ "ccls_paym_prc": "0.000",
+ "mtrt_vltn_amt": "367.71",
+ "evnt_prd_fin_date": "20240617",
+ "stlm_date": "20240619",
+ "pblc_prc": "1143",
+ "unas_shrn_iscd": "2001",
+ "stnd_iscd": "KRA583261E30",
+ "rdmp_ask_amt": ""
+ },
+ {
+ "elw_shrn_iscd": "58K373",
+ "elw_kor_isnm": "KBK373KOSPI200풋",
+ "unas_isnm": "KOSPI200",
+ "unas_prpr": "367.71",
+ "acpr": "370.00",
+ "stck_cnvr_rate": "100.000000",
+ "elw_prpr": "370",
+ "stck_lstn_date": "20240320",
+ "stck_last_tr_date": "20240613",
+ "total_rdmp_amt": "0",
+ "rdmp_amt": "0.000000",
+ "lstn_stcn": "5000000",
+ "lp_hvol": "4727930",
+ "ccls_paym_prc": "0.000",
+ "mtrt_vltn_amt": "367.71",
+ "evnt_prd_fin_date": "20240617",
+ "stlm_date": "20240619",
+ "pblc_prc": "901",
+ "unas_shrn_iscd": "2001",
+ "stnd_iscd": "KRA583260E31",
+ "rdmp_ask_amt": ""
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/067_국내주식-182_ELW-LP매매추이.md b/docs/broker/kis/rest/국내주식/ELW-시세/067_국내주식-182_ELW-LP매매추이.md
new file mode 100644
index 0000000..eb9c18d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/067_국내주식-182_ELW-LP매매추이.md
@@ -0,0 +1,313 @@
+# ELW LP매매추이
+
+- 원본 시트명: ELW LP매매추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-182
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW03760000
+- 모의 TR_ID: 없음
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/lp-trade-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW LP매매추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0376] ELW LP매매추이 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW03760000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분(W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 입력종목코드(ex 52K577(미래 K577KOSDAQ150콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| prdy_vol | 전일거래량 | string | Y | 18 | |
+| stck_cnvr_rate | 주식전환비율 | string | Y | 136 | |
+| prit | 패리티 | string | Y | 112 | |
+| lvrg_val | 레버리지값 | string | Y | 114 | |
+| gear | 기어링 | string | Y | 84 | |
+| prls_qryr_rate | 손익분기비율 | string | Y | 84 | |
+| cfp | 자본지지점 | string | Y | 112 | |
+| invl_val | 내재가치값 | string | Y | 132 | |
+| tmvl_val | 시간가치값 | string | Y | 132 | |
+| acpr | 행사가 | string | Y | 112 | |
+| elw_ko_barrier | 조기종료발생기준가격 | string | Y | 112 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| lp_seln_qty | LP매도수량 | string | Y | 19 | |
+| lp_seln_avrg_unpr | LP매도평균단가 | string | Y | 19 | |
+| lp_shnu_qty | LP매수수량 | string | Y | 19 | |
+| lp_shnu_avrg_unpr | LP매수평균단가 | string | Y | 19 | |
+| lp_hvol | LP보유량 | string | Y | 18 | |
+| lp_hldn_rate | LP보유비율 | string | Y | 84 | |
+| prsn_deal_qty | 개인매매수량 | string | Y | 19 | |
+| apprch_rate | 접근도 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5",
+ "prdy_ctrt": "14.29",
+ "acml_vol": "320750",
+ "prdy_vol": "114850",
+ "stck_cnvr_rate": "0.010000",
+ "prit": "103.35",
+ "lvrg_val": "-12.130651",
+ "gear": "19.3500",
+ "prls_qryr_rate": "-1.8000",
+ "cfp": "-1.7100",
+ "invl_val": "27.00",
+ "tmvl_val": "13.00",
+ "acpr": "80000.00",
+ "elw_ko_barrier": "0.00"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240516",
+ "elw_prpr": "35",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "30030",
+ "lp_seln_avrg_unpr": "30",
+ "lp_shnu_qty": "84810",
+ "lp_shnu_avrg_unpr": "34",
+ "lp_hvol": "7999900",
+ "lp_hldn_rate": "99.99",
+ "prsn_deal_qty": "10",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240514",
+ "elw_prpr": "35",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-12.50",
+ "lp_seln_qty": "73510",
+ "lp_seln_avrg_unpr": "35",
+ "lp_shnu_qty": "74440",
+ "lp_shnu_avrg_unpr": "35",
+ "lp_hvol": "7945120",
+ "lp_hldn_rate": "99.31",
+ "prsn_deal_qty": "1260",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240513",
+ "elw_prpr": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10",
+ "prdy_ctrt": "33.33",
+ "lp_seln_qty": "282010",
+ "lp_seln_avrg_unpr": "36",
+ "lp_shnu_qty": "277980",
+ "lp_shnu_avrg_unpr": "36",
+ "lp_hvol": "7944190",
+ "lp_hldn_rate": "99.30",
+ "prsn_deal_qty": "11140",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240510",
+ "elw_prpr": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5",
+ "prdy_ctrt": "20.00",
+ "lp_seln_qty": "137480",
+ "lp_seln_avrg_unpr": "27",
+ "lp_shnu_qty": "209950",
+ "lp_shnu_avrg_unpr": "25",
+ "lp_hvol": "7948220",
+ "lp_hldn_rate": "99.35",
+ "prsn_deal_qty": "2040",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240509",
+ "elw_prpr": "25",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "280020",
+ "lp_seln_avrg_unpr": "25",
+ "lp_shnu_qty": "209910",
+ "lp_shnu_avrg_unpr": "25",
+ "lp_hvol": "7875750",
+ "lp_hldn_rate": "98.44",
+ "prsn_deal_qty": "120",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240508",
+ "elw_prpr": "25",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "630000",
+ "lp_seln_avrg_unpr": "25",
+ "lp_shnu_qty": "630000",
+ "lp_shnu_avrg_unpr": "25",
+ "lp_hvol": "7945860",
+ "lp_hldn_rate": "99.32",
+ "prsn_deal_qty": "10000",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240507",
+ "elw_prpr": "25",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-20",
+ "prdy_ctrt": "-44.44",
+ "lp_seln_qty": "98550",
+ "lp_seln_avrg_unpr": "27",
+ "lp_shnu_qty": "160420",
+ "lp_shnu_avrg_unpr": "28",
+ "lp_hvol": "7945860",
+ "lp_hldn_rate": "99.32",
+ "prsn_deal_qty": "26200",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "elw_prpr": "45",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "501890",
+ "lp_seln_avrg_unpr": "40",
+ "lp_shnu_qty": "491690",
+ "lp_shnu_avrg_unpr": "40",
+ "lp_hvol": "7883990",
+ "lp_hldn_rate": "98.55",
+ "prsn_deal_qty": "8440",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "elw_prpr": "45",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "402940",
+ "lp_seln_avrg_unpr": "40",
+ "lp_shnu_qty": "332240",
+ "lp_shnu_avrg_unpr": "40",
+ "lp_hvol": "7894190",
+ "lp_hldn_rate": "98.67",
+ "prsn_deal_qty": "54100",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240430",
+ "elw_prpr": "45",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-10.00",
+ "lp_seln_qty": "27840",
+ "lp_seln_avrg_unpr": "48",
+ "lp_shnu_qty": "33540",
+ "lp_shnu_avrg_unpr": "45",
+ "lp_hvol": "7964890",
+ "lp_hldn_rate": "99.56",
+ "prsn_deal_qty": "710",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240429",
+ "elw_prpr": "50",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "211510",
+ "lp_seln_avrg_unpr": "50",
+ "lp_shnu_qty": "175810",
+ "lp_shnu_avrg_unpr": "50",
+ "lp_hvol": "7959190",
+ "lp_hldn_rate": "99.49",
+ "prsn_deal_qty": "15700",
+ "apprch_rate": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240426",
+ "elw_prpr": "50",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "lp_seln_qty": "35700",
+ "lp_seln_avrg_unpr": "50",
+ "lp_shnu_qty": "91400",
+ "lp_shnu_avrg_unpr": "48",
+ "lp_hvol": "7994890",
+ "lp_hldn_rate": "99.93",
+ "prsn_deal_qty": "60",
+ "apprch_rate": "0.00"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/068_국내주식-175_ELW-민감도-추이체결.md b/docs/broker/kis/rest/국내주식/ELW-시세/068_국내주식-175_ELW-민감도-추이체결.md
new file mode 100644
index 0000000..9551343
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/068_국내주식-175_ELW-민감도-추이체결.md
@@ -0,0 +1,80 @@
+# ELW 민감도 추이(체결)
+
+- 원본 시트명: ELW 민감도 추이(체결)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-175
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02830100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/sensitivity-trend-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 민감도 추이(체결) API입니다.
+한국투자 HTS(eFriend Plus) > [0283] ELW 민감도 추이 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02830100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (W) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
+| elw_prpr | ELW현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| hts_thpr | hts 이론가 | string | Y | 112 | |
+| delta_val | 델타 값 | string | Y | 114 | |
+| gama | 감마 | string | Y | 84 | |
+| theta | 세타 | string | Y | 84 | |
+| vega | 베가 | string | Y | 84 | |
+| rho | 로우 | string | Y | 84 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/ELW-시세/069_국내주식-180_ELW-변동성-추이틱.md b/docs/broker/kis/rest/국내주식/ELW-시세/069_국내주식-180_ELW-변동성-추이틱.md
new file mode 100644
index 0000000..a26ebca
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/ELW-시세/069_국내주식-180_ELW-변동성-추이틱.md
@@ -0,0 +1,227 @@
+# ELW 변동성 추이(틱)
+
+- 원본 시트명: ELW 변동성 추이(틱)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] ELW 시세
+- API ID: 국내주식-180
+- HTTP Method: GET
+- 실전 TR_ID: FHPEW02840400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/elw/v1/quotations/volatility-trend-tick
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 변동성 추이(틱) API입니다.
+한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "틱 차트" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPEW02840400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | W(Unique key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_date | 주식영업일자 | string | Y | 8 | |
+| stck_cntg_hour | ELW현재가 | string | Y | 6 | |
+| elw_prpr | 전일대비 | string | Y | 10 | |
+| hts_ints_vltl | 전일대비부호 | string | Y | 114 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:W
+FID_INPUT_ISCD:57K281
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "150619",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "33.03"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "150032",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "28.44"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "150031",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "28.44"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "145743",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "33.44"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "145743",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "33.44"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "133437",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "32.47"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "133434",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "32.47"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "132342",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "31.60"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "093016",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "28.62"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "092952",
+ "elw_prpr": "25",
+ "hts_ints_vltl": "28.62"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "091704",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "33.03"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090900",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "33.02"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090735",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "28.59"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090712",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "28.59"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090710",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "28.59"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090555",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "33.46"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090553",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "33.46"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090511",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "33.46"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090445",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "36.51"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090445",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "36.51"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090445",
+ "elw_prpr": "30",
+ "hts_ints_vltl": "36.51"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090320",
+ "elw_prpr": "35",
+ "hts_ints_vltl": "36.51"
+ },
+ {
+ "bsop_date": "20240507",
+ "stck_cntg_hour": "090030",
+ "elw_prpr": "40",
+ "hts_ints_vltl": "32.97"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/027_v1_국내주식-010_주식현재가-일자별.md b/docs/broker/kis/rest/국내주식/기본시세/027_v1_국내주식-010_주식현재가-일자별.md
new file mode 100644
index 0000000..2341416
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/027_v1_국내주식-010_주식현재가-일자별.md
@@ -0,0 +1,136 @@
+# 주식현재가 일자별
+
+- 원본 시트명: 주식현재가 일자별
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-010
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010400
+- 모의 TR_ID: FHKST01010400
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 일자별 API입니다. 일/주/월별 주가를 확인할 수 있으며 최근 30일(주,별)로 제한되어 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01010400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+| FID_PERIOD_DIV_CODE | 기간 분류 코드 | string | Y | 32 | 'D : (일)최근 30거래일
W : (주)최근 30주
M : (월)최근 30개월' |
+| FID_ORG_ADJ_PRC | 수정주가 원주가 가격 | string | Y | 10 | '0 : 수정주가미반영
1 : 수정주가반영
* 수정주가는 액면분할/액면병합 등 권리 발생 시 과거 시세를 현재 주가에 맞게 보정한 가격' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | 13(8.4) |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | 11(8.2) |
+| hts_frgn_ehrt | HTS 외국인 소진율 | string | Y | 82 | 11(8.2) |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| flng_cls_code | 락 구분 코드 | string | Y | 2 | '01 : 권리락
02 : 배당락
03 : 분배락
04 : 권배락
05 : 중간(분기)배당락
06 : 권리중간배당락
07 : 권리분기배당락' |
+| acml_prtt_rate | 누적 분할 비율 | string | Y | 84 | 13(8.4) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660",
+"fid_org_adj_prc": "0000000001",
+"fid_period_div_code": "D"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20220111",
+ "stck_oprc": "125500",
+ "stck_hgpr": "128500",
+ "stck_lwpr": "124500",
+ "stck_clpr": "128000",
+ "acml_vol": "3908418",
+ "prdy_vrss_vol_rate": "13.31",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.81",
+ "hts_frgn_ehrt": "49.39",
+ "frgn_ntby_qty": "0",
+ "flng_cls_code": "00",
+ "acml_prtt_rate": "1.00"
+ },
+ {
+ "stck_bsop_date": "20220110",
+ "stck_oprc": "126500",
+ "stck_hgpr": "127000",
+ "stck_lwpr": "123000",
+ "stck_clpr": "124500",
+ "acml_vol": "3449197",
+ "prdy_vrss_vol_rate": "5.48",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.97",
+ "hts_frgn_ehrt": "49.39",
+ "frgn_ntby_qty": "293389",
+ "flng_cls_code": "00",
+ "acml_prtt_rate": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/028_v1_국내주식-008_주식현재가-시세.md b/docs/broker/kis/rest/국내주식/기본시세/028_v1_국내주식-008_주식현재가-시세.md
new file mode 100644
index 0000000..173130e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/028_v1_국내주식-008_주식현재가-시세.md
@@ -0,0 +1,250 @@
+# 주식현재가 시세
+
+- 원본 시트명: 주식현재가 시세
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-008
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010100
+- 모의 TR_ID: FHKST01010100
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식 현재가 시세 API입니다. 실시간 시세를 원하신다면 웹소켓 API를 활용하세요.
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01010100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) // ETN은 종목코드 6자리 앞에 Q 입력 필수 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| iscd_stat_cls_code | 종목 상태 구분 코드 | string | Y | 3 | 51 : 관리종목
52 : 투자위험
53 : 투자경고
54 : 투자주의
55 : 신용가능
57 : 증거금 100%
58 : 거래정지
59 : 단기과열종목 |
+| marg_rate | 증거금 비율 | string | Y | 84 | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| new_hgpr_lwpr_cls_code | 신 고가 저가 구분 코드 | string | Y | 10 | |
+| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | |
+| temp_stop_yn | 임시 정지 여부 | string | Y | 1 | |
+| oprc_rang_cont_yn | 시가 범위 연장 여부 | string | Y | 1 | |
+| clpr_rang_cont_yn | 종가 범위 연장 여부 | string | Y | 1 | |
+| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
+| grmn_rate_cls_code | 보증금 비율 구분 코드 | string | Y | 3 | |
+| elw_pblc_yn | ELW 발행 여부 | string | Y | 1 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| stck_mxpr | 주식 상한가 | string | Y | 10 | |
+| stck_llam | 주식 하한가 | string | Y | 10 | |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+| wghn_avrg_stck_prc | 가중 평균 주식 가격 | string | Y | 192 | |
+| hts_frgn_ehrt | HTS 외국인 소진율 | string | Y | 82 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| pgtr_ntby_qty | 프로그램매매 순매수 수량 | string | Y | 18 | |
+| pvt_scnd_dmrs_prc | 피벗 2차 디저항 가격 | string | Y | 10 | |
+| pvt_frst_dmrs_prc | 피벗 1차 디저항 가격 | string | Y | 10 | |
+| pvt_pont_val | 피벗 포인트 값 | string | Y | 10 | |
+| pvt_frst_dmsp_prc | 피벗 1차 디지지 가격 | string | Y | 10 | |
+| pvt_scnd_dmsp_prc | 피벗 2차 디지지 가격 | string | Y | 10 | |
+| dmrs_val | 디저항 값 | string | Y | 10 | |
+| dmsp_val | 디지지 값 | string | Y | 10 | |
+| cpfn | 자본금 | string | Y | 22 | |
+| rstc_wdth_prc | 제한 폭 가격 | string | Y | 10 | |
+| stck_fcam | 주식 액면가 | string | Y | 11 | |
+| stck_sspr | 주식 대용가 | string | Y | 10 | |
+| aspr_unit | 호가단위 | string | Y | 10 | |
+| hts_deal_qty_unit_val | HTS 매매 수량 단위 값 | string | Y | 10 | |
+| lstn_stcn | 상장 주수 | string | Y | 18 | |
+| hts_avls | HTS 시가총액 | string | Y | 18 | |
+| per | PER | string | Y | 82 | |
+| pbr | PBR | string | Y | 82 | |
+| stac_month | 결산 월 | string | Y | 2 | |
+| vol_tnrt | 거래량 회전율 | string | Y | 82 | |
+| eps | EPS | string | Y | 112 | |
+| bps | BPS | string | Y | 112 | |
+| d250_hgpr | 250일 최고가 | string | Y | 10 | |
+| d250_hgpr_date | 250일 최고가 일자 | string | Y | 8 | |
+| d250_hgpr_vrss_prpr_rate | 250일 최고가 대비 현재가 비율 | string | Y | 84 | |
+| d250_lwpr | 250일 최저가 | string | Y | 10 | |
+| d250_lwpr_date | 250일 최저가 일자 | string | Y | 8 | |
+| d250_lwpr_vrss_prpr_rate | 250일 최저가 대비 현재가 비율 | string | Y | 84 | |
+| stck_dryy_hgpr | 주식 연중 최고가 | string | Y | 10 | |
+| dryy_hgpr_vrss_prpr_rate | 연중 최고가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_hgpr_date | 연중 최고가 일자 | string | Y | 8 | |
+| stck_dryy_lwpr | 주식 연중 최저가 | string | Y | 10 | |
+| dryy_lwpr_vrss_prpr_rate | 연중 최저가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_lwpr_date | 연중 최저가 일자 | string | Y | 8 | |
+| w52_hgpr | 52주일 최고가 | string | Y | 10 | |
+| w52_hgpr_vrss_prpr_ctrt | 52주일 최고가 대비 현재가 대비 | string | Y | 82 | |
+| w52_hgpr_date | 52주일 최고가 일자 | string | Y | 8 | |
+| w52_lwpr | 52주일 최저가 | string | Y | 10 | |
+| w52_lwpr_vrss_prpr_ctrt | 52주일 최저가 대비 현재가 대비 | string | Y | 82 | |
+| w52_lwpr_date | 52주일 최저가 일자 | string | Y | 8 | |
+| whol_loan_rmnd_rate | 전체 융자 잔고 비율 | string | Y | 84 | |
+| ssts_yn | 공매도가능여부 | string | Y | 1 | |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| fcam_cnnm | 액면가 통화명 | string | Y | 20 | |
+| cpfn_cnnm | 자본금 통화명 | string | Y | 20 | |
+| apprch_rate | 접근도 | string | Y | 112 | |
+| frgn_hldn_qty | 외국인 보유 수량 | string | Y | 18 | |
+| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
+| ovtm_vi_cls_code | 시간외단일가VI적용구분코드 | string | Y | 1 | |
+| last_ssts_cntg_qty | 최종 공매도 체결 수량 | string | Y | 12 | |
+| invt_caful_yn | 투자유의여부 | string | Y | 1 | |
+| mrkt_warn_cls_code | 시장경고코드 | string | Y | 2 | |
+| short_over_yn | 단기과열여부 | string | Y | 1 | |
+| sltr_yn | 정리매매여부 | string | Y | 1 | |
+| mang_issu_cls_code | 관리종목여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "iscd_stat_cls_code": "55",
+ "marg_rate": "20.00",
+ "rprs_mrkt_kor_name": "KOSPI200",
+ "bstp_kor_isnm": "전기.전자",
+ "temp_stop_yn": "N",
+ "oprc_rang_cont_yn": "N",
+ "clpr_rang_cont_yn": "N",
+ "crdt_able_yn": "Y",
+ "grmn_rate_cls_code": "40",
+ "elw_pblc_yn": "Y",
+ "stck_prpr": "128500",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_tr_pbmn": "344570137500",
+ "acml_vol": "2669075",
+ "prdy_vrss_vol_rate": "75.14",
+ "stck_oprc": "128500",
+ "stck_hgpr": "130000",
+ "stck_lwpr": "128500",
+ "stck_mxpr": "167000",
+ "stck_llam": "90000",
+ "stck_sdpr": "128500",
+ "wghn_avrg_stck_prc": "129097.23",
+ "hts_frgn_ehrt": "49.48",
+ "frgn_ntby_qty": "0",
+ "pgtr_ntby_qty": "287715",
+ "pvt_scnd_dmrs_prc": "131833",
+ "pvt_frst_dmrs_prc": "130166",
+ "pvt_pont_val": "128333",
+ "pvt_frst_dmsp_prc": "126666",
+ "pvt_scnd_dmsp_prc": "124833",
+ "dmrs_val": "129250",
+ "dmsp_val": "125750",
+ "cpfn": "36577",
+ "rstc_wdth_prc": "38500",
+ "stck_fcam": "5000",
+ "stck_sspr": "97660",
+ "aspr_unit": "500",
+ "hts_deal_qty_unit_val": "1",
+ "lstn_stcn": "728002365",
+ "hts_avls": "935483",
+ "per": "19.67",
+ "pbr": "1.72",
+ "stac_month": "12",
+ "vol_tnrt": "0.37",
+ "eps": "6532.00",
+ "bps": "74721.00",
+ "d250_hgpr": "149500",
+ "d250_hgpr_date": "20210225",
+ "d250_hgpr_vrss_prpr_rate": "-14.05",
+ "d250_lwpr": "90500",
+ "d250_lwpr_date": "20211013",
+ "d250_lwpr_vrss_prpr_rate": "41.99",
+ "stck_dryy_hgpr": "132500",
+ "dryy_hgpr_vrss_prpr_rate": "-3.02",
+ "dryy_hgpr_date": "20220103",
+ "stck_dryy_lwpr": "121500",
+ "dryy_lwpr_vrss_prpr_rate": "5.76",
+ "dryy_lwpr_date": "20220105",
+ "w52_hgpr": "149500",
+ "w52_hgpr_vrss_prpr_ctrt": "-14.05",
+ "w52_hgpr_date": "20210225",
+ "w52_lwpr": "90500",
+ "w52_lwpr_vrss_prpr_ctrt": "41.99",
+ "w52_lwpr_date": "20211013",
+ "whol_loan_rmnd_rate": "0.22",
+ "ssts_yn": "Y",
+ "stck_shrn_iscd": "000660",
+ "fcam_cnnm": "5,000",
+ "cpfn_cnnm": "36,576 억",
+ "frgn_hldn_qty": "360220601",
+ "vi_cls_code": "N",
+ "ovtm_vi_cls_code": "N",
+ "last_ssts_cntg_qty": "43916",
+ "invt_caful_yn": "N",
+ "mrkt_warn_cls_code": "00",
+ "short_over_yn": "N",
+ "sltr_yn": "N"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/029_국내주식-076_국내주식-시간외현재가.md b/docs/broker/kis/rest/국내주식/기본시세/029_국내주식-076_국내주식-시간외현재가.md
new file mode 100644
index 0000000..0f2244a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/029_국내주식-076_국내주식-시간외현재가.md
@@ -0,0 +1,151 @@
+# 국내주식 시간외현재가
+
+- 원본 시트명: 국내주식 시간외현재가
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: 국내주식-076
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02300000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-overtime-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외현재가 API입니다.
+한국투자 HTS(eFriend Plus) > [0230] 시간외 현재가 화면의 좌측 상단기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02300000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
+| mang_issu_cls_name | 관리 종목 구분 명 | string | Y | 40 | |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | Y | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | Y | 82 | |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | Y | 18 | |
+| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | Y | 18 | |
+| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | Y | 18 | |
+| ovtm_untp_llam | 시간외 단일가 하한가 | string | Y | 18 | |
+| ovtm_untp_oprc | 시간외 단일가 시가2 | string | Y | 10 | |
+| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | Y | 10 | |
+| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | Y | 10 | |
+| marg_rate | 증거금 비율 | string | Y | 84 | |
+| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | Y | 10 | |
+| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | Y | 10 | |
+| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | Y | 1 | |
+| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | Y | 82 | |
+| ovtm_untp_antc_cnqn | 시간외 단일가 예상 체결량 | string | Y | 18 | |
+| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
+| new_lstn_cls_name | 신규 상장 구분 명 | string | Y | 40 | |
+| sltr_yn | 정리매매 여부 | string | Y | 1 | |
+| mang_issu_yn | 관리 종목 여부 | string | Y | 1 | |
+| mrkt_warn_cls_code | 시장 경고 구분 코드 | string | Y | 2 | |
+| trht_yn | 거래정지 여부 | string | Y | 1 | |
+| vlnt_deal_cls_name | 임의 매매 구분 명 | string | Y | 16 | |
+| ovtm_untp_sdpr | 시간외 단일가 기준가 | string | Y | 10 | |
+| mrkt_warn_cls_name | 시장 경구 구분 명 | string | Y | 40 | |
+| revl_issu_reas_name | 재평가 종목 사유 명 | string | Y | 40 | |
+| insn_pbnt_yn | 불성실 공시 여부 | string | Y | 1 | |
+| flng_cls_name | 락 구분 이름 | string | Y | 40 | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| ovtm_vi_cls_code | 시간외단일가VI적용구분코드 | string | Y | 1 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_input_iscd:005930
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "bstp_kor_isnm": "전기.전자",
+ "ovtm_untp_prpr": "83600",
+ "ovtm_untp_prdy_vrss": "-100",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.12",
+ "ovtm_untp_vol": "3500",
+ "ovtm_untp_tr_pbmn": "292600000",
+ "ovtm_untp_mxpr": "92000",
+ "ovtm_untp_llam": "75400",
+ "ovtm_untp_oprc": "83600",
+ "ovtm_untp_hgpr": "83600",
+ "ovtm_untp_lwpr": "83600",
+ "marg_rate": "20.00",
+ "ovtm_untp_antc_cnpr": "83500",
+ "ovtm_untp_antc_cntg_vrss": "-200",
+ "ovtm_untp_antc_cntg_vrss_sign": "5",
+ "ovtm_untp_antc_cntg_ctrt": "-0.24",
+ "ovtm_untp_antc_cnqn": "4442",
+ "crdt_able_yn": "Y",
+ "new_lstn_cls_name": " ",
+ "sltr_yn": "N",
+ "mang_issu_yn": "N",
+ "mrkt_warn_cls_code": "00",
+ "trht_yn": "N",
+ "vlnt_deal_cls_name": " ",
+ "ovtm_untp_sdpr": "83700",
+ "insn_pbnt_yn": "N",
+ "rprs_mrkt_kor_name": "KOSPI200",
+ "ovtm_vi_cls_code": "N",
+ "bidp": "83600",
+ "askp": "83700"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/030_국내주식-073_ETF-구성종목시세.md b/docs/broker/kis/rest/국내주식/기본시세/030_국내주식-073_ETF-구성종목시세.md
new file mode 100644
index 0000000..5797cbc
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/030_국내주식-073_ETF-구성종목시세.md
@@ -0,0 +1,1031 @@
+# ETF 구성종목시세
+
+- 원본 시트명: ETF 구성종목시세
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: 국내주식-073
+- HTTP Method: GET
+- 실전 TR_ID: FHKST121600C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/etfetn/v1/quotations/inquire-component-stock-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ETF 구성종목시세 API입니다.
+한국투자 HTS(eFriend Plus) > [0245] ETF/ETN 구성종목시세 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST121600C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (J) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 종목코드 |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key( 11216 ) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| etf_cnfg_issu_avls | ETF구성종목시가총액 | string | Y | 18 | |
+| nav | NAV | string | Y | 112 | |
+| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
+| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
+| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 84 | |
+| etf_ntas_ttam | ETF 순자산 총액 | string | Y | 22 | |
+| prdy_clpr_nav | NAV전일종가 | string | Y | 112 | |
+| oprc_nav | NAV시가 | string | Y | 112 | |
+| hprc_nav | NAV고가 | string | Y | 112 | |
+| lprc_nav | NAV저가 | string | Y | 112 | |
+| etf_cu_unit_scrt_cnt | ETF CU 단위 증권 수 | string | Y | 18 | |
+| etf_cnfg_issu_cnt | ETF 구성 종목 수 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| tday_rsfl_rate | 당일 등락 비율 | string | Y | 52 | |
+| prdy_vrss_vol | 전일 대비 거래량 | string | Y | 18 | |
+| tr_pbmn_tnrt | 거래대금회전율 | string | Y | 82 | |
+| hts_avls | HTS 시가총액 | string | Y | 18 | |
+| etf_cnfg_issu_avls | ETF구성종목시가총액 | string | Y | 18 | |
+| etf_cnfg_issu_rlim | ETF구성종목비중 | string | Y | 72 | |
+| etf_vltn_amt | ETF구성종목내평가금액 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_input_iscd:069500
+fid_cond_scr_div_code:11216
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "stck_prpr": "37195",
+ "prdy_vrss": "-365",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.97",
+ "etf_cnfg_issu_avls": "184153",
+ "nav": "37301.11",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-347.36",
+ "nav_prdy_ctrt": "-0.92",
+ "etf_ntas_ttam": "68256",
+ "prdy_clpr_nav": "37648.47",
+ "oprc_nav": "37653.39",
+ "hprc_nav": "37720.17",
+ "lprc_nav": "37223.93",
+ "etf_cu_unit_scrt_cnt": "50000",
+ "etf_cnfg_issu_cnt": "201"
+ },
+ "output2": [
+ {
+ "stck_shrn_iscd": "005930",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "83700",
+ "prdy_vrss": "-400",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.48",
+ "acml_vol": "16967184",
+ "acml_tr_pbmn": "1421776834400",
+ "tday_rsfl_rate": "2.02",
+ "prdy_vrss_vol": "-8570824",
+ "tr_pbmn_tnrt": "0.28",
+ "hts_avls": "4996708",
+ "etf_cnfg_issu_avls": "601300800",
+ "etf_cnfg_issu_rlim": "32.65",
+ "etf_vltn_amt": "604174400"
+ },
+ {
+ "stck_shrn_iscd": "000660",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "187400",
+ "prdy_vrss": "-1000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.53",
+ "acml_vol": "3042349",
+ "acml_tr_pbmn": "575151315700",
+ "tday_rsfl_rate": "2.34",
+ "prdy_vrss_vol": "-1055882",
+ "tr_pbmn_tnrt": "0.42",
+ "hts_avls": "1364276",
+ "etf_cnfg_issu_avls": "160039600",
+ "etf_cnfg_issu_rlim": "8.69",
+ "etf_vltn_amt": "160893600"
+ },
+ {
+ "stck_shrn_iscd": "005380",
+ "hts_kor_isnm": "현대차",
+ "stck_prpr": "238000",
+ "prdy_vrss": "-3000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.24",
+ "acml_vol": "993944",
+ "acml_tr_pbmn": "237608070000",
+ "tday_rsfl_rate": "1.87",
+ "prdy_vrss_vol": "-859847",
+ "tr_pbmn_tnrt": "0.47",
+ "hts_avls": "503445",
+ "etf_cnfg_issu_avls": "50694000",
+ "etf_cnfg_issu_rlim": "2.75",
+ "etf_vltn_amt": "51333000"
+ },
+ {
+ "stck_shrn_iscd": "068270",
+ "hts_kor_isnm": "셀트리온",
+ "stck_prpr": "182200",
+ "prdy_vrss": "2700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.50",
+ "acml_vol": "473566",
+ "acml_tr_pbmn": "85712403800",
+ "tday_rsfl_rate": "2.90",
+ "prdy_vrss_vol": "-52048",
+ "tr_pbmn_tnrt": "0.22",
+ "hts_avls": "397287",
+ "etf_cnfg_issu_avls": "46643200",
+ "etf_cnfg_issu_rlim": "2.53",
+ "etf_vltn_amt": "45952000"
+ },
+ {
+ "stck_shrn_iscd": "000270",
+ "hts_kor_isnm": "기아",
+ "stck_prpr": "109800",
+ "prdy_vrss": "-1900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.70",
+ "acml_vol": "1221033",
+ "acml_tr_pbmn": "134154098000",
+ "tday_rsfl_rate": "3.31",
+ "prdy_vrss_vol": "-996547",
+ "tr_pbmn_tnrt": "0.30",
+ "hts_avls": "441445",
+ "etf_cnfg_issu_avls": "41724000",
+ "etf_cnfg_issu_rlim": "2.27",
+ "etf_vltn_amt": "42446000"
+ },
+ {
+ "stck_shrn_iscd": "005490",
+ "hts_kor_isnm": "POSCO홀딩스",
+ "stck_prpr": "395000",
+ "prdy_vrss": "-5000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.25",
+ "acml_vol": "317449",
+ "acml_tr_pbmn": "126170285000",
+ "tday_rsfl_rate": "2.62",
+ "prdy_vrss_vol": "-155864",
+ "tr_pbmn_tnrt": "0.38",
+ "hts_avls": "334056",
+ "etf_cnfg_issu_avls": "40685000",
+ "etf_cnfg_issu_rlim": "2.21",
+ "etf_vltn_amt": "41200000"
+ },
+ {
+ "stck_shrn_iscd": "035420",
+ "hts_kor_isnm": "NAVER",
+ "stck_prpr": "185900",
+ "prdy_vrss": "2300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.25",
+ "acml_vol": "831828",
+ "acml_tr_pbmn": "155684174100",
+ "tday_rsfl_rate": "2.56",
+ "prdy_vrss_vol": "-360853",
+ "tr_pbmn_tnrt": "0.52",
+ "hts_avls": "301918",
+ "etf_cnfg_issu_avls": "37737700",
+ "etf_cnfg_issu_rlim": "2.05",
+ "etf_vltn_amt": "37270800"
+ },
+ {
+ "stck_shrn_iscd": "105560",
+ "hts_kor_isnm": "KB금융",
+ "stck_prpr": "66300",
+ "prdy_vrss": "-2000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.93",
+ "acml_vol": "1756980",
+ "acml_tr_pbmn": "116400995300",
+ "tday_rsfl_rate": "2.93",
+ "prdy_vrss_vol": "-1142245",
+ "tr_pbmn_tnrt": "0.44",
+ "hts_avls": "267528",
+ "etf_cnfg_issu_avls": "34608600",
+ "etf_cnfg_issu_rlim": "1.88",
+ "etf_vltn_amt": "35652600"
+ },
+ {
+ "stck_shrn_iscd": "006400",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "401000",
+ "prdy_vrss": "-6500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.60",
+ "acml_vol": "261871",
+ "acml_tr_pbmn": "105929587000",
+ "tday_rsfl_rate": "2.45",
+ "prdy_vrss_vol": "-54274",
+ "tr_pbmn_tnrt": "0.38",
+ "hts_avls": "275746",
+ "etf_cnfg_issu_avls": "31679000",
+ "etf_cnfg_issu_rlim": "1.72",
+ "etf_vltn_amt": "32192500"
+ },
+ {
+ "stck_shrn_iscd": "055550",
+ "hts_kor_isnm": "신한지주",
+ "stck_prpr": "41850",
+ "prdy_vrss": "-1250",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.90",
+ "acml_vol": "2559109",
+ "acml_tr_pbmn": "107101173850",
+ "tday_rsfl_rate": "4.18",
+ "prdy_vrss_vol": "-822187",
+ "tr_pbmn_tnrt": "0.50",
+ "hts_avls": "213181",
+ "etf_cnfg_issu_avls": "28123200",
+ "etf_cnfg_issu_rlim": "1.53",
+ "etf_vltn_amt": "28963200"
+ },
+ {
+ "stck_shrn_iscd": "051910",
+ "hts_kor_isnm": "LG화학",
+ "stck_prpr": "393000",
+ "prdy_vrss": "6000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.55",
+ "acml_vol": "259235",
+ "acml_tr_pbmn": "102510288000",
+ "tday_rsfl_rate": "4.01",
+ "prdy_vrss_vol": "-231613",
+ "tr_pbmn_tnrt": "0.37",
+ "hts_avls": "277428",
+ "etf_cnfg_issu_avls": "27510000",
+ "etf_cnfg_issu_rlim": "1.49",
+ "etf_vltn_amt": "27090000"
+ },
+ {
+ "stck_shrn_iscd": "012330",
+ "hts_kor_isnm": "현대모비스",
+ "stck_prpr": "240500",
+ "prdy_vrss": "-10500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.18",
+ "acml_vol": "198685",
+ "acml_tr_pbmn": "48155091500",
+ "tday_rsfl_rate": "3.19",
+ "prdy_vrss_vol": "-91322",
+ "tr_pbmn_tnrt": "0.21",
+ "hts_avls": "225241",
+ "etf_cnfg_issu_avls": "23328500",
+ "etf_cnfg_issu_rlim": "1.27",
+ "etf_vltn_amt": "24347000"
+ },
+ {
+ "stck_shrn_iscd": "035720",
+ "hts_kor_isnm": "카카오",
+ "stck_prpr": "47850",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.42",
+ "acml_vol": "942730",
+ "acml_tr_pbmn": "45251826950",
+ "tday_rsfl_rate": "1.66",
+ "prdy_vrss_vol": "-1062355",
+ "tr_pbmn_tnrt": "0.21",
+ "hts_avls": "213049",
+ "etf_cnfg_issu_avls": "23015850",
+ "etf_cnfg_issu_rlim": "1.25",
+ "etf_vltn_amt": "23112050"
+ },
+ {
+ "stck_shrn_iscd": "086790",
+ "hts_kor_isnm": "하나금융지주",
+ "stck_prpr": "55000",
+ "prdy_vrss": "-3000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.17",
+ "acml_vol": "1816647",
+ "acml_tr_pbmn": "100978675300",
+ "tday_rsfl_rate": "4.66",
+ "prdy_vrss_vol": "12633",
+ "tr_pbmn_tnrt": "0.63",
+ "hts_avls": "160796",
+ "etf_cnfg_issu_avls": "22055000",
+ "etf_cnfg_issu_rlim": "1.20",
+ "etf_vltn_amt": "23258000"
+ },
+ {
+ "stck_shrn_iscd": "028260",
+ "hts_kor_isnm": "삼성물산",
+ "stck_prpr": "140100",
+ "prdy_vrss": "-6900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.69",
+ "acml_vol": "594987",
+ "acml_tr_pbmn": "83994051400",
+ "tday_rsfl_rate": "4.08",
+ "prdy_vrss_vol": "-140143",
+ "tr_pbmn_tnrt": "0.32",
+ "hts_avls": "260014",
+ "etf_cnfg_issu_avls": "21015000",
+ "etf_cnfg_issu_rlim": "1.14",
+ "etf_vltn_amt": "22050000"
+ },
+ {
+ "stck_shrn_iscd": "373220",
+ "hts_kor_isnm": "LG에너지솔루션",
+ "stck_prpr": "371500",
+ "prdy_vrss": "-8500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.24",
+ "acml_vol": "171804",
+ "acml_tr_pbmn": "64468613500",
+ "tday_rsfl_rate": "2.63",
+ "prdy_vrss_vol": "-169366",
+ "tr_pbmn_tnrt": "0.07",
+ "hts_avls": "869310",
+ "etf_cnfg_issu_avls": "19689500",
+ "etf_cnfg_issu_rlim": "1.07",
+ "etf_vltn_amt": "20140000"
+ },
+ {
+ "stck_shrn_iscd": "207940",
+ "hts_kor_isnm": "삼성바이오로직스",
+ "stck_prpr": "790000",
+ "prdy_vrss": "-5000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.63",
+ "acml_vol": "41087",
+ "acml_tr_pbmn": "32506854000",
+ "tday_rsfl_rate": "1.76",
+ "prdy_vrss_vol": "-20146",
+ "tr_pbmn_tnrt": "0.06",
+ "hts_avls": "562275",
+ "etf_cnfg_issu_avls": "18960000",
+ "etf_cnfg_issu_rlim": "1.03",
+ "etf_vltn_amt": "19080000"
+ },
+ {
+ "stck_shrn_iscd": "066570",
+ "hts_kor_isnm": "LG전자",
+ "stck_prpr": "93500",
+ "prdy_vrss": "-2900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.01",
+ "acml_vol": "906616",
+ "acml_tr_pbmn": "85249832600",
+ "tday_rsfl_rate": "2.80",
+ "prdy_vrss_vol": "326913",
+ "tr_pbmn_tnrt": "0.56",
+ "hts_avls": "153011",
+ "etf_cnfg_issu_avls": "15427500",
+ "etf_cnfg_issu_rlim": "0.84",
+ "etf_vltn_amt": "15906000"
+ },
+ {
+ "stck_shrn_iscd": "316140",
+ "hts_kor_isnm": "우리금융지주",
+ "stck_prpr": "13410",
+ "prdy_vrss": "-360",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.61",
+ "acml_vol": "2599188",
+ "acml_tr_pbmn": "34967766860",
+ "tday_rsfl_rate": "2.61",
+ "prdy_vrss_vol": "-646133",
+ "tr_pbmn_tnrt": "0.35",
+ "hts_avls": "99582",
+ "etf_cnfg_issu_avls": "13973220",
+ "etf_cnfg_issu_rlim": "0.76",
+ "etf_vltn_amt": "14348340"
+ },
+ {
+ "stck_shrn_iscd": "000810",
+ "hts_kor_isnm": "삼성화재",
+ "stck_prpr": "288500",
+ "prdy_vrss": "-6500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.20",
+ "acml_vol": "131889",
+ "acml_tr_pbmn": "37752099000",
+ "tday_rsfl_rate": "3.73",
+ "prdy_vrss_vol": "-67056",
+ "tr_pbmn_tnrt": "0.28",
+ "hts_avls": "136676",
+ "etf_cnfg_issu_avls": "13848000",
+ "etf_cnfg_issu_rlim": "0.75",
+ "etf_vltn_amt": "14160000"
+ },
+ {
+ "stck_shrn_iscd": "033780",
+ "hts_kor_isnm": "KT&G",
+ "stck_prpr": "88300",
+ "prdy_vrss": "-2200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.43",
+ "acml_vol": "297711",
+ "acml_tr_pbmn": "26378868700",
+ "tday_rsfl_rate": "1.88",
+ "prdy_vrss_vol": "-17817",
+ "tr_pbmn_tnrt": "0.23",
+ "hts_avls": "115075",
+ "etf_cnfg_issu_avls": "13333300",
+ "etf_cnfg_issu_rlim": "0.72",
+ "etf_vltn_amt": "13665500"
+ },
+ {
+ "stck_shrn_iscd": "009150",
+ "hts_kor_isnm": "삼성전기",
+ "stck_prpr": "157700",
+ "prdy_vrss": "1200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.77",
+ "acml_vol": "418178",
+ "acml_tr_pbmn": "66112119600",
+ "tday_rsfl_rate": "2.81",
+ "prdy_vrss_vol": "40454",
+ "tr_pbmn_tnrt": "0.56",
+ "hts_avls": "117792",
+ "etf_cnfg_issu_avls": "13246800",
+ "etf_cnfg_issu_rlim": "0.72",
+ "etf_vltn_amt": "13146000"
+ },
+ {
+ "stck_shrn_iscd": "323410",
+ "hts_kor_isnm": "카카오뱅크",
+ "stck_prpr": "24850",
+ "prdy_vrss": "-1300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.97",
+ "acml_vol": "1142001",
+ "acml_tr_pbmn": "28599812250",
+ "tday_rsfl_rate": "4.21",
+ "prdy_vrss_vol": "147850",
+ "tr_pbmn_tnrt": "0.24",
+ "hts_avls": "118515",
+ "etf_cnfg_issu_avls": "12822600",
+ "etf_cnfg_issu_rlim": "0.70",
+ "etf_vltn_amt": "13493400"
+ },
+ {
+ "stck_shrn_iscd": "138040",
+ "hts_kor_isnm": "메리츠금융지주",
+ "stck_prpr": "78200",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.10",
+ "acml_vol": "718495",
+ "acml_tr_pbmn": "56416800000",
+ "tday_rsfl_rate": "5.95",
+ "prdy_vrss_vol": "204312",
+ "tr_pbmn_tnrt": "0.37",
+ "hts_avls": "152233",
+ "etf_cnfg_issu_avls": "11886400",
+ "etf_cnfg_issu_rlim": "0.65",
+ "etf_vltn_amt": "12266400"
+ },
+ {
+ "stck_shrn_iscd": "030200",
+ "hts_kor_isnm": "KT",
+ "stck_prpr": "34600",
+ "prdy_vrss": "-800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.26",
+ "acml_vol": "911564",
+ "acml_tr_pbmn": "31586950850",
+ "tday_rsfl_rate": "3.25",
+ "prdy_vrss_vol": "-211653",
+ "tr_pbmn_tnrt": "0.35",
+ "hts_avls": "88979",
+ "etf_cnfg_issu_avls": "11833200",
+ "etf_cnfg_issu_rlim": "0.64",
+ "etf_vltn_amt": "12106800"
+ },
+ {
+ "stck_shrn_iscd": "017670",
+ "hts_kor_isnm": "SK텔레콤",
+ "stck_prpr": "50500",
+ "prdy_vrss": "-700",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.37",
+ "acml_vol": "583199",
+ "acml_tr_pbmn": "29461595000",
+ "tday_rsfl_rate": "1.95",
+ "prdy_vrss_vol": "-58668",
+ "tr_pbmn_tnrt": "0.27",
+ "hts_avls": "108469",
+ "etf_cnfg_issu_avls": "11413000",
+ "etf_cnfg_issu_rlim": "0.62",
+ "etf_vltn_amt": "11571200"
+ },
+ {
+ "stck_shrn_iscd": "402340",
+ "hts_kor_isnm": "SK스퀘어",
+ "stck_prpr": "77900",
+ "prdy_vrss": "4800",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.57",
+ "acml_vol": "642164",
+ "acml_tr_pbmn": "49780422500",
+ "tday_rsfl_rate": "9.58",
+ "prdy_vrss_vol": "141092",
+ "tr_pbmn_tnrt": "0.46",
+ "hts_avls": "108266",
+ "etf_cnfg_issu_avls": "11373400",
+ "etf_cnfg_issu_rlim": "0.62",
+ "etf_vltn_amt": "10672600"
+ },
+ {
+ "stck_shrn_iscd": "012450",
+ "hts_kor_isnm": "한화에어로스페이스",
+ "stck_prpr": "217000",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.40",
+ "acml_vol": "466379",
+ "acml_tr_pbmn": "100879357000",
+ "tday_rsfl_rate": "3.97",
+ "prdy_vrss_vol": "-59982",
+ "tr_pbmn_tnrt": "0.92",
+ "hts_avls": "109867",
+ "etf_cnfg_issu_avls": "11284000",
+ "etf_cnfg_issu_rlim": "0.61",
+ "etf_vltn_amt": "11128000"
+ },
+ {
+ "stck_shrn_iscd": "003670",
+ "hts_kor_isnm": "포스코퓨처엠",
+ "stck_prpr": "268000",
+ "prdy_vrss": "-14500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.13",
+ "acml_vol": "371604",
+ "acml_tr_pbmn": "101346274000",
+ "tday_rsfl_rate": "5.31",
+ "prdy_vrss_vol": "106492",
+ "tr_pbmn_tnrt": "0.49",
+ "hts_avls": "207601",
+ "etf_cnfg_issu_avls": "10988000",
+ "etf_cnfg_issu_rlim": "0.60",
+ "etf_vltn_amt": "11582500"
+ },
+ {
+ "stck_shrn_iscd": "003550",
+ "hts_kor_isnm": "LG",
+ "stck_prpr": "77600",
+ "prdy_vrss": "-2000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.51",
+ "acml_vol": "421568",
+ "acml_tr_pbmn": "32857335000",
+ "tday_rsfl_rate": "3.39",
+ "prdy_vrss_vol": "62211",
+ "tr_pbmn_tnrt": "0.27",
+ "hts_avls": "122066",
+ "etf_cnfg_issu_avls": "10941600",
+ "etf_cnfg_issu_rlim": "0.59",
+ "etf_vltn_amt": "11223600"
+ },
+ {
+ "stck_shrn_iscd": "259960",
+ "hts_kor_isnm": "크래프톤",
+ "stck_prpr": "238500",
+ "prdy_vrss": "-9000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.64",
+ "acml_vol": "86465",
+ "acml_tr_pbmn": "20865856000",
+ "tday_rsfl_rate": "4.04",
+ "prdy_vrss_vol": "-22704",
+ "tr_pbmn_tnrt": "0.18",
+ "hts_avls": "115349",
+ "etf_cnfg_issu_avls": "10732500",
+ "etf_cnfg_issu_rlim": "0.58",
+ "etf_vltn_amt": "11137500"
+ },
+ {
+ "stck_shrn_iscd": "032830",
+ "hts_kor_isnm": "삼성생명",
+ "stck_prpr": "81100",
+ "prdy_vrss": "-3900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.59",
+ "acml_vol": "642230",
+ "acml_tr_pbmn": "52575516400",
+ "tday_rsfl_rate": "5.76",
+ "prdy_vrss_vol": "-59341",
+ "tr_pbmn_tnrt": "0.32",
+ "hts_avls": "162200",
+ "etf_cnfg_issu_avls": "10380800",
+ "etf_cnfg_issu_rlim": "0.56",
+ "etf_vltn_amt": "10880000"
+ },
+ {
+ "stck_shrn_iscd": "034020",
+ "hts_kor_isnm": "두산에너빌리티",
+ "stck_prpr": "15310",
+ "prdy_vrss": "190",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.26",
+ "acml_vol": "3313182",
+ "acml_tr_pbmn": "50428459700",
+ "tday_rsfl_rate": "2.91",
+ "prdy_vrss_vol": "-5813097",
+ "tr_pbmn_tnrt": "0.51",
+ "hts_avls": "98070",
+ "etf_cnfg_issu_avls": "10012740",
+ "etf_cnfg_issu_rlim": "0.54",
+ "etf_vltn_amt": "9888480"
+ },
+ {
+ "stck_shrn_iscd": "015760",
+ "hts_kor_isnm": "한국전력",
+ "stck_prpr": "20200",
+ "prdy_vrss": "-1100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.16",
+ "acml_vol": "4137251",
+ "acml_tr_pbmn": "84685300850",
+ "tday_rsfl_rate": "5.40",
+ "prdy_vrss_vol": "737190",
+ "tr_pbmn_tnrt": "0.65",
+ "hts_avls": "129677",
+ "etf_cnfg_issu_avls": "9675800",
+ "etf_cnfg_issu_rlim": "0.53",
+ "etf_vltn_amt": "10202700"
+ },
+ {
+ "stck_shrn_iscd": "096770",
+ "hts_kor_isnm": "SK이노베이션",
+ "stck_prpr": "108400",
+ "prdy_vrss": "-2200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.99",
+ "acml_vol": "435485",
+ "acml_tr_pbmn": "47496560900",
+ "tday_rsfl_rate": "2.53",
+ "prdy_vrss_vol": "-416906",
+ "tr_pbmn_tnrt": "0.46",
+ "hts_avls": "103777",
+ "etf_cnfg_issu_avls": "9647600",
+ "etf_cnfg_issu_rlim": "0.52",
+ "etf_vltn_amt": "9843400"
+ },
+ {
+ "stck_shrn_iscd": "010140",
+ "hts_kor_isnm": "삼성중공업",
+ "stck_prpr": "8910",
+ "prdy_vrss": "410",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.82",
+ "acml_vol": "10237108",
+ "acml_tr_pbmn": "90433426630",
+ "tday_rsfl_rate": "6.59",
+ "prdy_vrss_vol": "5960302",
+ "tr_pbmn_tnrt": "1.15",
+ "hts_avls": "78408",
+ "etf_cnfg_issu_avls": "8954550",
+ "etf_cnfg_issu_rlim": "0.49",
+ "etf_vltn_amt": "8542500"
+ },
+ {
+ "stck_shrn_iscd": "034730",
+ "hts_kor_isnm": "SK",
+ "stck_prpr": "161400",
+ "prdy_vrss": "-1200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.74",
+ "acml_vol": "124326",
+ "acml_tr_pbmn": "20057323800",
+ "tday_rsfl_rate": "2.77",
+ "prdy_vrss_vol": "-115492",
+ "tr_pbmn_tnrt": "0.17",
+ "hts_avls": "118142",
+ "etf_cnfg_issu_avls": "8877000",
+ "etf_cnfg_issu_rlim": "0.48",
+ "etf_vltn_amt": "8943000"
+ },
+ {
+ "stck_shrn_iscd": "018260",
+ "hts_kor_isnm": "삼성에스디에스",
+ "stck_prpr": "151400",
+ "prdy_vrss": "300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.20",
+ "acml_vol": "99997",
+ "acml_tr_pbmn": "15056548600",
+ "tday_rsfl_rate": "2.51",
+ "prdy_vrss_vol": "-94813",
+ "tr_pbmn_tnrt": "0.13",
+ "hts_avls": "117150",
+ "etf_cnfg_issu_avls": "8781200",
+ "etf_cnfg_issu_rlim": "0.48",
+ "etf_vltn_amt": "8763800"
+ },
+ {
+ "stck_shrn_iscd": "009540",
+ "hts_kor_isnm": "HD한국조선해양",
+ "stck_prpr": "117600",
+ "prdy_vrss": "1300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.12",
+ "acml_vol": "234901",
+ "acml_tr_pbmn": "27561454600",
+ "tday_rsfl_rate": "4.73",
+ "prdy_vrss_vol": "-38441",
+ "tr_pbmn_tnrt": "0.33",
+ "hts_avls": "83229",
+ "etf_cnfg_issu_avls": "8349600",
+ "etf_cnfg_issu_rlim": "0.45",
+ "etf_vltn_amt": "8257300"
+ },
+ {
+ "stck_shrn_iscd": "010130",
+ "hts_kor_isnm": "고려아연",
+ "stck_prpr": "470500",
+ "prdy_vrss": "-1500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.32",
+ "acml_vol": "41733",
+ "acml_tr_pbmn": "19584722500",
+ "tday_rsfl_rate": "1.69",
+ "prdy_vrss_vol": "-10286",
+ "tr_pbmn_tnrt": "0.20",
+ "hts_avls": "98375",
+ "etf_cnfg_issu_avls": "7998500",
+ "etf_cnfg_issu_rlim": "0.43",
+ "etf_vltn_amt": "8024000"
+ },
+ {
+ "stck_shrn_iscd": "003490",
+ "hts_kor_isnm": "대한항공",
+ "stck_prpr": "20500",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.38",
+ "acml_vol": "842914",
+ "acml_tr_pbmn": "17385214850",
+ "tday_rsfl_rate": "2.14",
+ "prdy_vrss_vol": "-98708",
+ "tr_pbmn_tnrt": "0.23",
+ "hts_avls": "75485",
+ "etf_cnfg_issu_avls": "7933500",
+ "etf_cnfg_issu_rlim": "0.43",
+ "etf_vltn_amt": "8127000"
+ },
+ {
+ "stck_shrn_iscd": "267260",
+ "hts_kor_isnm": "HD현대일렉트릭",
+ "stck_prpr": "235000",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.29",
+ "acml_vol": "1262526",
+ "acml_tr_pbmn": "306921768500",
+ "tday_rsfl_rate": "17.89",
+ "prdy_vrss_vol": "450052",
+ "tr_pbmn_tnrt": "3.62",
+ "hts_avls": "84711",
+ "etf_cnfg_issu_avls": "7285000",
+ "etf_cnfg_issu_rlim": "0.40",
+ "etf_vltn_amt": "7192000"
+ },
+ {
+ "stck_shrn_iscd": "011200",
+ "hts_kor_isnm": "HMM",
+ "stck_prpr": "15380",
+ "prdy_vrss": "-220",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.41",
+ "acml_vol": "1459194",
+ "acml_tr_pbmn": "22389748170",
+ "tday_rsfl_rate": "3.27",
+ "prdy_vrss_vol": "-303696",
+ "tr_pbmn_tnrt": "0.21",
+ "hts_avls": "105974",
+ "etf_cnfg_issu_avls": "6936380",
+ "etf_cnfg_issu_rlim": "0.38",
+ "etf_vltn_amt": "7035600"
+ },
+ {
+ "stck_shrn_iscd": "000100",
+ "hts_kor_isnm": "유한양행",
+ "stck_prpr": "71200",
+ "prdy_vrss": "2000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.89",
+ "acml_vol": "353495",
+ "acml_tr_pbmn": "25012292500",
+ "tday_rsfl_rate": "3.76",
+ "prdy_vrss_vol": "-29138",
+ "tr_pbmn_tnrt": "0.44",
+ "hts_avls": "57109",
+ "etf_cnfg_issu_avls": "6550400",
+ "etf_cnfg_issu_rlim": "0.36",
+ "etf_vltn_amt": "6366400"
+ },
+ {
+ "stck_shrn_iscd": "161390",
+ "hts_kor_isnm": "한국타이어앤테크놀로지",
+ "stck_prpr": "59800",
+ "prdy_vrss": "-700",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.16",
+ "acml_vol": "232184",
+ "acml_tr_pbmn": "13963274600",
+ "tday_rsfl_rate": "3.64",
+ "prdy_vrss_vol": "-318186",
+ "tr_pbmn_tnrt": "0.19",
+ "hts_avls": "74077",
+ "etf_cnfg_issu_avls": "6518200",
+ "etf_cnfg_issu_rlim": "0.35",
+ "etf_vltn_amt": "6594500"
+ },
+ {
+ "stck_shrn_iscd": "090430",
+ "hts_kor_isnm": "아모레퍼시픽",
+ "stck_prpr": "135000",
+ "prdy_vrss": "7600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.97",
+ "acml_vol": "351097",
+ "acml_tr_pbmn": "47076583200",
+ "tday_rsfl_rate": "8.01",
+ "prdy_vrss_vol": "102372",
+ "tr_pbmn_tnrt": "0.60",
+ "hts_avls": "78965",
+ "etf_cnfg_issu_avls": "6345000",
+ "etf_cnfg_issu_rlim": "0.34",
+ "etf_vltn_amt": "5987800"
+ },
+ {
+ "stck_shrn_iscd": "352820",
+ "hts_kor_isnm": "하이브",
+ "stck_prpr": "213000",
+ "prdy_vrss": "-3500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.62",
+ "acml_vol": "169056",
+ "acml_tr_pbmn": "36344402500",
+ "tday_rsfl_rate": "3.93",
+ "prdy_vrss_vol": "-37279",
+ "tr_pbmn_tnrt": "0.41",
+ "hts_avls": "88719",
+ "etf_cnfg_issu_avls": "5964000",
+ "etf_cnfg_issu_rlim": "0.32",
+ "etf_vltn_amt": "6062000"
+ },
+ {
+ "stck_shrn_iscd": "028050",
+ "hts_kor_isnm": "삼성E&A",
+ "stck_prpr": "24950",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.20",
+ "acml_vol": "520991",
+ "acml_tr_pbmn": "13051679850",
+ "tday_rsfl_rate": "2.20",
+ "prdy_vrss_vol": "-398376",
+ "tr_pbmn_tnrt": "0.27",
+ "hts_avls": "48902",
+ "etf_cnfg_issu_avls": "5963050",
+ "etf_cnfg_issu_rlim": "0.32",
+ "etf_vltn_amt": "5975000"
+ },
+ {
+ "stck_shrn_iscd": "005830",
+ "hts_kor_isnm": "DB손해보험",
+ "stck_prpr": "88100",
+ "prdy_vrss": "-7400",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-7.75",
+ "acml_vol": "267078",
+ "acml_tr_pbmn": "23699343200",
+ "tday_rsfl_rate": "7.85",
+ "prdy_vrss_vol": "26008",
+ "tr_pbmn_tnrt": "0.38",
+ "hts_avls": "62375",
+ "etf_cnfg_issu_avls": "5902700",
+ "etf_cnfg_issu_rlim": "0.32",
+ "etf_vltn_amt": "6398500"
+ },
+ {
+ "stck_shrn_iscd": "024110",
+ "hts_kor_isnm": "기업은행",
+ "stck_prpr": "12740",
+ "prdy_vrss": "-360",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.75",
+ "acml_vol": "1773632",
+ "acml_tr_pbmn": "22730534060",
+ "tday_rsfl_rate": "2.98",
+ "prdy_vrss_vol": "149508",
+ "tr_pbmn_tnrt": "0.22",
+ "hts_avls": "101592",
+ "etf_cnfg_issu_avls": "5261620",
+ "etf_cnfg_issu_rlim": "0.29",
+ "etf_vltn_amt": "5410300"
+ },
+ {
+ "stck_shrn_iscd": "047810",
+ "hts_kor_isnm": "한국항공우주",
+ "stck_prpr": "48600",
+ "prdy_vrss": "-1050",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.11",
+ "acml_vol": "408379",
+ "acml_tr_pbmn": "19958527850",
+ "tday_rsfl_rate": "2.01",
+ "prdy_vrss_vol": "27622",
+ "tr_pbmn_tnrt": "0.42",
+ "hts_avls": "47373",
+ "etf_cnfg_issu_avls": "5200200",
+ "etf_cnfg_issu_rlim": "0.28",
+ "etf_vltn_amt": "5312550"
+ },
+ {
+ "stck_shrn_iscd": "051900",
+ "hts_kor_isnm": "LG생활건강",
+ "stck_prpr": "368000",
+ "prdy_vrss": "15000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.25",
+ "acml_vol": "83736",
+ "acml_tr_pbmn": "30575342500",
+ "tday_rsfl_rate": "4.96",
+ "prdy_vrss_vol": "2995",
+ "tr_pbmn_tnrt": "0.53",
+ "hts_avls": "57475",
+ "etf_cnfg_issu_avls": "5152000",
+ "etf_cnfg_issu_rlim": "0.28",
+ "etf_vltn_amt": "4942000"
+ },
+ {
+ "stck_shrn_iscd": "001570",
+ "hts_kor_isnm": "금양",
+ "stck_prpr": "101000",
+ "prdy_vrss": "-3800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.63",
+ "acml_vol": "459491",
+ "acml_tr_pbmn": "47017893700",
+ "tday_rsfl_rate": "3.82",
+ "prdy_vrss_vol": "120901",
+ "tr_pbmn_tnrt": "0.80",
+ "hts_avls": "58631",
+ "etf_cnfg_issu_avls": "5050000",
+ "etf_cnfg_issu_rlim": "0.27",
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/031_v1_국내주식-025_주식현재가-시간외시간별체결.md b/docs/broker/kis/rest/국내주식/기본시세/031_v1_국내주식-025_주식현재가-시간외시간별체결.md
new file mode 100644
index 0000000..985d826
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/031_v1_국내주식-025_주식현재가-시간외시간별체결.md
@@ -0,0 +1,167 @@
+# 주식현재가 시간외시간별체결
+
+- 원본 시트명: 주식현재가 시간외시간별체결
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-025
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02310000
+- 모의 TR_ID: FHPST02310000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-overtimeconclusion
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 시간외시간별체결 API입니다.
+한국투자 HTS(eFriend Plus) > [0231] 시간외 시간별체결의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
FHPST02310000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J : 주식, ETF, ETN |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+| FID_HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 5 | 1 : 시간외 (Default) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | N | | 기본정보 |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
+| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | N | 18 | |
+| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | N | 18 | |
+| ovtm_untp_llam | 시간외 단일가 하한가 | string | N | 18 | |
+| ovtm_untp_oprc | 시간외 단일가 시가2 | string | N | 10 | |
+| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | N | 10 | |
+| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | N | 10 | |
+| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | N | 10 | |
+| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | N | 10 | |
+| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | N | 1 | |
+| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | N | 11 | |
+| ovtm_untp_antc_vol | 시간외 단일가 예상 거래량 | string | N | 18 | |
+| uplm_sign | 상한 부호 | string | N | 1 | |
+| lslm_sign | 하한 부호 | string | N | 1 | |
+| output2 | 응답상세2 | object array | N | | Array 시간별체결 정보 |
+| stck_cntg_hour | 주식 체결 시간 | string | N | 6 | |
+| stck_prpr | 주식 현재가 | string | N | 10 | |
+| prdy_vrss | 전일 대비 | string | N | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
+| prdy_ctrt | 전일 대비율 | string | N | 11 | |
+| askp | 매도호가 | string | N | 10 | |
+| bidp | 매수호가 | string | N | 10 | |
+| acml_vol | 누적 거래량 | string | N | 18 | |
+| cntg_vol | 체결 거래량 | string | N | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "J",
+ "fid_hour_CLS_CODE": "1",
+ "fid_input_iscd": "018000"
+ }
+```
+
+### Response Example
+
+```text
+"output1": {
+ "lslm_sign": "4",
+ "ovtm_untp_antc_cnpr": "0",
+ "ovtm_untp_antc_cntg_ctrt": "0.00",
+ "ovtm_untp_antc_cntg_vrss": "0",
+ "ovtm_untp_antc_cntg_vrss_sign": "3",
+ "ovtm_untp_antc_vol": "0",
+ "ovtm_untp_hgpr": "2900",
+ "ovtm_untp_llam": "2615",
+ "ovtm_untp_lwpr": "2835",
+ "ovtm_untp_mxpr": "3195",
+ "ovtm_untp_oprc": "2900",
+ "ovtm_untp_prdy_ctrt": "-2.41",
+ "ovtm_untp_prdy_vrss": "-70",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prpr": "2835",
+ "ovtm_untp_tr_pbmn": "194135625",
+ "ovtm_untp_vol": "68086",
+ "uplm_sign": "1"
+ },
+ "output2": [
+ {
+ "acml_vol": "68086",
+ "askp": "2840",
+ "bidp": "2835",
+ "cntg_vol": "12865",
+ "prdy_ctrt": "-2.41",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "180025",
+ "stck_prpr": "2835"
+ },
+ {
+ "acml_vol": "55221",
+ "askp": "2840",
+ "bidp": "2835",
+ "cntg_vol": "6852",
+ "prdy_ctrt": "-2.24",
+ "prdy_vrss": "-65",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "175026",
+ "stck_prpr": "2840"
+ },
+....
+ {
+ "acml_vol": "668",
+ "askp": "2900",
+ "bidp": "2895",
+ "cntg_vol": "668",
+ "prdy_ctrt": "-0.17",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "161022",
+ "stck_prpr": "2900"
+ }
+ ],
+ "rt_cd": "0"
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/032_v1_국내주식-069_NAV-비교추이종목.md b/docs/broker/kis/rest/국내주식/기본시세/032_v1_국내주식-069_NAV-비교추이종목.md
new file mode 100644
index 0000000..5bbdf76
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/032_v1_국내주식-069_NAV-비교추이종목.md
@@ -0,0 +1,130 @@
+# NAV 비교추이(종목)
+
+- 원본 시트명: NAV 비교추이(종목)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-069
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02440000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/etfetn/v1/quotations/nav-comparison-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+NAV 비교추이(종목) API입니다.
+한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02440000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| stck_prpr | 주식 현재가 | string | Y | 8 | |
+| prdy_vrss | 전일 대비 | string | Y | 8 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 2 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 4 | |
+| acml_vol | 누적 거래량 | string | Y | 12 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 60 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| stck_mxpr | 주식 상한가 | string | Y | 10 | |
+| stck_llam | 주식 하한가 | string | Y | 10 | |
+| output2 | 응답상세 | object | Y | | |
+| nav | NAV | string | Y | 11 | |
+| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
+| nav_prdy_vrss | NAV 전일 대비 | string | Y | 11 | |
+| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 8 | |
+| prdy_clpr_nav | NAV전일종가 | string | Y | 11 | |
+| oprc_nav | NAV시가 | string | Y | 11 | |
+| hprc_nav | NAV고가 | string | Y | 11 | |
+| lprc_nav | NAV저가 | string | Y | 11 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"069500"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "stck_prpr": "36090",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3720111",
+ "acml_tr_pbmn": "134826697200",
+ "stck_prdy_clpr": "35980",
+ "stck_oprc": "36300",
+ "stck_hgpr": "36510",
+ "stck_lwpr": "36040",
+ "stck_mxpr": "46770",
+ "stck_llam": "25190"
+ },
+ "output2": {
+ "nav": "36127.30",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "91.08",
+ "nav_prdy_ctrt": "0.25",
+ "prdy_clpr_nav": "36036.22",
+ "oprc_nav": "36065.99",
+ "hprc_nav": "36543.62",
+ "lprc_nav": "36065.99"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/033_v1_국내주식-026_주식현재가-시간외일자별주가.md b/docs/broker/kis/rest/국내주식/기본시세/033_v1_국내주식-026_주식현재가-시간외일자별주가.md
new file mode 100644
index 0000000..fa644a9
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/033_v1_국내주식-026_주식현재가-시간외일자별주가.md
@@ -0,0 +1,170 @@
+# 주식현재가 시간외일자별주가
+
+- 원본 시트명: 주식현재가 시간외일자별주가
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-026
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02320000
+- 모의 TR_ID: FHPST02320000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-overtimeprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 시간외일자별주가 API입니다. (최근일 30건만 조회 가능)
+한국투자 HTS(eFriend Plus) > [0232] 시간외 일자별주가의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요!) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
FHPST02320000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J : 주식, ETF, ETN |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | N | | 기본정보 |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | 11(8.2) |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
+| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | N | 18 | |
+| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | N | 18 | |
+| ovtm_untp_llam | 시간외 단일가 하한가 | string | N | 18 | |
+| ovtm_untp_oprc | 시간외 단일가 시가2 | string | N | 10 | |
+| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | N | 10 | |
+| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | N | 10 | |
+| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | N | 10 | |
+| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | N | 10 | |
+| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | N | 1 | |
+| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | N | 11 | 11(8.2) |
+| ovtm_untp_antc_vol | 시간외 단일가 예상 거래량 | string | N | 18 | |
+| output2 | 응답상세2 | object array | N | | Array 일자별 정보 |
+| stck_bsop_date | 주식 영업 일자 | string | N | 8 | |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | 11(8.2) |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
+| stck_clpr | 주식 종가 | string | N | 10 | |
+| prdy_vrss | 전일 대비 | string | N | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
+| prdy_ctrt | 전일 대비율 | string | N | 11 | 11(8.2) |
+| acml_vol | 누적 거래량 | string | N | 18 | |
+| ovtm_untp_tr_pbmn | 시간외 단일가 거래대금 | string | N | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+'"input": {'
+ '"fid_cond_mrkt_div_code":"J"'
+ ','
+ '"fid_input_iscd":"000660"'
+ '}'
+```
+
+### Response Example
+
+```text
+"output1": {
+ "ovtm_untp_antc_cnpr": "0",
+ "ovtm_untp_antc_cntg_ctrt": "0.00",
+ "ovtm_untp_antc_cntg_vrss": "0",
+ "ovtm_untp_antc_cntg_vrss_sign": "3",
+ "ovtm_untp_antc_vol": "0",
+ "ovtm_untp_hgpr": "106000",
+ "ovtm_untp_llam": "95000",
+ "ovtm_untp_lwpr": "105500",
+ "ovtm_untp_mxpr": "116000",
+ "ovtm_untp_oprc": "0",
+ "ovtm_untp_prdy_ctrt": "0.47",
+ "ovtm_untp_prdy_vrss": "500",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prpr": "106000",
+ "ovtm_untp_tr_pbmn": "1348318000",
+ "ovtm_untp_vol": "12740"
+ },
+ "output2": [
+ {
+ "acml_vol": "4640744",
+ "ovtm_untp_prdy_ctrt": "0.47",
+ "ovtm_untp_prdy_vrss": "500",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prpr": "106000",
+ "ovtm_untp_tr_pbmn": "1348318000",
+ "ovtm_untp_vol": "12740",
+ "prdy_ctrt": "-0.47",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "stck_bsop_date": "20220609",
+ "stck_clpr": "105500"
+ },
+ {
+ "acml_vol": "3075530",
+ "ovtm_untp_prdy_ctrt": "0.47",
+ "ovtm_untp_prdy_vrss": "500",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prpr": "106500",
+ "ovtm_untp_tr_pbmn": "1882068000",
+ "ovtm_untp_vol": "17672",
+ "prdy_ctrt": "1.92",
+ "prdy_vrss": "2000",
+......
+ {
+ "acml_vol": "2969516",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prpr": "111000",
+ "ovtm_untp_tr_pbmn": "2273650500",
+ "ovtm_untp_vol": "20565",
+ "prdy_ctrt": "2.78",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "stck_bsop_date": "20220426",
+ "stck_clpr": "111000"
+ }
+ ],
+ "rt_cd": "0"
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/034_국내주식-077_국내주식-시간외호가.md b/docs/broker/kis/rest/국내주식/기본시세/034_국내주식-077_국내주식-시간외호가.md
new file mode 100644
index 0000000..b15a859
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/034_국내주식-077_국내주식-시간외호가.md
@@ -0,0 +1,219 @@
+# 국내주식 시간외호가
+
+- 원본 시트명: 국내주식 시간외호가
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: 국내주식-077
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02300400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-overtime-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외호가 API입니다.
+한국투자 HTS(eFriend Plus) > [0230] 시간외 현재가 화면의 '호가' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02300400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ovtm_untp_last_hour | 시간외 단일가 최종 시간 | string | Y | 6 | |
+| ovtm_untp_askp1 | 시간외 단일가 매도호가1 | string | Y | 10 | |
+| ovtm_untp_askp2 | 시간외 단일가 매도호가2 | string | Y | 10 | |
+| ovtm_untp_askp3 | 시간외 단일가 매도호가3 | string | Y | 10 | |
+| ovtm_untp_askp4 | 시간외 단일가 매도호가4 | string | Y | 10 | |
+| ovtm_untp_askp5 | 시간외 단일가 매도호가5 | string | Y | 10 | |
+| ovtm_untp_askp6 | 시간외 단일가 매도호가6 | string | Y | 10 | |
+| ovtm_untp_askp7 | 시간외 단일가 매도호가7 | string | Y | 10 | |
+| ovtm_untp_askp8 | 시간외 단일가 매도호가8 | string | Y | 10 | |
+| ovtm_untp_askp9 | 시간외 단일가 매도호가9 | string | Y | 10 | |
+| ovtm_untp_askp10 | 시간외 단일가 매도호가10 | string | Y | 10 | |
+| ovtm_untp_bidp1 | 시간외 단일가 매수호가1 | string | Y | 10 | |
+| ovtm_untp_bidp2 | 시간외 단일가 매수호가2 | string | Y | 10 | |
+| ovtm_untp_bidp3 | 시간외 단일가 매수호가3 | string | Y | 10 | |
+| ovtm_untp_bidp4 | 시간외 단일가 매수호가4 | string | Y | 10 | |
+| ovtm_untp_bidp5 | 시간외 단일가 매수호가5 | string | Y | 10 | |
+| ovtm_untp_bidp6 | 시간외 단일가 매수호가6 | string | Y | 10 | |
+| ovtm_untp_bidp7 | 시간외 단일가 매수호가7 | string | Y | 10 | |
+| ovtm_untp_bidp8 | 시간외 단일가 매수호가8 | string | Y | 10 | |
+| ovtm_untp_bidp9 | 시간외 단일가 매수호가9 | string | Y | 10 | |
+| ovtm_untp_bidp10 | 시간외 단일가 매수호가10 | string | Y | 10 | |
+| ovtm_untp_askp_icdc1 | 시간외 단일가 매도호가 증감1 | string | Y | 10 | |
+| ovtm_untp_askp_icdc2 | 시간외 단일가 매도호가 증감2 | string | Y | 10 | |
+| ovtm_untp_askp_icdc3 | 시간외 단일가 매도호가 증감3 | string | Y | 10 | |
+| ovtm_untp_askp_icdc4 | 시간외 단일가 매도호가 증감4 | string | Y | 10 | |
+| ovtm_untp_askp_icdc5 | 시간외 단일가 매도호가 증감5 | string | Y | 10 | |
+| ovtm_untp_askp_icdc6 | 시간외 단일가 매도호가 증감6 | string | Y | 10 | |
+| ovtm_untp_askp_icdc7 | 시간외 단일가 매도호가 증감7 | string | Y | 10 | |
+| ovtm_untp_askp_icdc8 | 시간외 단일가 매도호가 증감8 | string | Y | 10 | |
+| ovtm_untp_askp_icdc9 | 시간외 단일가 매도호가 증감9 | string | Y | 10 | |
+| ovtm_untp_askp_icdc10 | 시간외 단일가 매도호가 증감10 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc1 | 시간외 단일가 매수호가 증감1 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc2 | 시간외 단일가 매수호가 증감2 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc3 | 시간외 단일가 매수호가 증감3 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc4 | 시간외 단일가 매수호가 증감4 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc5 | 시간외 단일가 매수호가 증감5 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc6 | 시간외 단일가 매수호가 증감6 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc7 | 시간외 단일가 매수호가 증감7 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc8 | 시간외 단일가 매수호가 증감8 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc9 | 시간외 단일가 매수호가 증감9 | string | Y | 10 | |
+| ovtm_untp_bidp_icdc10 | 시간외 단일가 매수호가 증감10 | string | Y | 10 | |
+| ovtm_untp_askp_rsqn1 | 시간외 단일가 매도호가 잔량1 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn2 | 시간외 단일가 매도호가 잔량2 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn3 | 시간외 단일가 매도호가 잔량3 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn4 | 시간외 단일가 매도호가 잔량4 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn5 | 시간외 단일가 매도호가 잔량5 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn6 | 시간외 단일가 매도호가 잔량6 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn7 | 시간외 단일가 매도호가 잔량7 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn8 | 시간외 단일가 매도호가 잔량8 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn9 | 시간외 단일가 매도호가 잔량9 | string | Y | 12 | |
+| ovtm_untp_askp_rsqn10 | 시간외 단일가 매도호가 잔량10 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn1 | 시간외 단일가 매수호가 잔량1 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn2 | 시간외 단일가 매수호가 잔량2 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn3 | 시간외 단일가 매수호가 잔량3 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn4 | 시간외 단일가 매수호가 잔량4 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn5 | 시간외 단일가 매수호가 잔량5 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn6 | 시간외 단일가 매수호가 잔량6 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn7 | 시간외 단일가 매수호가 잔량7 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn8 | 시간외 단일가 매수호가 잔량8 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn9 | 시간외 단일가 매수호가 잔량9 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn10 | 시간외 단일가 매수호가 잔량10 | string | Y | 12 | |
+| ovtm_untp_total_askp_rsqn | 시간외 단일가 총 매도호가 잔량 | string | Y | 12 | |
+| ovtm_untp_total_bidp_rsqn | 시간외 단일가 총 매수호가 잔량 | string | Y | 12 | |
+| ovtm_untp_total_askp_rsqn_icdc | 시간외 단일가 총 매도호가 잔량 | string | Y | 10 | |
+| ovtm_untp_total_bidp_rsqn_icdc | 시간외 단일가 총 매수호가 잔량 | string | Y | 10 | |
+| ovtm_untp_ntby_bidp_rsqn | 시간외 단일가 순매수 호가 잔량 | string | Y | 12 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | string | Y | 10 | |
+| total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | string | Y | 10 | |
+| ovtm_total_askp_rsqn | 시간외 총 매도호가 잔량 | string | Y | 12 | |
+| ovtm_total_bidp_rsqn | 시간외 총 매수호가 잔량 | string | Y | 12 | |
+| ovtm_total_askp_icdc | 시간외 총 매도호가 증감 | string | Y | 10 | |
+| ovtm_total_bidp_icdc | 시간외 총 매수호가 증감 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_input_iscd:005930
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "ovtm_untp_last_hour": "161847",
+ "ovtm_untp_askp1": "83600",
+ "ovtm_untp_askp2": "83700",
+ "ovtm_untp_askp3": "83800",
+ "ovtm_untp_askp4": "0",
+ "ovtm_untp_askp5": "0",
+ "ovtm_untp_askp6": "0",
+ "ovtm_untp_askp7": "0",
+ "ovtm_untp_askp8": "0",
+ "ovtm_untp_askp9": "0",
+ "ovtm_untp_askp10": "0",
+ "ovtm_untp_bidp1": "83500",
+ "ovtm_untp_bidp2": "83400",
+ "ovtm_untp_bidp3": "83300",
+ "ovtm_untp_bidp4": "0",
+ "ovtm_untp_bidp5": "0",
+ "ovtm_untp_bidp6": "0",
+ "ovtm_untp_bidp7": "0",
+ "ovtm_untp_bidp8": "0",
+ "ovtm_untp_bidp9": "0",
+ "ovtm_untp_bidp10": "0",
+ "ovtm_untp_askp_icdc1": "0",
+ "ovtm_untp_askp_icdc2": "0",
+ "ovtm_untp_askp_icdc3": "0",
+ "ovtm_untp_bidp_icdc1": "1",
+ "ovtm_untp_bidp_icdc2": "0",
+ "ovtm_untp_bidp_icdc3": "0",
+ "ovtm_untp_askp_rsqn1": "4498",
+ "ovtm_untp_askp_rsqn2": "11671",
+ "ovtm_untp_askp_rsqn3": "9625",
+ "ovtm_untp_askp_rsqn4": "0",
+ "ovtm_untp_askp_rsqn5": "0",
+ "ovtm_untp_askp_rsqn6": "0",
+ "ovtm_untp_askp_rsqn7": "0",
+ "ovtm_untp_askp_rsqn8": "0",
+ "ovtm_untp_askp_rsqn9": "0",
+ "ovtm_untp_askp_rsqn10": "0",
+ "ovtm_untp_bidp_rsqn1": "1219",
+ "ovtm_untp_bidp_rsqn2": "2242",
+ "ovtm_untp_bidp_rsqn3": "5603",
+ "ovtm_untp_bidp_rsqn4": "0",
+ "ovtm_untp_bidp_rsqn5": "0",
+ "ovtm_untp_bidp_rsqn6": "0",
+ "ovtm_untp_bidp_rsqn7": "0",
+ "ovtm_untp_bidp_rsqn8": "0",
+ "ovtm_untp_bidp_rsqn9": "0",
+ "ovtm_untp_bidp_rsqn10": "0",
+ "ovtm_untp_total_askp_rsqn": "25794",
+ "ovtm_untp_total_bidp_rsqn": "9064",
+ "ovtm_untp_total_askp_rsqn_icdc": "0",
+ "ovtm_untp_total_bidp_rsqn_icdc": "1",
+ "ovtm_untp_ntby_bidp_rsqn": "-16730",
+ "total_askp_rsqn": "923970",
+ "total_bidp_rsqn": "756893",
+ "total_askp_rsqn_icdc": "0",
+ "total_bidp_rsqn_icdc": "0",
+ "ovtm_total_askp_rsqn": "36230",
+ "ovtm_total_bidp_rsqn": "0",
+ "ovtm_total_askp_icdc": "0",
+ "ovtm_total_bidp_icdc": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/035_v1_국내주식-023_주식현재가-당일시간대별체결.md b/docs/broker/kis/rest/국내주식/기본시세/035_v1_국내주식-023_주식현재가-당일시간대별체결.md
new file mode 100644
index 0000000..4189336
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/035_v1_국내주식-023_주식현재가-당일시간대별체결.md
@@ -0,0 +1,150 @@
+# 주식현재가 당일시간대별체결
+
+- 원본 시트명: 주식현재가 당일시간대별체결
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-023
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01060000
+- 모의 TR_ID: FHPST01060000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-itemconclusion
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 당일시간대별체결 API입니다.
+
+* FID_INPUT_HOUR_1 를 이용하여 과거시간대 체결데이터 확인 가능
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01060000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 입력시간 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | single |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| output2 | 응답상세 | object | Y | | single |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| stck_pbpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
+| askp | 매도호가 | string | Y | 10 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| tday_rltv | 당일 체결강도 | string | Y | 14 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cnqn | 체결량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "J",
+ "fid_input_hour_1": "141200",
+ "fid_input_iscd": "000660"
+ }
+```
+
+### Response Example
+
+```text
+"output1": {
+ "acml_vol": "2315529",
+ "prdy_ctrt": "-2.80",
+ "prdy_vol": "1638006",
+ "prdy_vrss": "-3000",
+ "prdy_vrss_sign": "5",
+ "rprs_mrkt_kor_name": "KOSPI200",
+ "stck_prpr": "104000"
+ },
+ "output2": [
+ {
+ "acml_vol": "1979727",
+ "askp": "105000",
+ "bidp": "104500",
+ "cnqn": "20",
+ "prdy_ctrt": "-2.34",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "141159",
+ "stck_prpr": "104500",
+ "tday_rltv": "42.43"
+ },
+ {
+ "acml_vol": "1979707",
+ "askp": "105000",
+ "bidp": "104500",
+ "cnqn": "4",
+ "prdy_ctrt": "-2.34",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "141158",
+ "stck_prpr": "104500",
+ "tday_rltv": "42.43"
+ },
+....
+ {
+ "acml_vol": "1979079",
+ "askp": "105000",
+ "bidp": "104500",
+ "cnqn": "92",
+ "prdy_ctrt": "-2.34",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "stck_cntg_hour": "141142",
+ "stck_prpr": "104500",
+ "tday_rltv": "42.44"
+ }
+ ],
+ "rt_cd": "0"
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/036_v1_국내주식-054_주식현재가-시세2.md b/docs/broker/kis/rest/국내주식/기본시세/036_v1_국내주식-054_주식현재가-시세2.md
new file mode 100644
index 0000000..4528b37
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/036_v1_국내주식-054_주식현재가-시세2.md
@@ -0,0 +1,188 @@
+# 주식현재가 시세2
+
+- 원본 시트명: 주식현재가 시세2
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-054
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-price-2
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 시세2 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 000660 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| new_hgpr_lwpr_cls_code | 신 고가 저가 구분 코드 | string | Y | 10 | 특정 경우에만 데이터 출력 |
+| mxpr_llam_cls_code | 상하한가 구분 코드 | string | Y | 10 | 특정 경우에만 데이터 출력 |
+| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
+| stck_mxpr | 주식 상한가 | string | Y | 10 | |
+| elw_pblc_yn | ELW 발행 여부 | string | Y | 1 | |
+| prdy_clpr_vrss_oprc_rate | 전일 종가 대비 시가2 비율 | string | Y | 84 | |
+| crdt_rate | 신용 비율 | string | Y | 84 | |
+| marg_rate | 증거금 비율 | string | Y | 84 | |
+| lwpr_vrss_prpr | 최저가 대비 현재가 | string | Y | 10 | |
+| lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | string | Y | 1 | |
+| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 84 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| hgpr_vrss_prpr | 최고가 대비 현재가 | string | Y | 10 | |
+| hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | string | Y | 1 | |
+| prdy_clpr_vrss_hgpr_rate | 전일 종가 대비 최고가 비율 | string | Y | 84 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| oprc_vrss_prpr | 시가2 대비 현재가 | string | Y | 10 | |
+| oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | string | Y | 1 | |
+| mang_issu_yn | 관리 종목 여부 | string | Y | 1 | |
+| divi_app_cls_code | 동시호가배분처리코드 | string | Y | 2 | 11:매수상한배분 12:매수하한배분 13: 매도상한배분 14:매도하한배분 |
+| short_over_yn | 단기과열여부 | string | Y | 1 | |
+| mrkt_warn_cls_code | 시장경고코드 | string | Y | 2 | 00: 없음 01: 투자주의 02:투자경고 03:투자위험 |
+| invt_caful_yn | 투자유의여부 | string | Y | 1 | |
+| stange_runup_yn | 이상급등여부 | string | Y | 1 | |
+| ssts_hot_yn | 공매도과열 여부 | string | Y | 1 | |
+| low_current_yn | 저유동성 종목 여부 | string | Y | 1 | |
+| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
+| short_over_cls_code | 단기과열구분코드 | string | Y | 10 | |
+| stck_llam | 주식 하한가 | string | Y | 10 | |
+| new_lstn_cls_name | 신규 상장 구분 명 | string | Y | 40 | |
+| vlnt_deal_cls_name | 임의 매매 구분 명 | string | Y | 16 | |
+| flng_cls_name | 락 구분 이름 | string | Y | 40 | 특정 경우에만 데이터 출력 |
+| revl_issu_reas_name | 재평가 종목 사유 명 | string | Y | 40 | 특정 경우에만 데이터 출력 |
+| mrkt_warn_cls_name | 시장 경고 구분 명 | string | Y | 40 | 특정 경우에만 데이터 출력
"투자환기" / "투자경고" |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| insn_pbnt_yn | 불성실 공시 여부 | string | Y | 1 | |
+| fcam_mod_cls_name | 액면가 변경 구분 명 | string | Y | 10 | 특정 경우에만 데이터 출력 |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | |
+| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
+| sltr_yn | 정리매매 여부 | string | Y | 1 | |
+| trht_yn | 거래정지 여부 | string | Y | 1 | |
+| oprc_rang_cont_yn | 시가 범위 연장 여부 | string | Y | 1 | |
+| vlnt_fin_cls_code | 임의 종료 구분 코드 | string | Y | 1 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "rprs_mrkt_kor_name": "KOSPI200",
+ "insn_pbnt_yn": "N",
+ "stck_prpr": "74400",
+ "prdy_vrss": "1000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.36",
+ "acml_tr_pbmn": "276161183000",
+ "acml_vol": "3733708",
+ "prdy_vol": "11160062",
+ "prdy_vrss_vol_rate": "33.46",
+ "bstp_kor_isnm": "전기.전자",
+ "sltr_yn": "N",
+ "mang_issu_yn": "N",
+ "trht_yn": "N",
+ "oprc_rang_cont_yn": "N",
+ "vlnt_fin_cls_code": "N",
+ "stck_prdy_clpr": "73400",
+ "stck_oprc": "73800",
+ "prdy_clpr_vrss_oprc_rate": "0.54",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "600",
+ "stck_hgpr": "74500",
+ "prdy_clpr_vrss_hgpr_rate": "1.50",
+ "hgpr_vrss_prpr_sign": "5",
+ "hgpr_vrss_prpr": "-100",
+ "stck_lwpr": "73500",
+ "prdy_clpr_vrss_lwpr_rate": "0.14",
+ "lwpr_vrss_prpr_sign": "2",
+ "lwpr_vrss_prpr": "900",
+ "marg_rate": "20.00",
+ "crdt_rate": "20.00",
+ "crdt_able_yn": "Y",
+ "elw_pblc_yn": "Y",
+ "stck_mxpr": "95400",
+ "stck_llam": "51400",
+ "bstp_cls_code": "005930",
+ "stck_sdpr": "73400",
+ "vlnt_deal_cls_name": " ",
+ "new_lstn_cls_name": " ",
+ "divi_app_cls_code": " ",
+ "short_over_cls_code": " ",
+ "vi_cls_code": "N",
+ "low_current_yn": "N",
+ "ssts_hot_yn": " ",
+ "stange_runup_yn": "N",
+ "invt_caful_yn": "N",
+ "mrkt_warn_cls_code": "00",
+ "short_over_yn": "N"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/037_국내주식-213_주식일별분봉조회.md b/docs/broker/kis/rest/국내주식/기본시세/037_국내주식-213_주식일별분봉조회.md
new file mode 100644
index 0000000..a1ec00a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/037_국내주식-213_주식일별분봉조회.md
@@ -0,0 +1,155 @@
+# 주식일별분봉조회
+
+- 원본 시트명: 주식일별분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: 국내주식-213
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03010230
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-dailychartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식일별분봉조회 API입니다.
+
+실전계좌의 경우, 한 번의 호출에 최대 120건까지 확인 가능하며,
+FID_INPUT_DATE_1, FID_INPUT_HOUR_1 이용하여 과거일자 분봉조회 가능합니다.
+
+※ 과거 분봉 조회 시, 당사 서버에서 보관하고 있는 만큼의 데이터만 확인이 가능합니다. (최대 1년 분봉 보관)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST03010230 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 입력 시간(ex 13시 130000) |
+| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 2 | 입력 날짜(20241023) |
+| FID_PW_DATA_INCU_YN | 과거 데이터 포함 여부 | string | Y | 2 | |
+| FID_FAKE_TICK_INCU_YN | 허봉 포함 여부 | string | N | 2 | 공백 필수 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_INPUT_ISCD:005930
+FID_INPUT_DATE_1:20241108
+FID_INPUT_HOUR_1:140000
+FID_PW_DATA_INCU_YN:Y
+FID_FAKE_TICK_INCU_YN:N
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.87",
+ "stck_prdy_clpr": "57500",
+ "acml_vol": "13531211",
+ "acml_tr_pbmn": "779692013500",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "57000"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20241108",
+ "stck_cntg_hour": "140000",
+ "stck_prpr": "57300",
+ "stck_oprc": "57300",
+ "stck_hgpr": "57400",
+ "stck_lwpr": "57200",
+ "cntg_vol": "59047",
+ "acml_tr_pbmn": "538940180600"
+ },
+ {
+ "stck_bsop_date": "20241108",
+ "stck_cntg_hour": "135900",
+ "stck_prpr": "57300",
+ "stck_oprc": "57400",
+ "stck_hgpr": "57500",
+ "stck_lwpr": "57300",
+ "cntg_vol": "118619",
+ "acml_tr_pbmn": "535556648100"
+ },
+ ...
+ {
+ "stck_bsop_date": "20241108",
+ "stck_cntg_hour": "120100",
+ "stck_prpr": "57700",
+ "stck_oprc": "57700",
+ "stck_hgpr": "57800",
+ "stck_lwpr": "57700",
+ "cntg_vol": "3856",
+ "acml_tr_pbmn": "357875441100"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/038_v1_국내주식-016_국내주식기간별시세일_주_월_년.md b/docs/broker/kis/rest/국내주식/기본시세/038_v1_국내주식-016_국내주식기간별시세일_주_월_년.md
new file mode 100644
index 0000000..3ba5166
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/038_v1_국내주식-016_국내주식기간별시세일_주_월_년.md
@@ -0,0 +1,182 @@
+# 국내주식기간별시세(일_주_월_년)
+
+- 원본 시트명: 국내주식기간별시세(일_주_월_년)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-016
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03010100
+- 모의 TR_ID: FHKST03010100
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-itemchartprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식기간별시세(일/주/월/년) API입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST03010100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+| FID_INPUT_DATE_1 | 입력 날짜 1 | string | Y | 10 | 조회 시작일자 |
+| FID_INPUT_DATE_2 | 입력 날짜 2 | string | Y | 10 | 조회 종료일자 (최대 100개) |
+| FID_PERIOD_DIV_CODE | 기간분류코드 | string | Y | 32 | D:일봉 W:주봉, M:월봉, Y:년봉 |
+| FID_ORG_ADJ_PRC | 수정주가 원주가 가격 여부 | string | Y | 10 | 0:수정주가 1:원주가 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | single |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| stck_mxpr | 주식 상한가 | string | Y | 10 | |
+| stck_llam | 주식 하한가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| stck_prdy_oprc | 주식 전일 시가 | string | Y | 10 | |
+| stck_prdy_hgpr | 주식 전일 최고가 | string | Y | 10 | |
+| stck_prdy_lwpr | 주식 전일 최저가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| prdy_vrss_vol | 전일 대비 거래량 | string | Y | 18 | |
+| vol_tnrt | 거래량 회전율 | string | Y | 11 | 11(8.2) |
+| stck_fcam | 주식 액면가 | string | Y | 11 | |
+| lstn_stcn | 상장 주수 | string | Y | 18 | |
+| cpfn | 자본금 | string | Y | 22 | |
+| hts_avls | HTS 시가총액 | string | Y | 18 | |
+| per | PER | string | Y | 11 | 11(8.2) |
+| eps | EPS | string | Y | 14 | 14(11.2) |
+| pbr | PBR | string | Y | 11 | 11(8.2) |
+| itewhol_loan_rmnd_ratem | 전체 융자 잔고 비율 | string | Y | 13 | 13(8.4) |
+| output2 | 응답상세 | object array | Y | | Array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| flng_cls_code | 락 구분 코드 | string | Y | 2 | 01 : 권리락
02 : 배당락
03 : 분배락
04 : 권배락
05 : 중간(분기)배당락
06 : 권리중간배당락
07 : 권리분기배당락 |
+| prtt_rate | 분할 비율 | string | Y | 11 | 기준가/전일 종가 |
+| mod_yn | 변경 여부 | string | Y | 1 | 현재 영업일에 체결이 발생하지 않아 시가가 없을경우 Y 로 표시(차트에서 사용) |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| revl_issu_reas | 재평가사유코드 | string | Y | 2 | 00:해당없음
01:회사분할
02:자본감소
03:장기간정지
04:초과분배
05:대규모배당
06:회사분할합병
07:ETN증권병합/분할
08:신종증권기세조정
99:기타 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "J",
+ "fid_input_date_1": "20220411",
+ "fid_input_date_2": "20220509",
+ "fid_input_iscd": "000660",
+ "fid_org_adj_prc": "0",
+ "fid_period_div_code": "D"
+ }
+```
+
+### Response Example
+
+```text
+"msg_cd": "MCA00000",
+ "output1": {
+ "acml_tr_pbmn": "236062833000",
+ "acml_vol": "2106409",
+ "askp": "112500",
+ "bidp": "112000",
+ "cpfn": "36577",
+ "eps": "13190.00",
+ "hts_avls": "815363",
+ "hts_kor_isnm": "SK\ud558\uc774\ub2c9\uc2a4",
+ "itewhol_loan_rmnd_ratem name": "0.32",
+ "lstn_stcn": "728002365",
+ "pbr": "1.26",
+ "per": "8.49",
+ "prdy_ctrt": "0.90",
+ "prdy_vol": "3680049",
+ "prdy_vrss": "1000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss_vol": "-1573640",
+ "stck_fcam": "5000",
+ "stck_hgpr": "113000",
+ "stck_llam": "78000",
+ "stck_lwpr": "111000",
+ "stck_mxpr": "144000",
+ "stck_oprc": "111500",
+ "stck_prdy_clpr": "111000",
+ "stck_prdy_hgpr": "112500",
+ "stck_prdy_lwpr": "110000",
+ "stck_prdy_oprc": "110500",
+ "stck_prpr": "112000",
+ "stck_shrn_iscd": "000660",
+ "vol_tnrt": "0.29"
+ },
+ "output2": [
+ {
+ "acml_tr_pbmn": "237914727500",
+ "acml_vol": "2203472",
+ "flng_cls_code": "00",
+ "mod_yn": "N",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prtt_rate": "0.00",
+ "revl_issu_reas": "",
+ "stck_bsop_date": "20220509",
+ "stck_clpr": "107500",
+ "stck_hgpr": "109000",
+ "stck_lwpr": "106500",
+ "stck_oprc": "107000"
+ },
+....
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/039_v1_국내주식-071_NAV-비교추이일.md b/docs/broker/kis/rest/국내주식/기본시세/039_v1_국내주식-071_NAV-비교추이일.md
new file mode 100644
index 0000000..8f4027a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/039_v1_국내주식-071_NAV-비교추이일.md
@@ -0,0 +1,1095 @@
+# NAV 비교추이(일)
+
+- 원본 시트명: NAV 비교추이(일)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-071
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02440200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: 없음
+- 모의 Domain: 없음
+- URL 명: /uapi/etfetn/v1/quotations/nav-comparison-daily-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+NAV 비교추이(일) API입니다.
+한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면 "일별" 비교추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02440200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_cond_mrkt_div_code | FID 조건 시장 분류 코드 | string | Y | 2 | J 입력 |
+| fid_input_iscd | FID 입력 종목코드 | string | Y | 12 | 종목코드 (6자리) |
+| fid_input_date_1 | FID 입력 날짜1 | string | Y | 10 | 조회 시작일자 (ex. 20240101) |
+| fid_input_date_2 | FID 입력 날짜2 | string | Y | 10 | 조회 종료일자 (ex. 20240220) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| dprt | 괴리율 | string | Y | 82 | |
+| nav_vrss_prpr | NAV 대비 현재가 | string | Y | 112 | |
+| nav | NAV | string | Y | 112 | |
+| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
+| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
+| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"069500",
+"fid_input_date_1":"20240101",
+"fid_input_date_2":"20240220"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240220",
+ "stck_clpr": "35875",
+ "prdy_vrss": "-425",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.17",
+ "acml_vol": "6441149",
+ "cntg_vol": "",
+ "dprt": "-0.21",
+ "nav_vrss_prpr": "-77.09",
+ "nav": "35952.09",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-400.32",
+ "nav_prdy_ctrt": "-1.10"
+ },
+ {
+ "stck_bsop_date": "20240219",
+ "stck_clpr": "36300",
+ "prdy_vrss": "560",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.57",
+ "acml_vol": "6673013",
+ "cntg_vol": "",
+ "dprt": "-0.14",
+ "nav_vrss_prpr": "-52.41",
+ "nav": "36352.41",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "536.42",
+ "nav_prdy_ctrt": "1.50"
+ },
+ {
+ "stck_bsop_date": "20240216",
+ "stck_clpr": "35740",
+ "prdy_vrss": "355",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.00",
+ "acml_vol": "7035777",
+ "cntg_vol": "",
+ "dprt": "-0.21",
+ "nav_vrss_prpr": "-75.99",
+ "nav": "35815.99",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "432.75",
+ "nav_prdy_ctrt": "1.22"
+ },
+ {
+ "stck_bsop_date": "20240215",
+ "stck_clpr": "35385",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.14",
+ "acml_vol": "6137814",
+ "cntg_vol": "",
+ "dprt": "0.00",
+ "nav_vrss_prpr": "1.76",
+ "nav": "35383.24",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-147.98",
+ "nav_prdy_ctrt": "-0.42"
+ },
+ {
+ "stck_bsop_date": "20240214",
+ "stck_clpr": "35435",
+ "prdy_vrss": "-490",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.36",
+ "acml_vol": "7163970",
+ "cntg_vol": "",
+ "dprt": "-0.27",
+ "nav_vrss_prpr": "-96.22",
+ "nav": "35531.22",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-468.25",
+ "nav_prdy_ctrt": "-1.30"
+ },
+ {
+ "stck_bsop_date": "20240213",
+ "stck_clpr": "35925",
+ "prdy_vrss": "435",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.23",
+ "acml_vol": "6108254",
+ "cntg_vol": "",
+ "dprt": "-0.21",
+ "nav_vrss_prpr": "-74.47",
+ "nav": "35999.47",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "407.86",
+ "nav_prdy_ctrt": "1.15"
+ },
+ {
+ "stck_bsop_date": "20240208",
+ "stck_clpr": "35490",
+ "prdy_vrss": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.11",
+ "acml_vol": "6259742",
+ "cntg_vol": "",
+ "dprt": "-0.29",
+ "nav_vrss_prpr": "-101.61",
+ "nav": "35591.61",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "109.10",
+ "nav_prdy_ctrt": "0.31"
+ },
+ {
+ "stck_bsop_date": "20240207",
+ "stck_clpr": "35450",
+ "prdy_vrss": "495",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.42",
+ "acml_vol": "7548365",
+ "cntg_vol": "",
+ "dprt": "-0.09",
+ "nav_vrss_prpr": "-32.51",
+ "nav": "35482.51",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "447.69",
+ "nav_prdy_ctrt": "1.28"
+ },
+ {
+ "stck_bsop_date": "20240206",
+ "stck_clpr": "34955",
+ "prdy_vrss": "-135",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.38",
+ "acml_vol": "9454374",
+ "cntg_vol": "",
+ "dprt": "-0.23",
+ "nav_vrss_prpr": "-79.82",
+ "nav": "35034.82",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-140.20",
+ "nav_prdy_ctrt": "-0.40"
+ },
+ {
+ "stck_bsop_date": "20240205",
+ "stck_clpr": "35090",
+ "prdy_vrss": "-430",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.21",
+ "acml_vol": "11378063",
+ "cntg_vol": "",
+ "dprt": "-0.24",
+ "nav_vrss_prpr": "-85.02",
+ "nav": "35175.02",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-427.65",
+ "nav_prdy_ctrt": "-1.20"
+ },
+ {
+ "stck_bsop_date": "20240202",
+ "stck_clpr": "35520",
+ "prdy_vrss": "1110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.23",
+ "acml_vol": "11476191",
+ "cntg_vol": "",
+ "dprt": "-0.23",
+ "nav_vrss_prpr": "-82.67",
+ "nav": "35602.67",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "1106.53",
+ "nav_prdy_ctrt": "3.21"
+ },
+ {
+ "stck_bsop_date": "20240201",
+ "stck_clpr": "34410",
+ "prdy_vrss": "580",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.71",
+ "acml_vol": "7021653",
+ "cntg_vol": "",
+ "dprt": "-0.25",
+ "nav_vrss_prpr": "-86.14",
+ "nav": "34496.14",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "608.63",
+ "nav_prdy_ctrt": "1.80"
+ },
+ {
+ "stck_bsop_date": "20240131",
+ "stck_clpr": "33830",
+ "prdy_vrss": "-165",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.49",
+ "acml_vol": "8485416",
+ "cntg_vol": "",
+ "dprt": "-0.17",
+ "nav_vrss_prpr": "-57.51",
+ "nav": "33887.51",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-124.46",
+ "nav_prdy_ctrt": "-0.37"
+ },
+ {
+ "stck_bsop_date": "20240130",
+ "stck_clpr": "33995",
+ "prdy_vrss": "-60",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.18",
+ "acml_vol": "7939707",
+ "cntg_vol": "",
+ "dprt": "-0.05",
+ "nav_vrss_prpr": "-16.97",
+ "nav": "34011.97",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-38.87",
+ "nav_prdy_ctrt": "-0.11"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_clpr": "34054",
+ "prdy_vrss": "398",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.19",
+ "acml_vol": "4283579",
+ "cntg_vol": "",
+ "dprt": "0.29",
+ "nav_vrss_prpr": "3.16",
+ "nav": "34050.84",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "267.74",
+ "nav_prdy_ctrt": "0.79"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_clpr": "33656",
+ "prdy_vrss": "59",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.18",
+ "acml_vol": "4543490",
+ "cntg_vol": "",
+ "dprt": "-0.10",
+ "nav_vrss_prpr": "-127.10",
+ "nav": "33783.10",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "42.30",
+ "nav_prdy_ctrt": "0.13"
+ },
+ {
+ "stck_bsop_date": "20240125",
+ "stck_clpr": "33596",
+ "prdy_vrss": "39",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.12",
+ "acml_vol": "7370595",
+ "cntg_vol": "",
+ "dprt": "-0.15",
+ "nav_vrss_prpr": "-144.80",
+ "nav": "33740.80",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "52.50",
+ "nav_prdy_ctrt": "0.16"
+ },
+ {
+ "stck_bsop_date": "20240124",
+ "stck_clpr": "33556",
+ "prdy_vrss": "-129",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.38",
+ "acml_vol": "5469085",
+ "cntg_vol": "",
+ "dprt": "-0.11",
+ "nav_vrss_prpr": "-132.30",
+ "nav": "33688.30",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-167.19",
+ "nav_prdy_ctrt": "-0.49"
+ },
+ {
+ "stck_bsop_date": "20240123",
+ "stck_clpr": "33686",
+ "prdy_vrss": "174",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.52",
+ "acml_vol": "4518601",
+ "cntg_vol": "",
+ "dprt": "-0.22",
+ "nav_vrss_prpr": "-169.49",
+ "nav": "33855.49",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "232.50",
+ "nav_prdy_ctrt": "0.69"
+ },
+ {
+ "stck_bsop_date": "20240122",
+ "stck_clpr": "33511",
+ "prdy_vrss": "34",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.10",
+ "acml_vol": "6779930",
+ "cntg_vol": "",
+ "dprt": "-0.05",
+ "nav_vrss_prpr": "-111.99",
+ "nav": "33622.99",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-33.56",
+ "nav_prdy_ctrt": "-0.10"
+ },
+ {
+ "stck_bsop_date": "20240119",
+ "stck_clpr": "33476",
+ "prdy_vrss": "493",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.50",
+ "acml_vol": "8228124",
+ "cntg_vol": "",
+ "dprt": "-0.26",
+ "nav_vrss_prpr": "-180.55",
+ "nav": "33656.55",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "585.07",
+ "nav_prdy_ctrt": "1.77"
+ },
+ {
+ "stck_bsop_date": "20240118",
+ "stck_clpr": "32982",
+ "prdy_vrss": "154",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.47",
+ "acml_vol": "13010124",
+ "cntg_vol": "",
+ "dprt": "0.01",
+ "nav_vrss_prpr": "-89.48",
+ "nav": "33071.48",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "102.06",
+ "nav_prdy_ctrt": "0.31"
+ },
+ {
+ "stck_bsop_date": "20240117",
+ "stck_clpr": "32828",
+ "prdy_vrss": "-822",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.44",
+ "acml_vol": "13805092",
+ "cntg_vol": "",
+ "dprt": "-0.15",
+ "nav_vrss_prpr": "-141.42",
+ "nav": "32969.42",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-864.88",
+ "nav_prdy_ctrt": "-2.56"
+ },
+ {
+ "stck_bsop_date": "20240116",
+ "stck_clpr": "33651",
+ "prdy_vrss": "-468",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.37",
+ "acml_vol": "6009593",
+ "cntg_vol": "",
+ "dprt": "-0.26",
+ "nav_vrss_prpr": "-183.30",
+ "nav": "33834.30",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-452.30",
+ "nav_prdy_ctrt": "-1.32"
+ },
+ {
+ "stck_bsop_date": "20240115",
+ "stck_clpr": "34119",
+ "prdy_vrss": "144",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.43",
+ "acml_vol": "6335725",
+ "cntg_vol": "",
+ "dprt": "-0.21",
+ "nav_vrss_prpr": "-167.60",
+ "nav": "34286.60",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "102.68",
+ "nav_prdy_ctrt": "0.30"
+ },
+ {
+ "stck_bsop_date": "20240112",
+ "stck_clpr": "33975",
+ "prdy_vrss": "-329",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.96",
+ "acml_vol": "8112877",
+ "cntg_vol": "",
+ "dprt": "-0.33",
+ "nav_vrss_prpr": "-208.92",
+ "nav": "34183.92",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-209.94",
+ "nav_prdy_ctrt": "-0.61"
+ },
+ {
+ "stck_bsop_date": "20240111",
+ "stck_clpr": "34304",
+ "prdy_vrss": "54",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.16",
+ "acml_vol": "5419064",
+ "cntg_vol": "",
+ "dprt": "0.02",
+ "nav_vrss_prpr": "-89.86",
+ "nav": "34393.86",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-36.03",
+ "nav_prdy_ctrt": "-0.10"
+ },
+ {
+ "stck_bsop_date": "20240110",
+ "stck_clpr": "34249",
+ "prdy_vrss": "-378",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.09",
+ "acml_vol": "4018306",
+ "cntg_vol": "",
+ "dprt": "-0.25",
+ "nav_vrss_prpr": "-180.89",
+ "nav": "34429.89",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-317.89",
+ "nav_prdy_ctrt": "-0.91"
+ },
+ {
+ "stck_bsop_date": "20240109",
+ "stck_clpr": "34628",
+ "prdy_vrss": "-129",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.37",
+ "acml_vol": "7533350",
+ "cntg_vol": "",
+ "dprt": "-0.07",
+ "nav_vrss_prpr": "-119.78",
+ "nav": "34747.78",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-174.39",
+ "nav_prdy_ctrt": "-0.50"
+ },
+ {
+ "stck_bsop_date": "20240108",
+ "stck_clpr": "34758",
+ "prdy_vrss": "-114",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.33",
+ "acml_vol": "5377681",
+ "cntg_vol": "",
+ "dprt": "-0.19",
+ "nav_vrss_prpr": "-164.17",
+ "nav": "34922.17",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-164.17",
+ "nav_prdy_ctrt": "-0.47"
+ },
+ {
+ "stck_bsop_date": "20240105",
+ "stck_clpr": "34872",
+ "prdy_vrss": "-99",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.29",
+ "acml_vol": "6681806",
+ "cntg_vol": "",
+ "dprt": "-0.33",
+ "nav_vrss_prpr": "-214.34",
+ "nav": "35086.34",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-85.10",
+ "nav_prdy_ctrt": "-0.24"
+ },
+ {
+ "stck_bsop_date": "20240104",
+ "stck_clpr": "34972",
+ "prdy_vrss": "-309",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.88",
+ "acml_vol": "8904699",
+ "cntg_vol": "",
+ "dprt": "-0.29",
+ "nav_vrss_prpr": "-199.44",
+ "nav": "35171.44",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-315.36",
+ "nav_prdy_ctrt": "-0.89"
+ },
+ {
+ "stck_bsop_date": "20240103",
+ "stck_clpr": "35281",
+ "prdy_vrss": "-1007",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.78",
+ "acml_vol": "8122576",
+ "cntg_vol": "",
+ "dprt": "-0.30",
+ "nav_vrss_prpr": "-205.80",
+ "nav": "35486.80",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-936.81",
+ "nav_prdy_ctrt": "-2.57"
+ },
+ {
+ "stck_bsop_date": "20240102",
+ "stck_clpr": "36288",
+ "prdy_vrss": "219",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.61",
+ "acml_vol": "7440266",
+ "cntg_vol": "",
+ "dprt": "-0.09",
+ "nav_vrss_prpr": "-135.61",
+ "nav": "36423.61",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "253.99",
+ "nav_prdy_ctrt": "0.70"
+ },
+ {
+ "stck_bsop_date": "20231228",
+ "stck_clpr": "36069",
+ "prdy_vrss": "583",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.64",
+ "acml_vol": "10612352",
+ "cntg_vol": "",
+ "dprt": "0.00",
+ "nav_vrss_prpr": "-100.62",
+ "nav": "36169.62",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "557.43",
+ "nav_prdy_ctrt": "1.57"
+ },
+ {
+ "stck_bsop_date": "20231227",
+ "stck_clpr": "35486",
+ "prdy_vrss": "388",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.11",
+ "acml_vol": "10990385",
+ "cntg_vol": "",
+ "dprt": "-0.08",
+ "nav_vrss_prpr": "-126.19",
+ "nav": "35612.19",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "443.80",
+ "nav_prdy_ctrt": "1.26"
+ },
+ {
+ "stck_bsop_date": "20231226",
+ "stck_clpr": "35097",
+ "prdy_vrss": "144",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "2674516",
+ "cntg_vol": "",
+ "dprt": "0.08",
+ "nav_vrss_prpr": "-71.39",
+ "nav": "35168.39",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "126.07",
+ "nav_prdy_ctrt": "0.36"
+ },
+ {
+ "stck_bsop_date": "20231222",
+ "stck_clpr": "34952",
+ "prdy_vrss": "109",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3164234",
+ "cntg_vol": "",
+ "dprt": "0.02",
+ "nav_vrss_prpr": "-90.32",
+ "nav": "35042.32",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "37.36",
+ "nav_prdy_ctrt": "0.11"
+ },
+ {
+ "stck_bsop_date": "20231221",
+ "stck_clpr": "34842",
+ "prdy_vrss": "-229",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.65",
+ "acml_vol": "6328185",
+ "cntg_vol": "",
+ "dprt": "-0.19",
+ "nav_vrss_prpr": "-162.96",
+ "nav": "35004.96",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-132.38",
+ "nav_prdy_ctrt": "-0.38"
+ },
+ {
+ "stck_bsop_date": "20231220",
+ "stck_clpr": "35072",
+ "prdy_vrss": "663",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.93",
+ "acml_vol": "9429470",
+ "cntg_vol": "",
+ "dprt": "0.09",
+ "nav_vrss_prpr": "-65.34",
+ "nav": "35137.34",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "618.66",
+ "nav_prdy_ctrt": "1.79"
+ },
+ {
+ "stck_bsop_date": "20231219",
+ "stck_clpr": "34409",
+ "prdy_vrss": "29",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.09",
+ "acml_vol": "5026536",
+ "cntg_vol": "",
+ "dprt": "-0.04",
+ "nav_vrss_prpr": "-109.68",
+ "nav": "34518.68",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "44.10",
+ "nav_prdy_ctrt": "0.13"
+ },
+ {
+ "stck_bsop_date": "20231218",
+ "stck_clpr": "34379",
+ "prdy_vrss": "109",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.32",
+ "acml_vol": "4144760",
+ "cntg_vol": "",
+ "dprt": "0.00",
+ "nav_vrss_prpr": "-95.58",
+ "nav": "34474.58",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-48.04",
+ "nav_prdy_ctrt": "-0.14"
+ },
+ {
+ "stck_bsop_date": "20231215",
+ "stck_clpr": "34269",
+ "prdy_vrss": "194",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.57",
+ "acml_vol": "6278790",
+ "cntg_vol": "",
+ "dprt": "-0.46",
+ "nav_vrss_prpr": "-253.62",
+ "nav": "34522.62",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "267.35",
+ "nav_prdy_ctrt": "0.78"
+ },
+ {
+ "stck_bsop_date": "20231214",
+ "stck_clpr": "34074",
+ "prdy_vrss": "408",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.21",
+ "acml_vol": "8817261",
+ "cntg_vol": "",
+ "dprt": "-0.25",
+ "nav_vrss_prpr": "-181.27",
+ "nav": "34255.27",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "463.50",
+ "nav_prdy_ctrt": "1.37"
+ },
+ {
+ "stck_bsop_date": "20231213",
+ "stck_clpr": "33666",
+ "prdy_vrss": "-329",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.97",
+ "acml_vol": "3999100",
+ "cntg_vol": "",
+ "dprt": "-0.09",
+ "nav_vrss_prpr": "-125.77",
+ "nav": "33791.77",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-309.47",
+ "nav_prdy_ctrt": "-0.91"
+ },
+ {
+ "stck_bsop_date": "20231212",
+ "stck_clpr": "33995",
+ "prdy_vrss": "139",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "11182364",
+ "cntg_vol": "",
+ "dprt": "-0.03",
+ "nav_vrss_prpr": "-106.24",
+ "nav": "34101.24",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "186.45",
+ "nav_prdy_ctrt": "0.55"
+ },
+ {
+ "stck_bsop_date": "20231211",
+ "stck_clpr": "33855",
+ "prdy_vrss": "114",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.34",
+ "acml_vol": "7051429",
+ "cntg_vol": "",
+ "dprt": "0.10",
+ "nav_vrss_prpr": "-59.79",
+ "nav": "33914.79",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "133.04",
+ "nav_prdy_ctrt": "0.39"
+ },
+ {
+ "stck_bsop_date": "20231208",
+ "stck_clpr": "33740",
+ "prdy_vrss": "483",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.45",
+ "acml_vol": "8622554",
+ "cntg_vol": "",
+ "dprt": "0.16",
+ "nav_vrss_prpr": "-41.75",
+ "nav": "33781.75",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "393.25",
+ "nav_prdy_ctrt": "1.18"
+ },
+ {
+ "stck_bsop_date": "20231207",
+ "stck_clpr": "33257",
+ "prdy_vrss": "-129",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.39",
+ "acml_vol": "9708274",
+ "cntg_vol": "",
+ "dprt": "-0.12",
+ "nav_vrss_prpr": "-131.50",
+ "nav": "33388.50",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-80.08",
+ "nav_prdy_ctrt": "-0.24"
+ },
+ {
+ "stck_bsop_date": "20231206",
+ "stck_clpr": "33386",
+ "prdy_vrss": "109",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "7842575",
+ "cntg_vol": "",
+ "dprt": "0.03",
+ "nav_vrss_prpr": "-82.58",
+ "nav": "33468.58",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "60.53",
+ "nav_prdy_ctrt": "0.18"
+ },
+ {
+ "stck_bsop_date": "20231205",
+ "stck_clpr": "33277",
+ "prdy_vrss": "-368",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.10",
+ "acml_vol": "4362025",
+ "cntg_vol": "",
+ "dprt": "-0.11",
+ "nav_vrss_prpr": "-131.05",
+ "nav": "33408.05",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-331.44",
+ "nav_prdy_ctrt": "-0.98"
+ },
+ {
+ "stck_bsop_date": "20231204",
+ "stck_clpr": "33646",
+ "prdy_vrss": "169",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.51",
+ "acml_vol": "6753956",
+ "cntg_vol": "",
+ "dprt": "0.00",
+ "nav_vrss_prpr": "-93.49",
+ "nav": "33739.49",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.45",
+ "nav_prdy_ctrt": "0.40"
+ },
+ {
+ "stck_bsop_date": "20231201",
+ "stck_clpr": "33476",
+ "prdy_vrss": "-383",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.13",
+ "acml_vol": "5002078",
+ "cntg_vol": "",
+ "dprt": "-0.10",
+ "nav_vrss_prpr": "-129.04",
+ "nav": "33605.04",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-363.63",
+ "nav_prdy_ctrt": "-1.07"
+ },
+ {
+ "stck_bsop_date": "20231130",
+ "stck_clpr": "33860",
+ "prdy_vrss": "194",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.58",
+ "acml_vol": "6853984",
+ "cntg_vol": "",
+ "dprt": "-0.04",
+ "nav_vrss_prpr": "-108.67",
+ "nav": "33968.67",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "181.26",
+ "nav_prdy_ctrt": "0.54"
+ },
+ {
+ "stck_bsop_date": "20231129",
+ "stck_clpr": "33666",
+ "prdy_vrss": "-109",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.32",
+ "acml_vol": "3321521",
+ "cntg_vol": "",
+ "dprt": "-0.08",
+ "nav_vrss_prpr": "-121.41",
+ "nav": "33787.41",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-90.00",
+ "nav_prdy_ctrt": "-0.27"
+ },
+ {
+ "stck_bsop_date": "20231128",
+ "stck_clpr": "33775",
+ "prdy_vrss": "383",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.15",
+ "acml_vol": "4282814",
+ "cntg_vol": "",
+ "dprt": "-0.02",
+ "nav_vrss_prpr": "-102.41",
+ "nav": "33877.41",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "385.31",
+ "nav_prdy_ctrt": "1.15"
+ },
+ {
+ "stck_bsop_date": "20231127",
+ "stck_clpr": "33391",
+ "prdy_vrss": "-39",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.12",
+ "acml_vol": "4330338",
+ "cntg_vol": "",
+ "dprt": "-0.02",
+ "nav_vrss_prpr": "-101.10",
+ "nav": "33492.10",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-33.37",
+ "nav_prdy_ctrt": "-0.10"
+ },
+ {
+ "stck_bsop_date": "20231124",
+ "stck_clpr": "33431",
+ "prdy_vrss": "-264",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.78",
+ "acml_vol": "4927288",
+ "cntg_vol": "",
+ "dprt": "-0.00",
+ "nav_vrss_prpr": "-94.47",
+ "nav": "33525.47",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-292.15",
+ "nav_prdy_ctrt": "-0.86"
+ },
+ {
+ "stck_bsop_date": "20231123",
+ "stck_clpr": "33695",
+ "prdy_vrss": "4",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.01",
+ "acml_vol": "4829299",
+ "cntg_vol": "",
+ "dprt": "-0.08",
+ "nav_vrss_prpr": "-122.62",
+ "nav": "33817.62",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "10.88",
+ "nav_prdy_ctrt": "0.03"
+ },
+ {
+ "stck_bsop_date": "20231122",
+ "stck_clpr": "33691",
+ "prdy_vrss": "59",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.18",
+ "acml_vol": "5625954",
+ "cntg_vol": "",
+ "dprt": "-0.06",
+ "nav_vrss_prpr": "-115.74",
+ "nav": "33806.74",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "23.43",
+ "nav_prdy_ctrt": "0.07"
+ },
+ {
+ "stck_bsop_date": "20231121",
+ "stck_clpr": "33631",
+ "prdy_vrss": "159",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.48",
+ "acml_vol": "7282929",
+ "cntg_vol": "",
+ "dprt": "-0.17",
+ "nav_vrss_prpr": "-152.31",
+ "nav": "33783.31",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "235.05",
+ "nav_prdy_ctrt": "0.70"
+ },
+ {
+ "stck_bsop_date": "20231120",
+ "stck_clpr": "33471",
+ "prdy_vrss": "264",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.80",
+ "acml_vol": "7447159",
+ "cntg_vol": "",
+ "dprt": "0.05",
+ "nav_vrss_prpr": "-77.26",
+ "nav": "33548.26",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "216.76",
+ "nav_prdy_ctrt": "0.65"
+ },
+ {
+ "stck_bsop_date": "20231117",
+ "stck_clpr": "33207",
+ "prdy_vrss": "-169",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.51",
+ "acml_vol": "6027534",
+ "cntg_vol": "",
+ "dprt": "-0.09",
+ "nav_vrss_prpr": "-124.50",
+ "nav": "33331.50",
+ "nav_prdy_vrss_sign": "5",
+ "nav_prdy_vrss": "-225.76",
+ "nav_prdy_ctrt": "-0.67"
+ },
+ {
+ "stck_bsop_date": "20231116",
+ "stck_clpr": "33376",
+ "prdy_vrss": "-24",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.07",
+ "acml_vol": "5482070",
+ "cntg_vol": "",
+ "dprt": "-0.26",
+ "nav_vrss_prpr": "-181.26",
+ "nav": "33557.26",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "35.17",
+ "nav_prdy_ctrt": "0.10"
+ },
+ {
+ "stck_bsop_date": "20231115",
+ "stck_clpr": "33401",
+ "prdy_vrss": "708",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.17",
+ "acml_vol": "9706175",
+ "cntg_vol": "",
+ "dprt": "-0.08",
+ "nav_vrss_prpr": "-121.09",
+ "nav": "33522.09",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "739.73",
+ "nav_prdy_ctrt": "2.26"
+ },
+ {
+ "stck_bsop_date": "20231114",
+ "stck_clpr": "32693",
+ "prdy_vrss": "334",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.03",
+ "acml_vol": "4723626",
+ "cntg_vol": "",
+ "dprt": "0.01",
+ "nav_vrss_prpr": "-89.36",
+ "nav": "32782.36",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "327.59",
+ "nav_prdy_ctrt": "1.01"
+ },
+ {
+ "stck_bsop_date": "20231113",
+ "stck_clpr": "32359",
+ "prdy_vrss": "-24",
+ "prdy_vrss_sign": "5",
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/040_v1_국내주식-011_주식현재가-호가_예상체결.md b/docs/broker/kis/rest/국내주식/기본시세/040_v1_국내주식-011_주식현재가-호가_예상체결.md
new file mode 100644
index 0000000..b17a2f0
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/040_v1_국내주식-011_주식현재가-호가_예상체결.md
@@ -0,0 +1,257 @@
+# 주식현재가 호가_예상체결
+
+- 원본 시트명: 주식현재가 호가_예상체결
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-011
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010200
+- 모의 TR_ID: FHKST01010200
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-asking-price-exp-ccn
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 호가 예상체결 API입니다. 매수 매도 호가를 확인하실 수 있습니다. 실시간 데이터를 원하신다면 웹소켓 API를 활용하세요.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01010200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| aspr_acpt_hour | 호가 접수 시간 | string | Y | 6 | |
+| askp1 | 매도호가1 | string | Y | 10 | |
+| askp2 | 매도호가2 | string | Y | 10 | |
+| askp3 | 매도호가3 | string | Y | 10 | |
+| askp4 | 매도호가4 | string | Y | 10 | |
+| askp5 | 매도호가5 | string | Y | 10 | |
+| askp6 | 매도호가6 | string | Y | 10 | |
+| askp7 | 매도호가7 | string | Y | 10 | |
+| askp8 | 매도호가8 | string | Y | 10 | |
+| askp9 | 매도호가9 | string | Y | 10 | |
+| askp10 | 매도호가10 | string | Y | 10 | |
+| bidp1 | 매수호가1 | string | Y | 10 | |
+| bidp2 | 매수호가2 | string | Y | 10 | |
+| bidp3 | 매수호가3 | string | Y | 10 | |
+| bidp4 | 매수호가4 | string | Y | 10 | |
+| bidp5 | 매수호가5 | string | Y | 10 | |
+| bidp6 | 매수호가6 | string | Y | 10 | |
+| bidp7 | 매수호가7 | string | Y | 10 | |
+| bidp8 | 매수호가8 | string | Y | 10 | |
+| bidp9 | 매수호가9 | string | Y | 10 | |
+| bidp10 | 매수호가10 | string | Y | 10 | |
+| askp_rsqn1 | 매도호가 잔량1 | string | Y | 12 | |
+| askp_rsqn2 | 매도호가 잔량2 | string | Y | 12 | |
+| askp_rsqn3 | 매도호가 잔량3 | string | Y | 12 | |
+| askp_rsqn4 | 매도호가 잔량4 | string | Y | 12 | |
+| askp_rsqn5 | 매도호가 잔량5 | string | Y | 12 | |
+| askp_rsqn6 | 매도호가 잔량6 | string | Y | 12 | |
+| askp_rsqn7 | 매도호가 잔량7 | string | Y | 12 | |
+| askp_rsqn8 | 매도호가 잔량8 | string | Y | 12 | |
+| askp_rsqn9 | 매도호가 잔량9 | string | Y | 12 | |
+| askp_rsqn10 | 매도호가 잔량10 | string | Y | 12 | |
+| bidp_rsqn1 | 매수호가 잔량1 | string | Y | 12 | |
+| bidp_rsqn2 | 매수호가 잔량2 | string | Y | 12 | |
+| bidp_rsqn3 | 매수호가 잔량3 | string | Y | 12 | |
+| bidp_rsqn4 | 매수호가 잔량4 | string | Y | 12 | |
+| bidp_rsqn5 | 매수호가 잔량5 | string | Y | 12 | |
+| bidp_rsqn6 | 매수호가 잔량6 | string | Y | 12 | |
+| bidp_rsqn7 | 매수호가 잔량7 | string | Y | 12 | |
+| bidp_rsqn8 | 매수호가 잔량8 | string | Y | 12 | |
+| bidp_rsqn9 | 매수호가 잔량9 | string | Y | 12 | |
+| bidp_rsqn10 | 매수호가 잔량10 | string | Y | 12 | |
+| askp_rsqn_icdc1 | 매도호가 잔량 증감1 | string | Y | 10 | |
+| askp_rsqn_icdc2 | 매도호가 잔량 증감2 | string | Y | 10 | |
+| askp_rsqn_icdc3 | 매도호가 잔량 증감3 | string | Y | 10 | |
+| askp_rsqn_icdc4 | 매도호가 잔량 증감4 | string | Y | 10 | |
+| askp_rsqn_icdc5 | 매도호가 잔량 증감5 | string | Y | 10 | |
+| askp_rsqn_icdc6 | 매도호가 잔량 증감6 | string | Y | 10 | |
+| askp_rsqn_icdc7 | 매도호가 잔량 증감7 | string | Y | 10 | |
+| askp_rsqn_icdc8 | 매도호가 잔량 증감8 | string | Y | 10 | |
+| askp_rsqn_icdc9 | 매도호가 잔량 증감9 | string | Y | 10 | |
+| askp_rsqn_icdc10 | 매도호가 잔량 증감10 | string | Y | 10 | |
+| bidp_rsqn_icdc1 | 매수호가 잔량 증감1 | string | Y | 10 | |
+| bidp_rsqn_icdc2 | 매수호가 잔량 증감2 | string | Y | 10 | |
+| bidp_rsqn_icdc3 | 매수호가 잔량 증감3 | string | Y | 10 | |
+| bidp_rsqn_icdc4 | 매수호가 잔량 증감4 | string | Y | 10 | |
+| bidp_rsqn_icdc5 | 매수호가 잔량 증감5 | string | Y | 10 | |
+| bidp_rsqn_icdc6 | 매수호가 잔량 증감6 | string | Y | 10 | |
+| bidp_rsqn_icdc7 | 매수호가 잔량 증감7 | string | Y | 10 | |
+| bidp_rsqn_icdc8 | 매수호가 잔량 증감8 | string | Y | 10 | |
+| bidp_rsqn_icdc9 | 매수호가 잔량 증감9 | string | Y | 10 | |
+| bidp_rsqn_icdc10 | 매수호가 잔량 증감10 | string | Y | 10 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | string | Y | 10 | |
+| total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | string | Y | 10 | |
+| ovtm_total_askp_icdc | 시간외 총 매도호가 증감 | string | Y | 10 | |
+| ovtm_total_bidp_icdc | 시간외 총 매수호가 증감 | string | Y | 10 | |
+| ovtm_total_askp_rsqn | 시간외 총 매도호가 잔량 | string | Y | 12 | |
+| ovtm_total_bidp_rsqn | 시간외 총 매수호가 잔량 | string | Y | 12 | |
+| ntby_aspr_rsqn | 순매수 호가 잔량 | string | Y | 12 | |
+| new_mkop_cls_code | 신 장운영 구분 코드 | string | Y | 2 | ' '00' : 장전 예상체결가와 장마감 동시호가
'49' : 장후 예상체결가
(1) 첫 번째 비트
1 : 장개시전
2 : 장중
3 : 장종료후
4 : 시간외단일가
7 : 일반Buy-in
8 : 당일Buy-in
(2) 두 번째 비트
0 : 보통
1 : 종가
2 : 대량
3 : 바스켓
7 : 정리매매
8 : Buy-in' |
+| output2 | 응답상세 | object | Y | | |
+| antc_mkop_cls_code | 예상 장운영 구분 코드 | string | Y | 3 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+| antc_cnpr | 예상 체결가 | string | Y | 10 | |
+| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
+| antc_cntg_vrss | 예상 체결 대비 | string | Y | 10 | |
+| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 11 | |
+| antc_vol | 예상 거래량 | string | Y | 18 | |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "fid_cond_mrkt_div_code": "J",
+ "fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "aspr_acpt_hour": "160000",
+ "askp1": "128000",
+ "askp2": "128500",
+ "askp3": "129000",
+ "askp4": "129500",
+ "askp5": "130000",
+ "askp6": "130500",
+ "askp7": "131000",
+ "askp8": "131500",
+ "askp9": "132000",
+ "askp10": "132500",
+ "bidp1": "127500",
+ "bidp2": "127000",
+ "bidp3": "126500",
+ "bidp4": "126000",
+ "bidp5": "125500",
+ "bidp6": "125000",
+ "bidp7": "124500",
+ "bidp8": "124000",
+ "bidp9": "123500",
+ "bidp10": "123000",
+ "askp_rsqn1": "69454",
+ "askp_rsqn2": "189698",
+ "askp_rsqn3": "154732",
+ "askp_rsqn4": "85703",
+ "askp_rsqn5": "158696",
+ "askp_rsqn6": "31395",
+ "askp_rsqn7": "50738",
+ "askp_rsqn8": "21039",
+ "askp_rsqn9": "39424",
+ "askp_rsqn10": "29126",
+ "bidp_rsqn1": "83147",
+ "bidp_rsqn2": "27469",
+ "bidp_rsqn3": "25200",
+ "bidp_rsqn4": "18544",
+ "bidp_rsqn5": "13251",
+ "bidp_rsqn6": "15742",
+ "bidp_rsqn7": "15070",
+ "bidp_rsqn8": "24995",
+ "bidp_rsqn9": "11658",
+ "bidp_rsqn10": "15773",
+ "askp_rsqn_icdc1": "0",
+ "askp_rsqn_icdc2": "0",
+ "askp_rsqn_icdc3": "0",
+ "askp_rsqn_icdc4": "0",
+ "askp_rsqn_icdc5": "0",
+ "askp_rsqn_icdc6": "0",
+ "askp_rsqn_icdc7": "0",
+ "askp_rsqn_icdc8": "0",
+ "askp_rsqn_icdc9": "0",
+ "askp_rsqn_icdc10": "0",
+ "bidp_rsqn_icdc1": "0",
+ "bidp_rsqn_icdc2": "0",
+ "bidp_rsqn_icdc3": "0",
+ "bidp_rsqn_icdc4": "0",
+ "bidp_rsqn_icdc5": "0",
+ "bidp_rsqn_icdc6": "0",
+ "bidp_rsqn_icdc7": "0",
+ "bidp_rsqn_icdc8": "0",
+ "bidp_rsqn_icdc9": "0",
+ "bidp_rsqn_icdc10": "0",
+ "total_askp_rsqn": "830005",
+ "total_bidp_rsqn": "250849",
+ "total_askp_rsqn_icdc": "0",
+ "total_bidp_rsqn_icdc": "0",
+ "ovtm_total_askp_icdc": "0",
+ "ovtm_total_bidp_icdc": "0",
+ "ovtm_total_askp_rsqn": "2943",
+ "ovtm_total_bidp_rsqn": "0",
+ "ntby_aspr_rsqn": "-579156",
+ "new_mkop_cls_code": "31"
+ },
+ "output2": {
+ "antc_mkop_cls_code": "112",
+ "stck_prpr": "128000",
+ "stck_oprc": "125500",
+ "stck_hgpr": "128500",
+ "stck_lwpr": "124500",
+ "stck_sdpr": "124500",
+ "antc_cnpr": "128000",
+ "antc_cntg_vrss_sign": "2",
+ "antc_cntg_vrss": "3500",
+ "antc_cntg_prdy_ctrt": "2.81",
+ "antc_vol": "220006",
+ "stck_shrn_iscd": "000660",
+ "vi_cls_code": "N"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/041_v1_국내주식-009_주식현재가-체결.md b/docs/broker/kis/rest/국내주식/기본시세/041_v1_국내주식-009_주식현재가-체결.md
new file mode 100644
index 0000000..27d64f3
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/041_v1_국내주식-009_주식현재가-체결.md
@@ -0,0 +1,115 @@
+# 주식현재가 체결
+
+- 원본 시트명: 주식현재가 체결
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-009
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010300
+- 모의 TR_ID: FHKST01010300
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-ccnl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 체결 API입니다.
+한국투자 HTS(eFriend Plus) > [010] 현재가 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+더 많은 체결데이터 확인이 필요할 경우 주식현재가 당일시간대별체결 API를 이용하세요
+(FID_INPUT_HOUR_1 를 이용하여 과거시간대 체결데이터 확인 가능)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01010300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 8 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 2 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| tday_rltv | 당일 체결강도 | string | Y | 112 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "155955",
+ "stck_prpr": "78900",
+ "prdy_vrss": "900",
+ "prdy_vrss_sign": "2",
+ "cntg_vol": "2",
+ "tday_rltv": "114.05",
+ "prdy_ctrt": "1.15"
+ },
+ {
+ "stck_cntg_hour": "155935",
+ "stck_prpr": "78900",
+ "prdy_vrss": "900",
+ "prdy_vrss_sign": "2",
+ "cntg_vol": "10",
+ "tday_rltv": "114.05",
+ "prdy_ctrt": "1.15"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/042_v1_국내주식-013_주식현재가-회원사.md b/docs/broker/kis/rest/국내주식/기본시세/042_v1_국내주식-013_주식현재가-회원사.md
new file mode 100644
index 0000000..38ff555
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/042_v1_국내주식-013_주식현재가-회원사.md
@@ -0,0 +1,220 @@
+# 주식현재가 회원사
+
+- 원본 시트명: 주식현재가 회원사
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-013
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010600
+- 모의 TR_ID: FHKST01010600
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-member
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식 현재가 회원사 API입니다. 회원사의 투자 정보를 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
FHKST01010600 : 주식현재가 회원사 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 성공 실패 여부
성공 : 0 실패 : 0외 값 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | array | Y | null | |
+| seln_mbcr_no1 | 매도 회원사 번호1 | string | Y | 5 | |
+| seln_mbcr_no2 | 매도 회원사 번호2 | string | Y | 5 | |
+| seln_mbcr_no3 | 매도 회원사 번호3 | string | Y | 5 | |
+| seln_mbcr_no4 | 매도 회원사 번호4 | string | Y | 5 | |
+| seln_mbcr_no5 | 매도 회원사 번호5 | string | Y | 5 | |
+| seln_mbcr_name1 | 매도 회원사 명1 | string | Y | 40 | |
+| seln_mbcr_name2 | 매도 회원사 명2 | string | Y | 40 | |
+| seln_mbcr_name3 | 매도 회원사 명3 | string | Y | 40 | |
+| seln_mbcr_name4 | 매도 회원사 명4 | string | Y | 40 | |
+| seln_mbcr_name5 | 매도 회원사 명5 | string | Y | 40 | |
+| total_seln_qty1 | 총 매도 수량1 | string | Y | 18 | |
+| total_seln_qty2 | 총 매도 수량2 | string | Y | 18 | |
+| total_seln_qty3 | 총 매도 수량3 | string | Y | 18 | |
+| total_seln_qty4 | 총 매도 수량4 | string | Y | 18 | |
+| total_seln_qty5 | 총 매도 수량5 | string | Y | 18 | |
+| seln_mbcr_rlim1 | 매도 회원사 비중1 | string | Y | 9 | |
+| seln_mbcr_rlim2 | 매도 회원사 비중2 | string | Y | 9 | |
+| seln_mbcr_rlim3 | 매도 회원사 비중3 | string | Y | 9 | |
+| seln_mbcr_rlim4 | 매도 회원사 비중4 | string | Y | 9 | |
+| seln_mbcr_rlim5 | 매도 회원사 비중5 | string | Y | 9 | |
+| seln_qty_icdc1 | 매도 수량 증감1 | string | Y | 10 | |
+| seln_qty_icdc2 | 매도 수량 증감2 | string | Y | 10 | |
+| seln_qty_icdc3 | 매도 수량 증감3 | string | Y | 10 | |
+| seln_qty_icdc4 | 매도 수량 증감4 | string | Y | 10 | |
+| seln_qty_icdc5 | 매도 수량 증감5 | string | Y | 10 | |
+| shnu_mbcr_no1 | 매수2 회원사 번호1 | string | Y | 5 | |
+| shnu_mbcr_no2 | 매수2 회원사 번호2 | string | Y | 5 | |
+| shnu_mbcr_no3 | 매수2 회원사 번호3 | string | Y | 5 | |
+| shnu_mbcr_no4 | 매수2 회원사 번호4 | string | Y | 5 | |
+| shnu_mbcr_no5 | 매수2 회원사 번호5 | string | Y | 5 | |
+| shnu_mbcr_name1 | 매수2 회원사 명1 | string | Y | 40 | |
+| shnu_mbcr_name2 | 매수2 회원사 명2 | string | Y | 40 | |
+| shnu_mbcr_name3 | 매수2 회원사 명3 | string | Y | 40 | |
+| shnu_mbcr_name4 | 매수2 회원사 명4 | string | Y | 40 | |
+| shnu_mbcr_name5 | 매수2 회원사 명5 | string | Y | 40 | |
+| total_shnu_qty1 | 총 매수2 수량1 | string | Y | 18 | |
+| total_shnu_qty2 | 총 매수2 수량2 | string | Y | 18 | |
+| total_shnu_qty3 | 총 매수2 수량3 | string | Y | 18 | |
+| total_shnu_qty4 | 총 매수2 수량4 | string | Y | 18 | |
+| total_shnu_qty5 | 총 매수2 수량5 | string | Y | 18 | |
+| shnu_mbcr_rlim1 | 매수2 회원사 비중1 | string | Y | 9 | |
+| shnu_mbcr_rlim2 | 매수2 회원사 비중2 | string | Y | 9 | |
+| shnu_mbcr_rlim3 | 매수2 회원사 비중3 | string | Y | 9 | |
+| shnu_mbcr_rlim4 | 매수2 회원사 비중4 | string | Y | 9 | |
+| shnu_mbcr_rlim5 | 매수2 회원사 비중5 | string | Y | 9 | |
+| shnu_qty_icdc1 | 매수2 수량 증감1 | string | Y | 10 | |
+| shnu_qty_icdc2 | 매수2 수량 증감2 | string | Y | 10 | |
+| shnu_qty_icdc3 | 매수2 수량 증감3 | string | Y | 10 | |
+| shnu_qty_icdc4 | 매수2 수량 증감4 | string | Y | 10 | |
+| shnu_qty_icdc5 | 매수2 수량 증감5 | string | Y | 10 | |
+| glob_total_seln_qty | 외국계 총 매도 수량 | string | Y | 18 | |
+| glob_seln_rlim | 외국계 매도 비중 | string | Y | 9 | |
+| glob_ntby_qty | 외국계 순매수 수량 | string | Y | 12 | |
+| glob_total_shnu_qty | 외국계 총 매수2 수량 | string | Y | 18 | |
+| glob_shnu_rlim | 외국계 매수2 비중 | string | Y | 9 | |
+| seln_mbcr_glob_yn_1 | 매도 회원사 외국계 여부1 | string | Y | 1 | |
+| seln_mbcr_glob_yn_2 | 매도 회원사 외국계 여부2 | string | Y | 1 | |
+| seln_mbcr_glob_yn_3 | 매도 회원사 외국계 여부3 | string | Y | 1 | |
+| seln_mbcr_glob_yn_4 | 매도 회원사 외국계 여부4 | string | Y | 1 | |
+| seln_mbcr_glob_yn_5 | 매도 회원사 외국계 여부5 | string | Y | 1 | |
+| shnu_mbcr_glob_yn_1 | 매수2 회원사 외국계 여부1 | string | Y | 1 | |
+| shnu_mbcr_glob_yn_2 | 매수2 회원사 외국계 여부2 | string | Y | 1 | |
+| shnu_mbcr_glob_yn_3 | 매수2 회원사 외국계 여부3 | string | Y | 1 | |
+| shnu_mbcr_glob_yn_4 | 매수2 회원사 외국계 여부4 | string | Y | 1 | |
+| shnu_mbcr_glob_yn_5 | 매수2 회원사 외국계 여부5 | string | Y | 1 | |
+| glob_total_seln_qty_icdc | 외국계 총 매도 수량 증감 | string | Y | 10 | |
+| glob_total_shnu_qty_icdc | 외국계 총 매수2 수량 증감 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "seln_mbcr_no1": "00086",
+ "seln_mbcr_no2": "00005",
+ "seln_mbcr_no3": "00050",
+ "seln_mbcr_no4": "00030",
+ "seln_mbcr_no5": "00002",
+ "seln_mbcr_name1": "BNK증권",
+ "seln_mbcr_name2": "미래에셋증권",
+ "seln_mbcr_name3": "키움증권",
+ "seln_mbcr_name4": "삼성증권",
+ "seln_mbcr_name5": "신한투자",
+ "total_seln_qty1": "801848",
+ "total_seln_qty2": "684589",
+ "total_seln_qty3": "310639",
+ "total_seln_qty4": "275035",
+ "total_seln_qty5": "235001",
+ "seln_mbcr_rlim1": "20.52",
+ "seln_mbcr_rlim2": "17.52",
+ "seln_mbcr_rlim3": "7.95",
+ "seln_mbcr_rlim4": "7.04",
+ "seln_mbcr_rlim5": "6.01",
+ "seln_qty_icdc1": "8000",
+ "seln_qty_icdc2": "39472",
+ "seln_qty_icdc3": "27755",
+ "seln_qty_icdc4": "13612",
+ "seln_qty_icdc5": "4047",
+ "shnu_mbcr_no1": "00086",
+ "shnu_mbcr_no2": "00005",
+ "shnu_mbcr_no3": "00033",
+ "shnu_mbcr_no4": "00045",
+ "shnu_mbcr_no5": "00036",
+ "shnu_mbcr_name1": "BNK증권",
+ "shnu_mbcr_name2": "미래에셋증권",
+ "shnu_mbcr_name3": "JP모간",
+ "shnu_mbcr_name4": "골드만",
+ "shnu_mbcr_name5": "모간서울",
+ "total_shnu_qty1": "822175",
+ "total_shnu_qty2": "598966",
+ "total_shnu_qty3": "378758",
+ "total_shnu_qty4": "354965",
+ "total_shnu_qty5": "261357",
+ "shnu_mbcr_rlim1": "21.04",
+ "shnu_mbcr_rlim2": "15.33",
+ "shnu_mbcr_rlim3": "9.69",
+ "shnu_mbcr_rlim4": "9.08",
+ "shnu_mbcr_rlim5": "6.69",
+ "shnu_qty_icdc1": "0",
+ "shnu_qty_icdc2": "2397",
+ "shnu_qty_icdc3": "20698",
+ "shnu_qty_icdc4": "17168",
+ "shnu_qty_icdc5": "11893",
+ "glob_total_seln_qty": "38125",
+ "glob_seln_rlim": "0.98",
+ "glob_ntby_qty": "1142513",
+ "glob_total_shnu_qty": "1180638",
+ "glob_shnu_rlim": "30.21",
+ "seln_mbcr_glob_yn_1": "N",
+ "seln_mbcr_glob_yn_2": "N",
+ "seln_mbcr_glob_yn_3": "N",
+ "seln_mbcr_glob_yn_4": "N",
+ "seln_mbcr_glob_yn_5": "N",
+ "shnu_mbcr_glob_yn_1": "N",
+ "shnu_mbcr_glob_yn_2": "N",
+ "shnu_mbcr_glob_yn_3": "Y",
+ "shnu_mbcr_glob_yn_4": "Y",
+ "shnu_mbcr_glob_yn_5": "Y",
+ "glob_total_seln_qty_icdc": "0",
+ "glob_total_shnu_qty_icdc": "49759"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/043_v1_국내주식-070_NAV-비교추이분.md b/docs/broker/kis/rest/국내주식/기본시세/043_v1_국내주식-070_NAV-비교추이분.md
new file mode 100644
index 0000000..b4c23a8
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/043_v1_국내주식-070_NAV-비교추이분.md
@@ -0,0 +1,553 @@
+# NAV 비교추이(분)
+
+- 원본 시트명: NAV 비교추이(분)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-070
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02440100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/etfetn/v1/quotations/nav-comparison-time-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+NAV 비교추이(분) API입니다.
+한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면 "분별" 비교추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+실전계좌의 경우, 한 번의 호출에 최근 30건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02440100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_hour_cls_code | FID 시간 구분 코드 | string | Y | 5 | 1분 :60, 3분: 180 … 120분:7200 |
+| fid_cond_mrkt_div_code | FID 조건 시장 분류 코드 | string | Y | 2 | E - 고정값 |
+| fid_input_iscd | FID 입력 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업 시간 | string | Y | 6 | |
+| nav | NAV | string | Y | 112 | |
+| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
+| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
+| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 84 | |
+| nav_vrss_prpr | NAV 대비 현재가 | string | Y | 112 | |
+| dprt | 괴리율 | string | Y | 82 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"E",
+"fid_input_iscd":"069500",
+"fid_hour_cls_code":"60"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_hour": "153000",
+ "nav": "36127.30",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "91.08",
+ "nav_prdy_ctrt": "0.25",
+ "nav_vrss_prpr": "-37.30",
+ "dprt": "-0.10",
+ "stck_prpr": "36090",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3714732",
+ "cntg_vol": "93993"
+ },
+ {
+ "bsop_hour": "152900",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152800",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152700",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152600",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152500",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152400",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152300",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152200",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152100",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "152000",
+ "nav": "36170.22",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "134.00",
+ "nav_prdy_ctrt": "0.37",
+ "nav_vrss_prpr": "-60.22",
+ "dprt": "-0.17",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "151900",
+ "nav": "36160.15",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "123.93",
+ "nav_prdy_ctrt": "0.34",
+ "nav_vrss_prpr": "-50.15",
+ "dprt": "-0.14",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3620739",
+ "cntg_vol": "46"
+ },
+ {
+ "bsop_hour": "151800",
+ "nav": "36166.66",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "130.44",
+ "nav_prdy_ctrt": "0.36",
+ "nav_vrss_prpr": "-51.66",
+ "dprt": "-0.14",
+ "stck_prpr": "36115",
+ "prdy_vrss": "135",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.38",
+ "acml_vol": "3600900",
+ "cntg_vol": "67"
+ },
+ {
+ "bsop_hour": "151700",
+ "nav": "36138.90",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "102.68",
+ "nav_prdy_ctrt": "0.28",
+ "nav_vrss_prpr": "-28.90",
+ "dprt": "-0.08",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3574190",
+ "cntg_vol": "100"
+ },
+ {
+ "bsop_hour": "151600",
+ "nav": "36151.53",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "115.31",
+ "nav_prdy_ctrt": "0.32",
+ "nav_vrss_prpr": "-36.53",
+ "dprt": "-0.10",
+ "stck_prpr": "36115",
+ "prdy_vrss": "135",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.38",
+ "acml_vol": "3566213",
+ "cntg_vol": "127"
+ },
+ {
+ "bsop_hour": "151500",
+ "nav": "36148.81",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "112.59",
+ "nav_prdy_ctrt": "0.31",
+ "nav_vrss_prpr": "-38.81",
+ "dprt": "-0.11",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3561650",
+ "cntg_vol": "1"
+ },
+ {
+ "bsop_hour": "151400",
+ "nav": "36144.32",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "108.10",
+ "nav_prdy_ctrt": "0.30",
+ "nav_vrss_prpr": "-34.32",
+ "dprt": "-0.09",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3554609",
+ "cntg_vol": "20"
+ },
+ {
+ "bsop_hour": "151300",
+ "nav": "36153.81",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "117.59",
+ "nav_prdy_ctrt": "0.33",
+ "nav_vrss_prpr": "-38.81",
+ "dprt": "-0.11",
+ "stck_prpr": "36115",
+ "prdy_vrss": "135",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.38",
+ "acml_vol": "3548014",
+ "cntg_vol": "17"
+ },
+ {
+ "bsop_hour": "151200",
+ "nav": "36146.99",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "110.77",
+ "nav_prdy_ctrt": "0.31",
+ "nav_vrss_prpr": "-36.99",
+ "dprt": "-0.10",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3531673",
+ "cntg_vol": "5000"
+ },
+ {
+ "bsop_hour": "151100",
+ "nav": "36134.21",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "97.99",
+ "nav_prdy_ctrt": "0.27",
+ "nav_vrss_prpr": "-34.21",
+ "dprt": "-0.09",
+ "stck_prpr": "36100",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "3508924",
+ "cntg_vol": "1"
+ },
+ {
+ "bsop_hour": "151000",
+ "nav": "36125.95",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "89.73",
+ "nav_prdy_ctrt": "0.25",
+ "nav_vrss_prpr": "-30.95",
+ "dprt": "-0.09",
+ "stck_prpr": "36095",
+ "prdy_vrss": "115",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.32",
+ "acml_vol": "3497610",
+ "cntg_vol": "107"
+ },
+ {
+ "bsop_hour": "150900",
+ "nav": "36140.40",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "104.18",
+ "nav_prdy_ctrt": "0.29",
+ "nav_vrss_prpr": "-40.40",
+ "dprt": "-0.11",
+ "stck_prpr": "36100",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "3465289",
+ "cntg_vol": "1"
+ },
+ {
+ "bsop_hour": "150800",
+ "nav": "36142.41",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "106.19",
+ "nav_prdy_ctrt": "0.29",
+ "nav_vrss_prpr": "-52.41",
+ "dprt": "-0.15",
+ "stck_prpr": "36090",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3455837",
+ "cntg_vol": "2"
+ },
+ {
+ "bsop_hour": "150700",
+ "nav": "36128.14",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "91.92",
+ "nav_prdy_ctrt": "0.25",
+ "nav_vrss_prpr": "-38.14",
+ "dprt": "-0.11",
+ "stck_prpr": "36090",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3443292",
+ "cntg_vol": "6"
+ },
+ {
+ "bsop_hour": "150600",
+ "nav": "36143.67",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "107.45",
+ "nav_prdy_ctrt": "0.30",
+ "nav_vrss_prpr": "-43.67",
+ "dprt": "-0.12",
+ "stck_prpr": "36100",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "3438545",
+ "cntg_vol": "38"
+ },
+ {
+ "bsop_hour": "150500",
+ "nav": "36149.19",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "112.97",
+ "nav_prdy_ctrt": "0.31",
+ "nav_vrss_prpr": "-49.19",
+ "dprt": "-0.14",
+ "stck_prpr": "36100",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "3429629",
+ "cntg_vol": "1"
+ },
+ {
+ "bsop_hour": "150400",
+ "nav": "36144.80",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "108.58",
+ "nav_prdy_ctrt": "0.30",
+ "nav_vrss_prpr": "-34.80",
+ "dprt": "-0.11",
+ "stck_prpr": "36110",
+ "prdy_vrss": "125",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.35",
+ "acml_vol": "3425274",
+ "cntg_vol": "50"
+ },
+ {
+ "bsop_hour": "150300",
+ "nav": "36152.94",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "116.72",
+ "nav_prdy_ctrt": "0.32",
+ "nav_vrss_prpr": "-42.94",
+ "dprt": "-0.12",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3417931",
+ "cntg_vol": "10"
+ },
+ {
+ "bsop_hour": "150200",
+ "nav": "36152.33",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "116.11",
+ "nav_prdy_ctrt": "0.32",
+ "nav_vrss_prpr": "-37.33",
+ "dprt": "-0.08",
+ "stck_prpr": "36115",
+ "prdy_vrss": "145",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.40",
+ "acml_vol": "3410977",
+ "cntg_vol": "276"
+ },
+ {
+ "bsop_hour": "150100",
+ "nav": "36156.58",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_vrss": "120.36",
+ "nav_prdy_ctrt": "0.33",
+ "nav_vrss_prpr": "-46.58",
+ "dprt": "-0.13",
+ "stck_prpr": "36110",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "3400392",
+ "cntg_vol": "5"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/044_v1_국내주식-012_주식현재가-투자자.md b/docs/broker/kis/rest/국내주식/기본시세/044_v1_국내주식-012_주식현재가-투자자.md
new file mode 100644
index 0000000..0c1af31
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/044_v1_국내주식-012_주식현재가-투자자.md
@@ -0,0 +1,160 @@
+# 주식현재가 투자자
+
+- 원본 시트명: 주식현재가 투자자
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-012
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01010900
+- 모의 TR_ID: FHKST01010900
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-investor
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 투자자 API입니다. 개인, 외국인, 기관 등 투자 정보를 확인할 수 있습니다.
+
+[유의사항]
+- 외국인은 외국인(외국인투자등록 고유번호가 있는 경우)+기타 외국인을 지칭합니다.
+- 당일 데이터는 장 종료 후 제공됩니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01010900 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J : KRX, NX : NXT, UN : 통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | Array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prsn_ntby_qty | 개인 순매수 수량 | string | Y | 12 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
+| prsn_ntby_tr_pbmn | 개인 순매수 거래 대금 | string | Y | 18 | |
+| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | |
+| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
+| prsn_shnu_vol | 개인 매수2 거래량 | string | Y | 18 | |
+| frgn_shnu_vol | 외국인 매수2 거래량 | string | Y | 18 | |
+| orgn_shnu_vol | 기관계 매수2 거래량 | string | Y | 18 | |
+| prsn_shnu_tr_pbmn | 개인 매수2 거래 대금 | string | Y | 18 | |
+| frgn_shnu_tr_pbmn | 외국인 매수2 거래 대금 | string | Y | 18 | |
+| orgn_shnu_tr_pbmn | 기관계 매수2 거래 대금 | string | Y | 18 | |
+| prsn_seln_vol | 개인 매도 거래량 | string | Y | 18 | |
+| frgn_seln_vol | 외국인 매도 거래량 | string | Y | 18 | |
+| orgn_seln_vol | 기관계 매도 거래량 | string | Y | 18 | |
+| prsn_seln_tr_pbmn | 개인 매도 거래 대금 | string | Y | 18 | |
+| frgn_seln_tr_pbmn | 외국인 매도 거래 대금 | string | Y | 18 | |
+| orgn_seln_tr_pbmn | 기관계 매도 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code": "J",
+"fid_input_iscd": "000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20220113",
+ "stck_clpr": "129500",
+ "prdy_vrss": "1000",
+ "prdy_vrss_sign": "2",
+ "prsn_ntby_qty": "-287624",
+ "frgn_ntby_qty": "797458",
+ "orgn_ntby_qty": "-503653",
+ "prsn_ntby_tr_pbmn": "-37176",
+ "frgn_ntby_tr_pbmn": "102959",
+ "orgn_ntby_tr_pbmn": "-64984",
+ "prsn_shnu_vol": "467525",
+ "frgn_shnu_vol": "1442791",
+ "orgn_shnu_vol": "2219433",
+ "prsn_shnu_tr_pbmn": "60368",
+ "frgn_shnu_tr_pbmn": "186166",
+ "orgn_shnu_tr_pbmn": "286505",
+ "prsn_seln_vol": "755149",
+ "frgn_seln_vol": "645333",
+ "orgn_seln_vol": "2723086",
+ "prsn_seln_tr_pbmn": "97544",
+ "frgn_seln_tr_pbmn": "83207",
+ "orgn_seln_tr_pbmn": "351489"
+ },
+ {
+ "stck_bsop_date": "20220112",
+ "stck_clpr": "128500",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prsn_ntby_qty": "-74249",
+ "frgn_ntby_qty": "-134600",
+ "orgn_ntby_qty": "206812",
+ "prsn_ntby_tr_pbmn": "-9687",
+ "frgn_ntby_tr_pbmn": "-17094",
+ "orgn_ntby_tr_pbmn": "26530",
+ "prsn_shnu_vol": "608748",
+ "frgn_shnu_vol": "721756",
+ "orgn_shnu_vol": "2201966",
+ "prsn_shnu_tr_pbmn": "77943",
+ "frgn_shnu_tr_pbmn": "92615",
+ "orgn_shnu_tr_pbmn": "281965",
+ "prsn_seln_vol": "682997",
+ "frgn_seln_vol": "856356",
+ "orgn_seln_vol": "1995154",
+ "prsn_seln_tr_pbmn": "87630",
+ "frgn_seln_tr_pbmn": "109708",
+ "orgn_seln_tr_pbmn": "255435"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/045_v1_국내주식-068_ETF_ETN-현재가.md b/docs/broker/kis/rest/국내주식/기본시세/045_v1_국내주식-068_ETF_ETN-현재가.md
new file mode 100644
index 0000000..e466a6c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/045_v1_국내주식-068_ETF_ETN-현재가.md
@@ -0,0 +1,204 @@
+# ETF_ETN 현재가
+
+- 원본 시트명: ETF_ETN 현재가
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-068
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02400000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/etfetn/v1/quotations/inquire-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ETF/ETN 현재가 API입니다.
+한국투자 HTS(eFriend Plus) > [0240] ETF/ETN 현재가 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02400000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | FID 입력 종목코드 | string | Y | 12 | 종목코드 |
+| fid_cond_mrkt_div_code | FID 조건 시장 분류 코드 | string | Y | 2 | J |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| stck_mxpr | 주식 상한가 | string | Y | 10 | |
+| stck_llam | 주식 하한가 | string | Y | 10 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| prdy_clpr_vrss_oprc_rate | 전일 종가 대비 시가2 비율 | string | Y | 84 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| prdy_clpr_vrss_hgpr_rate | 전일 종가 대비 최고가 비율 | string | Y | 84 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 84 | |
+| prdy_last_nav | 전일 최종 NAV | string | Y | 112 | |
+| nav | NAV | string | Y | 112 | |
+| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
+| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
+| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 82 | |
+| trc_errt | 추적 오차율 | string | Y | 82 | |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+| stck_sspr | 주식 대용가 | string | Y | 10 | |
+| nmix_ctrt | 지수 대비율 | string | Y | 135 | |
+| etf_crcl_stcn | ETF 유통 주수 | string | Y | 18 | |
+| etf_ntas_ttam | ETF 순자산 총액 | string | Y | 22 | |
+| etf_frcr_ntas_ttam | ETF 외화 순자산 총액 | string | Y | 22 | |
+| frgn_limt_rate | 외국인 한도 비율 | string | Y | 84 | |
+| frgn_oder_able_qty | 외국인 주문 가능 수량 | string | Y | 18 | |
+| etf_cu_unit_scrt_cnt | ETF CU 단위 증권 수 | string | Y | 18 | |
+| etf_cnfg_issu_cnt | ETF 구성 종목 수 | string | Y | 18 | |
+| etf_dvdn_cycl | ETF 배당 주기 | string | Y | 2 | |
+| crcd | 통화 코드 | string | Y | 4 | |
+| etf_crcl_ntas_ttam | ETF 유통 순자산 총액 | string | Y | 22 | |
+| etf_frcr_crcl_ntas_ttam | ETF 외화 유통 순자산 총액 | string | Y | 22 | |
+| etf_frcr_last_ntas_wrth_val | ETF 외화 최종 순자산 가치 값 | string | Y | 13 | |
+| lp_oder_able_cls_code | LP 주문 가능 구분 코드 | string | Y | 2 | |
+| stck_dryy_hgpr | 주식 연중 최고가 | string | Y | 10 | |
+| dryy_hgpr_vrss_prpr_rate | 연중 최고가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_hgpr_date | 연중 최고가 일자 | string | Y | 8 | |
+| stck_dryy_lwpr | 주식 연중 최저가 | string | Y | 10 | |
+| dryy_lwpr_vrss_prpr_rate | 연중 최저가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_lwpr_date | 연중 최저가 일자 | string | Y | 8 | |
+| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
+| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
+| lstn_stcn | 상장 주수 | string | Y | 18 | |
+| frgn_hldn_qty | 외국인 보유 수량 | string | Y | 18 | |
+| frgn_hldn_qty_rate | 외국인 보유 수량 비율 | string | Y | 84 | |
+| etf_trc_ert_mltp | ETF 추적 수익률 배수 | string | Y | 126 | |
+| dprt | 괴리율 | string | Y | 82 | |
+| mbcr_name | 회원사 명 | string | Y | 50 | |
+| stck_lstn_date | 주식 상장 일자 | string | Y | 8 | |
+| mtrt_date | 만기 일자 | string | Y | 8 | |
+| shrg_type_code | 분배금형태코드 | string | Y | 2 | |
+| lp_hldn_rate | LP 보유 비율 | string | Y | 84 | |
+| etf_trgt_nmix_bstp_code | ETF대상지수업종코드 | string | Y | 4 | |
+| etf_div_name | ETF 분류 명 | string | Y | 40 | |
+| etf_rprs_bstp_kor_isnm | ETF 대표 업종 한글 종목명 | string | Y | 40 | |
+| lp_hldn_vol | ETN LP 보유량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"069500"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "stck_prpr": "36090",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "110",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "3719307",
+ "prdy_vol": "6463600",
+ "stck_mxpr": "46770",
+ "stck_llam": "25190",
+ "stck_prdy_clpr": "35980",
+ "stck_oprc": "36300",
+ "prdy_clpr_vrss_oprc_rate": "0.89",
+ "stck_hgpr": "36510",
+ "prdy_clpr_vrss_hgpr_rate": "1.47",
+ "stck_lwpr": "36040",
+ "prdy_clpr_vrss_lwpr_rate": "0.17",
+ "prdy_last_nav": "36036.22",
+ "nav": "36127.30",
+ "nav_prdy_vrss": "91.08",
+ "nav_prdy_vrss_sign": "2",
+ "nav_prdy_ctrt": "0.25",
+ "trc_errt": "0.53",
+ "stck_sdpr": "35980",
+ "stck_sspr": "28780",
+ "etf_crcl_stcn": "191550000",
+ "etf_ntas_ttam": "69027",
+ "etf_frcr_ntas_ttam": "0",
+ "frgn_limt_rate": "100.0000",
+ "frgn_oder_able_qty": "150950685",
+ "etf_cu_unit_scrt_cnt": "50000",
+ "etf_cnfg_issu_cnt": "201",
+ "etf_dvdn_cycl": "2",
+ "crcd": "KRW",
+ "etf_crcl_ntas_ttam": "0",
+ "etf_frcr_crcl_ntas_ttam": "0",
+ "etf_frcr_last_ntas_wrth_val": "0",
+ "lp_oder_able_cls_code": "N",
+ "stck_dryy_hgpr": "36510",
+ "dryy_hgpr_vrss_prpr_rate": "-1.15",
+ "dryy_hgpr_date": "20240223",
+ "stck_dryy_lwpr": "32748",
+ "dryy_lwpr_vrss_prpr_rate": "10.21",
+ "dryy_lwpr_date": "20240118",
+ "bstp_kor_isnm": "ETF(실물복제/수익증권)",
+ "vi_cls_code": "N",
+ "lstn_stcn": "191550000",
+ "frgn_hldn_qty": "40599315",
+ "frgn_hldn_qty_rate": "21.20",
+ "etf_trc_ert_mltp": "1.00",
+ "dprt": "-0.10",
+ "mbcr_name": "삼성자산운용(ETF)",
+ "stck_lstn_date": "20021014",
+ "mtrt_date": "0",
+ "shrg_type_code": " ",
+ "lp_hldn_rate": "0.00",
+ "etf_trgt_nmix_bstp_code": "2001",
+ "etf_div_name": "수익증권형",
+ "etf_rprs_bstp_kor_isnm": "KOSPI200",
+ "lp_hldn_vol": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/046_국내주식-120_국내주식-장마감-예상체결가.md b/docs/broker/kis/rest/국내주식/기본시세/046_국내주식-120_국내주식-장마감-예상체결가.md
new file mode 100644
index 0000000..c604b59
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/046_국내주식-120_국내주식-장마감-예상체결가.md
@@ -0,0 +1,99 @@
+# 국내주식 장마감 예상체결가
+
+- 원본 시트명: 국내주식 장마감 예상체결가
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: 국내주식-120
+- HTTP Method: GET
+- 실전 TR_ID: FHKST117300C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/exp-closing-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 장마감 예상체결가 API입니다.
+한국투자 HTS(eFriend Plus) > [0183] 장마감 예상체결가 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST117300C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | 0:전체, 1:상한가마감예상, 2:하한가마감예상, 3:직전대비상승률상위 ,4:직전대비하락률상위 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11173) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| FID_BLNG_CLS_CODE | 소속 구분 코드 | string | Y | 2 | 0:전체, 1:종가범위연장 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| sdpr_vrss_prpr | 기준가 대비 현재가 | string | Y | 10 | |
+| sdpr_vrss_prpr_rate | 기준가 대비 현재가 비율 | string | Y | 84 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_cond_scr_div_code:11173
+fid_input_iscd:0001
+fid_blng_cls_code:0
+fid_rank_sort_cls_code:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/기본시세/047_v1_국내주식-022_주식당일분봉조회.md b/docs/broker/kis/rest/국내주식/기본시세/047_v1_국내주식-022_주식당일분봉조회.md
new file mode 100644
index 0000000..0dfdae6
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/기본시세/047_v1_국내주식-022_주식당일분봉조회.md
@@ -0,0 +1,153 @@
+# 주식당일분봉조회
+
+- 원본 시트명: 주식당일분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 기본시세
+- API ID: v1_국내주식-022
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03010200
+- 모의 TR_ID: FHKST03010200
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-itemchartprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식당일분봉조회 API입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 30건까지 확인 가능합니다.
+
+※ 당일 분봉 데이터만 제공됩니다. (전일자 분봉 미제공)
+
+※ input > FID_INPUT_HOUR_1 에 미래일시 입력 시에 현재가로 조회됩니다.
+ex) 오전 10시에 113000 입력 시에 오전 10시~11시30분 사이의 데이터가 오전 10시 값으로 조회됨
+
+※ output2의 첫번째 배열의 체결량(cntg_vol)은 첫체결이 발생되기 전까지는 이전 분봉의 체결량이 해당 위치에 표시됩니다.
+해당 분봉의 첫 체결이 발생되면 해당 이전분 체결량이 두번째 배열로 이동되면서 새로운 체결량으로 업데이트됩니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST03010200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 입력시간 |
+| FID_PW_DATA_INCU_YN | 과거 데이터 포함 여부 | string | Y | 2 | |
+| FID_ETC_CLS_CODE | 기타 구분 코드 | string | Y | 2 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | 전일 대비 변동 (+-변동차이) |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 전일 대비 부호 |
+| prdy_ctrt | 전일 대비율 | string | Y | 10 | 소수점 두자리까지 제공 |
+| stck_prdy_clpr | 전일대비 종가 | string | Y | 10 | 전일대비 종가 |
+| acml_vol | 누적 거래량 | string | Y | 18 | 누적 거래량 |
+| acml_tr_pbmn | 누적 거래대금 | string | Y | 18 | 누적 거래대금 |
+| hts_kor_isnm | 한글 종목명 | string | Y | 40 | 한글 종목명 (HTS 기준) |
+| stck_prpr | 주식 현재가 | string | Y | 10 | 주식 현재가 |
+| output2 | 응답상세 | object array | Y | | Array |
+| stck_bsop_date | 주식 영업일자 | string | Y | 8 | 주식 영업일자 |
+| stck_cntg_hour | 주식 체결시간 | string | Y | 6 | 주식 체결시간 |
+| stck_prpr | 주식 현재가 | string | Y | 10 | 주식 현재가 |
+| stck_oprc | 주식 시가 | string | Y | 10 | 주식 시가 |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | 주식 최고가 |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | 주식 최저가 |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "fid_cond_mrkt_div_code": "J",
+ "fid_etc_cls_code": "",
+ "fid_input_hour_1": "100000",
+ "fid_input_iscd": "000660",
+ "fid_pw_data_incu_yn": "Y"
+ }
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "acml_tr_pbmn": "96910660000",
+ "acml_vol": "1046883",
+ "hts_kor_isnm": "SK하이닉스",
+ "prdy_ctrt": "-0.11",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "stck_prdy_clpr": "92400",
+ "stck_prpr": "92300"
+ },
+ "output2": [
+ {
+ "acml_tr_pbmn": "55858827400",
+ "cntg_vol": "1383",
+ "stck_bsop_date": "20220902",
+ "stck_cntg_hour": "100000",
+ "stck_hgpr": "92500",
+ "stck_lwpr": "92400",
+ "stck_oprc": "92400",
+ "stck_prpr": "92500"
+ },
+ {
+ "acml_tr_pbmn": "55731000300",
+ "cntg_vol": "1564",
+ "stck_bsop_date": "20220902",
+ "stck_cntg_hour": "095900",
+ "stck_hgpr": "92500",
+ "stck_lwpr": "92400",
+ "stck_oprc": "92500",
+ "stck_prpr": "92400"
+ "stck_hgpr": "93300",
+ "stck_lwpr": "93100",
+ "stck_oprc": "93100",
+ "stck_prpr": "93200"
+ }
+ ......
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다!"
+ }
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/139_v1_국내주식-103_국내주식-예상체결-상승_하락상위.md b/docs/broker/kis/rest/국내주식/순위분석/139_v1_국내주식-103_국내주식-예상체결-상승_하락상위.md
new file mode 100644
index 0000000..5ff51b7
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/139_v1_국내주식-103_국내주식-예상체결-상승_하락상위.md
@@ -0,0 +1,633 @@
+# 국내주식 예상체결 상승_하락상위
+
+- 원본 시트명: 국내주식 예상체결 상승_하락상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-103
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01820000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/exp-trans-updown
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예상체결 상승/하락상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0182] 예상체결 상승/하락상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01820000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:상승률1:상승폭2:보합3:하락율4:하락폭5:체결량6:거래대금 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20182) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체 1:보통주 2:우선주 |
+| fid_aply_rang_prc_1 | 적용 범위 가격1 | string | Y | 18 | 입력값 없을때 전체 (가격 ~) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_pbmn | 거래대금 | string | Y | 18 | 입력값 없을때 전체 (거래대금 ~) 천원단위 |
+| fid_blng_cls_code | 소속 구분 코드 | string | Y | 2 | 0: 전체 |
+| fid_mkop_cls_code | 장운영 구분 코드 | string | Y | 2 | 0:장전예상1:장마감예상 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+| seln_rsqn | 매도 잔량 | string | Y | 12 | |
+| askp | 매도호가 | string | Y | 10 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| antc_tr_pbmn | 체결 거래대금 | string | Y | 18 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20182",
+"fid_input_iscd":"0000",
+"fid_div_cls_code":"0",
+"fid_aply_rang_prc_1":"",
+"fid_vol_cnt":"",
+"fid_pbmn":"",
+"fid_blng_cls_code":"0",
+"fid_mkop_cls_code":"0",
+"fid_rank_sort_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "199800",
+ "hts_kor_isnm": "툴젠",
+ "stck_prpr": "76100",
+ "prdy_vrss": "17500",
+ "prdy_vrss_sign": "1",
+ "prdy_ctrt": "29.86",
+ "stck_sdpr": "58600",
+ "seln_rsqn": "0",
+ "askp": "0",
+ "bidp": "76100",
+ "shnu_rsqn": "49100",
+ "cntg_vol": "51683",
+ "antc_tr_pbmn": "3933076300",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "67064"
+ },
+ {
+ "stck_shrn_iscd": "378340",
+ "hts_kor_isnm": "필에너지",
+ "stck_prpr": "31800",
+ "prdy_vrss": "3400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.97",
+ "stck_sdpr": "28400",
+ "seln_rsqn": "10680",
+ "askp": "31800",
+ "bidp": "31750",
+ "shnu_rsqn": "6215",
+ "cntg_vol": "198612",
+ "antc_tr_pbmn": "6315861600",
+ "total_askp_rsqn": "14705",
+ "total_bidp_rsqn": "71743"
+ },
+ {
+ "stck_shrn_iscd": "115530",
+ "hts_kor_isnm": "씨엔플러스",
+ "stck_prpr": "386",
+ "prdy_vrss": "41",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.88",
+ "stck_sdpr": "345",
+ "seln_rsqn": "3257",
+ "askp": "386",
+ "bidp": "385",
+ "shnu_rsqn": "92624",
+ "cntg_vol": "1150496",
+ "antc_tr_pbmn": "72949040",
+ "total_askp_rsqn": "33272",
+ "total_bidp_rsqn": "173439"
+ },
+ {
+ "stck_shrn_iscd": "Q580040",
+ "hts_kor_isnm": "KB 인버스 2X KOSPI 200 선물 ETN",
+ "stck_prpr": "13305",
+ "prdy_vrss": "1205",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.96",
+ "stck_sdpr": "12100",
+ "seln_rsqn": "0",
+ "askp": "0",
+ "bidp": "12730",
+ "shnu_rsqn": "69",
+ "cntg_vol": "13",
+ "antc_tr_pbmn": "172965",
+ "total_askp_rsqn": "49927",
+ "total_bidp_rsqn": "15061"
+ },
+ {
+ "stck_shrn_iscd": "078150",
+ "hts_kor_isnm": "HB테크놀러지",
+ "stck_prpr": "2620",
+ "prdy_vrss": "230",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.62",
+ "stck_sdpr": "2390",
+ "seln_rsqn": "53479",
+ "askp": "2625",
+ "bidp": "2620",
+ "shnu_rsqn": "7114",
+ "cntg_vol": "822185",
+ "antc_tr_pbmn": "2154124700",
+ "total_askp_rsqn": "332932",
+ "total_bidp_rsqn": "206643"
+ },
+ {
+ "stck_shrn_iscd": "094820",
+ "hts_kor_isnm": "일진파워",
+ "stck_prpr": "13470",
+ "prdy_vrss": "1150",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.33",
+ "stck_sdpr": "12320",
+ "seln_rsqn": "7647",
+ "askp": "13470",
+ "bidp": "13460",
+ "shnu_rsqn": "680",
+ "cntg_vol": "46521",
+ "antc_tr_pbmn": "626637870",
+ "total_askp_rsqn": "6235",
+ "total_bidp_rsqn": "8704"
+ },
+ {
+ "stck_shrn_iscd": "193250",
+ "hts_kor_isnm": "와이제이엠게임즈",
+ "stck_prpr": "827",
+ "prdy_vrss": "66",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.67",
+ "stck_sdpr": "761",
+ "seln_rsqn": "5014",
+ "askp": "827",
+ "bidp": "826",
+ "shnu_rsqn": "41",
+ "cntg_vol": "19093",
+ "antc_tr_pbmn": "49621503",
+ "total_askp_rsqn": "10094",
+ "total_bidp_rsqn": "36639"
+ },
+ {
+ "stck_shrn_iscd": "030350",
+ "hts_kor_isnm": "드래곤플라이",
+ "stck_prpr": "674",
+ "prdy_vrss": "53",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.53",
+ "stck_sdpr": "621",
+ "seln_rsqn": "2351",
+ "askp": "674",
+ "bidp": "672",
+ "shnu_rsqn": "2501",
+ "cntg_vol": "1000046",
+ "antc_tr_pbmn": "23279190",
+ "total_askp_rsqn": "47302",
+ "total_bidp_rsqn": "211603"
+ },
+ {
+ "stck_shrn_iscd": "020760",
+ "hts_kor_isnm": "일진디스플",
+ "stck_prpr": "979",
+ "prdy_vrss": "75",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.30",
+ "stck_sdpr": "904",
+ "seln_rsqn": "6015",
+ "askp": "979",
+ "bidp": "952",
+ "shnu_rsqn": "220",
+ "cntg_vol": "6214",
+ "antc_tr_pbmn": "6083506",
+ "total_askp_rsqn": "16585",
+ "total_bidp_rsqn": "5613"
+ },
+ {
+ "stck_shrn_iscd": "321370",
+ "hts_kor_isnm": "센서뷰",
+ "stck_prpr": "4420",
+ "prdy_vrss": "320",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "7.80",
+ "stck_sdpr": "4100",
+ "seln_rsqn": "4038",
+ "askp": "4420",
+ "bidp": "4410",
+ "shnu_rsqn": "291",
+ "cntg_vol": "41019",
+ "antc_tr_pbmn": "552669480",
+ "total_askp_rsqn": "22631",
+ "total_bidp_rsqn": "26665"
+ },
+ {
+ "stck_shrn_iscd": "105740",
+ "hts_kor_isnm": "디케이락",
+ "stck_prpr": "8960",
+ "prdy_vrss": "610",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "7.31",
+ "stck_sdpr": "8350",
+ "seln_rsqn": "1321",
+ "askp": "8970",
+ "bidp": "8960",
+ "shnu_rsqn": "9811",
+ "cntg_vol": "62727",
+ "antc_tr_pbmn": "698595660",
+ "total_askp_rsqn": "3450",
+ "total_bidp_rsqn": "16822"
+ },
+ {
+ "stck_shrn_iscd": "103590",
+ "hts_kor_isnm": "일진전기",
+ "stck_prpr": "15700",
+ "prdy_vrss": "1020",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.95",
+ "stck_sdpr": "14680",
+ "seln_rsqn": "1163",
+ "askp": "15710",
+ "bidp": "15700",
+ "shnu_rsqn": "8187",
+ "cntg_vol": "111684",
+ "antc_tr_pbmn": "959050680",
+ "total_askp_rsqn": "3352",
+ "total_bidp_rsqn": "50667"
+ },
+ {
+ "stck_shrn_iscd": "101000",
+ "hts_kor_isnm": "상상인인더스트리",
+ "stck_prpr": "3690",
+ "prdy_vrss": "235",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.80",
+ "stck_sdpr": "3455",
+ "seln_rsqn": "1078",
+ "askp": "3690",
+ "bidp": "3600",
+ "shnu_rsqn": "408",
+ "cntg_vol": "59127",
+ "antc_tr_pbmn": "34685280",
+ "total_askp_rsqn": "9513",
+ "total_bidp_rsqn": "12837"
+ },
+ {
+ "stck_shrn_iscd": "211050",
+ "hts_kor_isnm": "인카금융서비스",
+ "stck_prpr": "24000",
+ "prdy_vrss": "1450",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.43",
+ "stck_sdpr": "22550",
+ "seln_rsqn": "823",
+ "askp": "24000",
+ "bidp": "22550",
+ "shnu_rsqn": "122",
+ "cntg_vol": "1958",
+ "antc_tr_pbmn": "2436000",
+ "total_askp_rsqn": "1066",
+ "total_bidp_rsqn": "4599"
+ },
+ {
+ "stck_shrn_iscd": "010660",
+ "hts_kor_isnm": "화천기계",
+ "stck_prpr": "6660",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.39",
+ "stck_sdpr": "6260",
+ "seln_rsqn": "1260",
+ "askp": "6670",
+ "bidp": "6660",
+ "shnu_rsqn": "8959",
+ "cntg_vol": "219634",
+ "antc_tr_pbmn": "640185240",
+ "total_askp_rsqn": "63618",
+ "total_bidp_rsqn": "17278"
+ },
+ {
+ "stck_shrn_iscd": "110020",
+ "hts_kor_isnm": "전진바이오팜",
+ "stck_prpr": "8500",
+ "prdy_vrss": "490",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.12",
+ "stck_sdpr": "8010",
+ "seln_rsqn": "999",
+ "askp": "8500",
+ "bidp": "8240",
+ "shnu_rsqn": "10",
+ "cntg_vol": "11074",
+ "antc_tr_pbmn": "94129000",
+ "total_askp_rsqn": "15232",
+ "total_bidp_rsqn": "8635"
+ },
+ {
+ "stck_shrn_iscd": "095700",
+ "hts_kor_isnm": "제넥신",
+ "stck_prpr": "8790",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.03",
+ "stck_sdpr": "8290",
+ "seln_rsqn": "899",
+ "askp": "8790",
+ "bidp": "8750",
+ "shnu_rsqn": "6640",
+ "cntg_vol": "23275",
+ "antc_tr_pbmn": "204587250",
+ "total_askp_rsqn": "6140",
+ "total_bidp_rsqn": "10924"
+ },
+ {
+ "stck_shrn_iscd": "276730",
+ "hts_kor_isnm": "제주맥주",
+ "stck_prpr": "1425",
+ "prdy_vrss": "81",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.03",
+ "stck_sdpr": "1344",
+ "seln_rsqn": "2279",
+ "askp": "1427",
+ "bidp": "1425",
+ "shnu_rsqn": "4898",
+ "cntg_vol": "74274",
+ "antc_tr_pbmn": "105840450",
+ "total_askp_rsqn": "33433",
+ "total_bidp_rsqn": "12694"
+ },
+ {
+ "stck_shrn_iscd": "161580",
+ "hts_kor_isnm": "필옵틱스",
+ "stck_prpr": "17020",
+ "prdy_vrss": "950",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.91",
+ "stck_sdpr": "16070",
+ "seln_rsqn": "916",
+ "askp": "17030",
+ "bidp": "17020",
+ "shnu_rsqn": "3118",
+ "cntg_vol": "191675",
+ "antc_tr_pbmn": "3262308500",
+ "total_askp_rsqn": "13074",
+ "total_bidp_rsqn": "22881"
+ },
+ {
+ "stck_shrn_iscd": "000040",
+ "hts_kor_isnm": "KR모터스",
+ "stck_prpr": "1624",
+ "prdy_vrss": "90",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.87",
+ "stck_sdpr": "1624",
+ "seln_rsqn": "7317",
+ "askp": "1624",
+ "bidp": "1623",
+ "shnu_rsqn": "1",
+ "cntg_vol": "78804",
+ "antc_tr_pbmn": "49541596",
+ "total_askp_rsqn": "4228",
+ "total_bidp_rsqn": "4191"
+ },
+ {
+ "stck_shrn_iscd": "234920",
+ "hts_kor_isnm": "자이글",
+ "stck_prpr": "8940",
+ "prdy_vrss": "490",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.80",
+ "stck_sdpr": "8450",
+ "seln_rsqn": "230",
+ "askp": "8940",
+ "bidp": "8920",
+ "shnu_rsqn": "85",
+ "cntg_vol": "4391",
+ "antc_tr_pbmn": "39255540",
+ "total_askp_rsqn": "2307",
+ "total_bidp_rsqn": "7692"
+ },
+ {
+ "stck_shrn_iscd": "297890",
+ "hts_kor_isnm": "HB솔루션",
+ "stck_prpr": "4370",
+ "prdy_vrss": "215",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.17",
+ "stck_sdpr": "4155",
+ "seln_rsqn": "7844",
+ "askp": "4370",
+ "bidp": "4365",
+ "shnu_rsqn": "3918",
+ "cntg_vol": "116931",
+ "antc_tr_pbmn": "510988470",
+ "total_askp_rsqn": "183035",
+ "total_bidp_rsqn": "40374"
+ },
+ {
+ "stck_shrn_iscd": "457190",
+ "hts_kor_isnm": "이수스페셜티케미컬",
+ "stck_prpr": "360000",
+ "prdy_vrss": "17500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.11",
+ "stck_sdpr": "342500",
+ "seln_rsqn": "144",
+ "askp": "360500",
+ "bidp": "360000",
+ "shnu_rsqn": "73",
+ "cntg_vol": "8151",
+ "antc_tr_pbmn": "1575276500",
+ "total_askp_rsqn": "5572",
+ "total_bidp_rsqn": "1942"
+ },
+ {
+ "stck_shrn_iscd": "060230",
+ "hts_kor_isnm": "소니드",
+ "stck_prpr": "2200",
+ "prdy_vrss": "105",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.01",
+ "stck_sdpr": "2095",
+ "seln_rsqn": "296",
+ "askp": "2200",
+ "bidp": "2195",
+ "shnu_rsqn": "630",
+ "cntg_vol": "11412",
+ "antc_tr_pbmn": "134993250",
+ "total_askp_rsqn": "52480",
+ "total_bidp_rsqn": "54345"
+ },
+ {
+ "stck_shrn_iscd": "101670",
+ "hts_kor_isnm": "하이드로리튬",
+ "stck_prpr": "6490",
+ "prdy_vrss": "300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.85",
+ "stck_sdpr": "6190",
+ "seln_rsqn": "160",
+ "askp": "6490",
+ "bidp": "6480",
+ "shnu_rsqn": "660",
+ "cntg_vol": "39612",
+ "antc_tr_pbmn": "734458480",
+ "total_askp_rsqn": "97472",
+ "total_bidp_rsqn": "88960"
+ },
+ {
+ "stck_shrn_iscd": "303030",
+ "hts_kor_isnm": "지니틱스",
+ "stck_prpr": "2275",
+ "prdy_vrss": "105",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.84",
+ "stck_sdpr": "2170",
+ "seln_rsqn": "922",
+ "askp": "2275",
+ "bidp": "2255",
+ "shnu_rsqn": "6749",
+ "cntg_vol": "9329",
+ "antc_tr_pbmn": "21223475",
+ "total_askp_rsqn": "24653",
+ "total_bidp_rsqn": "32378"
+ },
+ {
+ "stck_shrn_iscd": "017940",
+ "hts_kor_isnm": "E1",
+ "stck_prpr": "73800",
+ "prdy_vrss": "3400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.83",
+ "stck_sdpr": "70400",
+ "seln_rsqn": "306",
+ "askp": "73800",
+ "bidp": "73700",
+ "shnu_rsqn": "24",
+ "cntg_vol": "7337",
+ "antc_tr_pbmn": "541470600",
+ "total_askp_rsqn": "1165",
+ "total_bidp_rsqn": "2062"
+ },
+ {
+ "stck_shrn_iscd": "237690",
+ "hts_kor_isnm": "에스티팜",
+ "stck_prpr": "81300",
+ "prdy_vrss": "3700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.77",
+ "stck_sdpr": "77600",
+ "seln_rsqn": "834",
+ "askp": "81400",
+ "bidp": "81300",
+ "shnu_rsqn": "312",
+ "cntg_vol": "14128",
+ "antc_tr_pbmn": "1147201200",
+ "total_askp_rsqn": "9707",
+ "total_bidp_rsqn": "10412"
+ },
+ {
+ "stck_shrn_iscd": "082210",
+ "hts_kor_isnm": "옵트론텍",
+ "stck_prpr": "4300",
+ "prdy_vrss": "185",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.50",
+ "stck_sdpr": "4115",
+ "seln_rsqn": "327",
+ "askp": "4305",
+ "bidp": "4300",
+ "shnu_rsqn": "2099",
+ "cntg_vol": "30755",
+ "antc_tr_pbmn": "132246500",
+ "total_askp_rsqn": "10418",
+ "total_bidp_rsqn": "25612"
+ },
+ {
+ "stck_shrn_iscd": "049120",
+ "hts_kor_isnm": "파인디앤씨",
+ "stck_prpr": "1385",
+ "prdy_vrss": "59",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.45",
+ "stck_sdpr": "1326",
+ "seln_rsqn": "973",
+ "askp": "1429",
+ "bidp": "1385",
+ "shnu_rsqn": "830",
+ "cntg_vol": "442",
+ "antc_tr_pbmn": "612170",
+ "total_askp_rsqn": "4905",
+ "total_bidp_rsqn": "8454"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/140_국내주식-089_국내주식-호가잔량-순위.md b/docs/broker/kis/rest/국내주식/순위분석/140_국내주식-089_국내주식-호가잔량-순위.md
new file mode 100644
index 0000000..4daf46c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/140_국내주식-089_국내주식-호가잔량-순위.md
@@ -0,0 +1,571 @@
+# 국내주식 호가잔량 순위
+
+- 원본 시트명: 국내주식 호가잔량 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-089
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01720000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/quote-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 호가잔량 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0172] 호가잔량 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01720000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20172 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000(전체) 코스피(0001), 코스닥(1001), 코스피200(2001) |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0: 순매수잔량순, 1:순매도잔량순, 2:매수비율순, 3:매도비율순 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| total_ntsl_bidp_rsqn | 총 순 매수호가 잔량 | string | Y | 12 | |
+| shnu_rsqn_rate | 매수 잔량 비율 | string | Y | 84 | |
+| seln_rsqn_rate | 매도 잔량 비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20172",
+"fid_input_iscd":"0000",
+"fid_rank_sort_cls_code":"0",
+"fid_div_cls_code":"0",
+"fid_trgt_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "Q530036",
+ "data_rank": "1",
+ "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
+ "stck_prpr": "92",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "4019460",
+ "total_askp_rsqn": "27327397",
+ "total_bidp_rsqn": "59778444",
+ "total_ntsl_bidp_rsqn": "32451047",
+ "shnu_rsqn_rate": "68.63",
+ "seln_rsqn_rate": "31.37"
+ },
+ {
+ "mksc_shrn_iscd": "003410",
+ "data_rank": "2",
+ "hts_kor_isnm": "쌍용C&E",
+ "stck_prpr": "7000",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "83785",
+ "total_askp_rsqn": "238068",
+ "total_bidp_rsqn": "22904795",
+ "total_ntsl_bidp_rsqn": "22666727",
+ "shnu_rsqn_rate": "98.97",
+ "seln_rsqn_rate": "1.03"
+ },
+ {
+ "mksc_shrn_iscd": "252670",
+ "data_rank": "3",
+ "hts_kor_isnm": "KODEX 200선물인버스2X",
+ "stck_prpr": "2180",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "45344920",
+ "total_askp_rsqn": "16674598",
+ "total_bidp_rsqn": "26686853",
+ "total_ntsl_bidp_rsqn": "10012255",
+ "shnu_rsqn_rate": "61.55",
+ "seln_rsqn_rate": "38.45"
+ },
+ {
+ "mksc_shrn_iscd": "114800",
+ "data_rank": "4",
+ "hts_kor_isnm": "KODEX 인버스",
+ "stck_prpr": "4275",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "4988727",
+ "total_askp_rsqn": "5715746",
+ "total_bidp_rsqn": "9303814",
+ "total_ntsl_bidp_rsqn": "3588068",
+ "shnu_rsqn_rate": "61.94",
+ "seln_rsqn_rate": "38.06"
+ },
+ {
+ "mksc_shrn_iscd": "018000",
+ "data_rank": "5",
+ "hts_kor_isnm": "유니슨",
+ "stck_prpr": "1233",
+ "prdy_vrss": "215",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "21.12",
+ "acml_vol": "2436474",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "2617859",
+ "total_ntsl_bidp_rsqn": "2617859",
+ "shnu_rsqn_rate": "100.00",
+ "seln_rsqn_rate": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "005930",
+ "data_rank": "6",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "72800",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.69",
+ "acml_vol": "3310579",
+ "total_askp_rsqn": "970901",
+ "total_bidp_rsqn": "2358190",
+ "total_ntsl_bidp_rsqn": "1387289",
+ "shnu_rsqn_rate": "70.84",
+ "seln_rsqn_rate": "29.16"
+ },
+ {
+ "mksc_shrn_iscd": "251340",
+ "data_rank": "7",
+ "hts_kor_isnm": "KODEX 코스닥150선물인버스",
+ "stck_prpr": "3315",
+ "prdy_vrss": "-65",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.92",
+ "acml_vol": "20976556",
+ "total_askp_rsqn": "5821013",
+ "total_bidp_rsqn": "6913597",
+ "total_ntsl_bidp_rsqn": "1092584",
+ "shnu_rsqn_rate": "54.29",
+ "seln_rsqn_rate": "45.71"
+ },
+ {
+ "mksc_shrn_iscd": "Q550074",
+ "data_rank": "8",
+ "hts_kor_isnm": "QV 블룸버그 2X 천연가스 선물 ETN(H)",
+ "stck_prpr": "395",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "381899",
+ "total_askp_rsqn": "156122",
+ "total_bidp_rsqn": "1037967",
+ "total_ntsl_bidp_rsqn": "881845",
+ "shnu_rsqn_rate": "86.93",
+ "seln_rsqn_rate": "13.07"
+ },
+ {
+ "mksc_shrn_iscd": "Q500027",
+ "data_rank": "9",
+ "hts_kor_isnm": "신한 인버스 2X WTI원유 선물 ETN(H)",
+ "stck_prpr": "81",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "535276",
+ "total_askp_rsqn": "45614576",
+ "total_bidp_rsqn": "46290045",
+ "total_ntsl_bidp_rsqn": "675469",
+ "shnu_rsqn_rate": "50.37",
+ "seln_rsqn_rate": "49.63"
+ },
+ {
+ "mksc_shrn_iscd": "900110",
+ "data_rank": "10",
+ "hts_kor_isnm": "이스트아시아홀딩스",
+ "stck_prpr": "93",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "680301",
+ "total_askp_rsqn": "1831739",
+ "total_bidp_rsqn": "2470524",
+ "total_ntsl_bidp_rsqn": "638785",
+ "shnu_rsqn_rate": "57.42",
+ "seln_rsqn_rate": "42.58"
+ },
+ {
+ "mksc_shrn_iscd": "900280",
+ "data_rank": "11",
+ "hts_kor_isnm": "골든센츄리",
+ "stck_prpr": "128",
+ "prdy_vrss": "-1",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.78",
+ "acml_vol": "742379",
+ "total_askp_rsqn": "1028799",
+ "total_bidp_rsqn": "1485157",
+ "total_ntsl_bidp_rsqn": "456358",
+ "shnu_rsqn_rate": "59.08",
+ "seln_rsqn_rate": "40.92"
+ },
+ {
+ "mksc_shrn_iscd": "001470",
+ "data_rank": "12",
+ "hts_kor_isnm": "삼부토건",
+ "stck_prpr": "2535",
+ "prdy_vrss": "-155",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.76",
+ "acml_vol": "7133448",
+ "total_askp_rsqn": "257260",
+ "total_bidp_rsqn": "713292",
+ "total_ntsl_bidp_rsqn": "456032",
+ "shnu_rsqn_rate": "73.49",
+ "seln_rsqn_rate": "26.51"
+ },
+ {
+ "mksc_shrn_iscd": "252710",
+ "data_rank": "13",
+ "hts_kor_isnm": "TIGER 200선물인버스2X",
+ "stck_prpr": "2310",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.22",
+ "acml_vol": "1556254",
+ "total_askp_rsqn": "314399",
+ "total_bidp_rsqn": "757848",
+ "total_ntsl_bidp_rsqn": "443449",
+ "shnu_rsqn_rate": "70.68",
+ "seln_rsqn_rate": "29.32"
+ },
+ {
+ "mksc_shrn_iscd": "010140",
+ "data_rank": "14",
+ "hts_kor_isnm": "삼성중공업",
+ "stck_prpr": "8930",
+ "prdy_vrss": "80",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.90",
+ "acml_vol": "6043474",
+ "total_askp_rsqn": "176430",
+ "total_bidp_rsqn": "487408",
+ "total_ntsl_bidp_rsqn": "310978",
+ "shnu_rsqn_rate": "73.42",
+ "seln_rsqn_rate": "26.58"
+ },
+ {
+ "mksc_shrn_iscd": "271050",
+ "data_rank": "15",
+ "hts_kor_isnm": "KODEX WTI원유선물인버스(H)",
+ "stck_prpr": "4190",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.24",
+ "acml_vol": "106936",
+ "total_askp_rsqn": "201253",
+ "total_bidp_rsqn": "458790",
+ "total_ntsl_bidp_rsqn": "257537",
+ "shnu_rsqn_rate": "69.51",
+ "seln_rsqn_rate": "30.49"
+ },
+ {
+ "mksc_shrn_iscd": "453850",
+ "data_rank": "16",
+ "hts_kor_isnm": "ACE 미국30년국채액티브(H)",
+ "stck_prpr": "8540",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.35",
+ "acml_vol": "413651",
+ "total_askp_rsqn": "394820",
+ "total_bidp_rsqn": "641051",
+ "total_ntsl_bidp_rsqn": "246231",
+ "shnu_rsqn_rate": "61.89",
+ "seln_rsqn_rate": "38.11"
+ },
+ {
+ "mksc_shrn_iscd": "031860",
+ "data_rank": "17",
+ "hts_kor_isnm": "에스유홀딩스",
+ "stck_prpr": "200",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.56",
+ "acml_vol": "3005608",
+ "total_askp_rsqn": "592337",
+ "total_bidp_rsqn": "834037",
+ "total_ntsl_bidp_rsqn": "241700",
+ "shnu_rsqn_rate": "58.47",
+ "seln_rsqn_rate": "41.53"
+ },
+ {
+ "mksc_shrn_iscd": "123310",
+ "data_rank": "18",
+ "hts_kor_isnm": "TIGER 인버스",
+ "stck_prpr": "4790",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "61009",
+ "total_askp_rsqn": "1040106",
+ "total_bidp_rsqn": "1274948",
+ "total_ntsl_bidp_rsqn": "234842",
+ "shnu_rsqn_rate": "55.07",
+ "seln_rsqn_rate": "44.93"
+ },
+ {
+ "mksc_shrn_iscd": "066790",
+ "data_rank": "19",
+ "hts_kor_isnm": "씨씨에스",
+ "stck_prpr": "5460",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.18",
+ "acml_vol": "5044542",
+ "total_askp_rsqn": "79481",
+ "total_bidp_rsqn": "289718",
+ "total_ntsl_bidp_rsqn": "210237",
+ "shnu_rsqn_rate": "78.47",
+ "seln_rsqn_rate": "21.53"
+ },
+ {
+ "mksc_shrn_iscd": "152550",
+ "data_rank": "20",
+ "hts_kor_isnm": "한국ANKOR유전",
+ "stck_prpr": "353",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.40",
+ "acml_vol": "439971",
+ "total_askp_rsqn": "127722",
+ "total_bidp_rsqn": "327363",
+ "total_ntsl_bidp_rsqn": "199641",
+ "shnu_rsqn_rate": "71.93",
+ "seln_rsqn_rate": "28.07"
+ },
+ {
+ "mksc_shrn_iscd": "007460",
+ "data_rank": "21",
+ "hts_kor_isnm": "에이프로젠",
+ "stck_prpr": "1078",
+ "prdy_vrss": "6",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.56",
+ "acml_vol": "4547618",
+ "total_askp_rsqn": "14915",
+ "total_bidp_rsqn": "212791",
+ "total_ntsl_bidp_rsqn": "197876",
+ "shnu_rsqn_rate": "93.45",
+ "seln_rsqn_rate": "6.55"
+ },
+ {
+ "mksc_shrn_iscd": "016600",
+ "data_rank": "22",
+ "hts_kor_isnm": "큐캐피탈",
+ "stck_prpr": "324",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "127470",
+ "total_askp_rsqn": "56103",
+ "total_bidp_rsqn": "251242",
+ "total_ntsl_bidp_rsqn": "195139",
+ "shnu_rsqn_rate": "81.75",
+ "seln_rsqn_rate": "18.25"
+ },
+ {
+ "mksc_shrn_iscd": "261260",
+ "data_rank": "23",
+ "hts_kor_isnm": "KODEX 미국달러선물인버스2X",
+ "stck_prpr": "6350",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.63",
+ "acml_vol": "132188",
+ "total_askp_rsqn": "208219",
+ "total_bidp_rsqn": "394699",
+ "total_ntsl_bidp_rsqn": "186480",
+ "shnu_rsqn_rate": "65.46",
+ "seln_rsqn_rate": "34.54"
+ },
+ {
+ "mksc_shrn_iscd": "032640",
+ "data_rank": "24",
+ "hts_kor_isnm": "LG유플러스",
+ "stck_prpr": "10000",
+ "prdy_vrss": "-60",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.60",
+ "acml_vol": "208413",
+ "total_askp_rsqn": "69973",
+ "total_bidp_rsqn": "241811",
+ "total_ntsl_bidp_rsqn": "171838",
+ "shnu_rsqn_rate": "77.56",
+ "seln_rsqn_rate": "22.44"
+ },
+ {
+ "mksc_shrn_iscd": "000890",
+ "data_rank": "25",
+ "hts_kor_isnm": "보해양조",
+ "stck_prpr": "499",
+ "prdy_vrss": "-1",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.20",
+ "acml_vol": "33688",
+ "total_askp_rsqn": "42161",
+ "total_bidp_rsqn": "204169",
+ "total_ntsl_bidp_rsqn": "162008",
+ "shnu_rsqn_rate": "82.88",
+ "seln_rsqn_rate": "17.12"
+ },
+ {
+ "mksc_shrn_iscd": "115530",
+ "data_rank": "26",
+ "hts_kor_isnm": "씨엔플러스",
+ "stck_prpr": "345",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "8657778",
+ "total_askp_rsqn": "38681",
+ "total_bidp_rsqn": "197775",
+ "total_ntsl_bidp_rsqn": "159094",
+ "shnu_rsqn_rate": "83.64",
+ "seln_rsqn_rate": "16.36"
+ },
+ {
+ "mksc_shrn_iscd": "475280",
+ "data_rank": "27",
+ "hts_kor_isnm": "ACE 8월만기자동연장회사채AA-이상액티브",
+ "stck_prpr": "10065",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.05",
+ "acml_vol": "1029",
+ "total_askp_rsqn": "43999",
+ "total_bidp_rsqn": "202972",
+ "total_ntsl_bidp_rsqn": "158973",
+ "shnu_rsqn_rate": "82.18",
+ "seln_rsqn_rate": "17.82"
+ },
+ {
+ "mksc_shrn_iscd": "082660",
+ "data_rank": "28",
+ "hts_kor_isnm": "코스나인",
+ "stck_prpr": "281",
+ "prdy_vrss": "1",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "197620",
+ "total_askp_rsqn": "68474",
+ "total_bidp_rsqn": "220086",
+ "total_ntsl_bidp_rsqn": "151612",
+ "shnu_rsqn_rate": "76.27",
+ "seln_rsqn_rate": "23.73"
+ },
+ {
+ "mksc_shrn_iscd": "365590",
+ "data_rank": "29",
+ "hts_kor_isnm": "하이딥",
+ "stck_prpr": "1419",
+ "prdy_vrss": "-4",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.28",
+ "acml_vol": "34996",
+ "total_askp_rsqn": "2430",
+ "total_bidp_rsqn": "150999",
+ "total_ntsl_bidp_rsqn": "148569",
+ "shnu_rsqn_rate": "98.42",
+ "seln_rsqn_rate": "1.58"
+ },
+ {
+ "mksc_shrn_iscd": "000680",
+ "data_rank": "30",
+ "hts_kor_isnm": "LS네트웍스",
+ "stck_prpr": "5400",
+ "prdy_vrss": "-240",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.26",
+ "acml_vol": "6399421",
+ "total_askp_rsqn": "103613",
+ "total_bidp_rsqn": "248579",
+ "total_ntsl_bidp_rsqn": "144966",
+ "shnu_rsqn_rate": "70.58",
+ "seln_rsqn_rate": "29.42"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/141_국내주식-109_국내주식-신용잔고-상위.md b/docs/broker/kis/rest/국내주식/순위분석/141_국내주식-109_국내주식-신용잔고-상위.md
new file mode 100644
index 0000000..4ed439e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/141_국내주식-109_국내주식-신용잔고-상위.md
@@ -0,0 +1,985 @@
+# 국내주식 신용잔고 상위
+
+- 원본 시트명: 국내주식 신용잔고 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-109
+- HTTP Method: GET
+- 실전 TR_ID: FHKST17010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/credit-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 신용잔고 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0475] 신용잔고 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST17010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11701) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, |
+| FID_OPTION | 증가율기간 | string | Y | 5 | 2~999 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | '(융자)0:잔고비율 상위, 1: 잔고수량 상위, 2: 잔고금액 상위, 3: 잔고비율 증가상위, 4: 잔고비율 감소상위
(대주)5:잔고비율 상위, 6: 잔고수량 상위, 7: 잔고금액 상위, 8: 잔고비율 증가상위, 9: 잔고비율 감소상위 ' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stnd_date1 | 기준 일자1 | string | Y | 8 | |
+| stnd_date2 | 기준 일자2 | string | Y | 8 | |
+| output2 | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| whol_loan_rmnd_stcn | 전체 융자 잔고 주수 | string | Y | 18 | |
+| whol_loan_rmnd_amt | 전체 융자 잔고 금액 | string | Y | 18 | |
+| whol_loan_rmnd_rate | 전체 융자 잔고 비율 | string | Y | 84 | |
+| whol_stln_rmnd_stcn | 전체 대주 잔고 주수 | string | Y | 18 | |
+| whol_stln_rmnd_amt | 전체 대주 잔고 금액 | string | Y | 18 | |
+| whol_stln_rmnd_rate | 전체 대주 잔고 비율 | string | Y | 84 | |
+| nday_vrss_loan_rmnd_inrt | N일 대비 융자 잔고 증가율 | string | Y | 84 | |
+| nday_vrss_stln_rmnd_inrt | N일 대비 대주 잔고 증가율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_scr_div_code:11701
+fid_input_iscd:0000
+fid_option:2
+fid_cond_mrkt_div_code:J
+fid_rank_sort_cls_code:0
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "bstp_cls_code": "1001",
+ "hts_kor_isnm": "종합",
+ "stnd_date1": "20240409",
+ "stnd_date2": "20240411"
+ }
+ ],
+ "output2": [
+ {
+ "mksc_shrn_iscd": "089010",
+ "hts_kor_isnm": "켐트로닉스",
+ "stck_prpr": "28200",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.05",
+ "acml_vol": "2854589",
+ "whol_loan_rmnd_stcn": "1470604",
+ "whol_loan_rmnd_amt": "3312604",
+ "whol_loan_rmnd_rate": "9.68",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "2.61",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "083500",
+ "hts_kor_isnm": "에프엔에스테크",
+ "stck_prpr": "12770",
+ "prdy_vrss": "-390",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.96",
+ "acml_vol": "640177",
+ "whol_loan_rmnd_stcn": "830732",
+ "whol_loan_rmnd_amt": "919030",
+ "whol_loan_rmnd_rate": "9.68",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.98",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "251340",
+ "hts_kor_isnm": "KODEX 코스닥150선물인버스",
+ "stck_prpr": "3485",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.29",
+ "acml_vol": "35592555",
+ "whol_loan_rmnd_stcn": "13685692",
+ "whol_loan_rmnd_amt": "4699136",
+ "whol_loan_rmnd_rate": "9.54",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.46",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "054450",
+ "hts_kor_isnm": "텔레칩스",
+ "stck_prpr": "26350",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "158467",
+ "whol_loan_rmnd_stcn": "1382693",
+ "whol_loan_rmnd_amt": "3550014",
+ "whol_loan_rmnd_rate": "9.12",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.00",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "278650",
+ "hts_kor_isnm": "HLB바이오스텝",
+ "stck_prpr": "3815",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.60",
+ "acml_vol": "871174",
+ "whol_loan_rmnd_stcn": "7597070",
+ "whol_loan_rmnd_amt": "3006994",
+ "whol_loan_rmnd_rate": "8.87",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.04",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "297890",
+ "hts_kor_isnm": "HB솔루션",
+ "stck_prpr": "5260",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.57",
+ "acml_vol": "2140840",
+ "whol_loan_rmnd_stcn": "6471546",
+ "whol_loan_rmnd_amt": "2874725",
+ "whol_loan_rmnd_rate": "8.84",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.06",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "032680",
+ "hts_kor_isnm": "소프트센",
+ "stck_prpr": "647",
+ "prdy_vrss": "-2",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.31",
+ "acml_vol": "681480",
+ "whol_loan_rmnd_stcn": "8995737",
+ "whol_loan_rmnd_amt": "633909",
+ "whol_loan_rmnd_rate": "8.51",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.03",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "078150",
+ "hts_kor_isnm": "HB테크놀러지",
+ "stck_prpr": "3780",
+ "prdy_vrss": "90",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.44",
+ "acml_vol": "29649130",
+ "whol_loan_rmnd_stcn": "7819411",
+ "whol_loan_rmnd_amt": "2206799",
+ "whol_loan_rmnd_rate": "8.43",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.44",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "099430",
+ "hts_kor_isnm": "바이오플러스",
+ "stck_prpr": "6700",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "118929",
+ "whol_loan_rmnd_stcn": "4772558",
+ "whol_loan_rmnd_amt": "3391432",
+ "whol_loan_rmnd_rate": "8.23",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.07",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "032850",
+ "hts_kor_isnm": "비트컴퓨터",
+ "stck_prpr": "5940",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.17",
+ "acml_vol": "281559",
+ "whol_loan_rmnd_stcn": "1367824",
+ "whol_loan_rmnd_amt": "950448",
+ "whol_loan_rmnd_rate": "8.22",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.13",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "065450",
+ "hts_kor_isnm": "빅텍",
+ "stck_prpr": "5120",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.40",
+ "acml_vol": "1379901",
+ "whol_loan_rmnd_stcn": "2352791",
+ "whol_loan_rmnd_amt": "1054776",
+ "whol_loan_rmnd_rate": "8.20",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.63",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "085670",
+ "hts_kor_isnm": "뉴프렉스",
+ "stck_prpr": "7310",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.53",
+ "acml_vol": "483355",
+ "whol_loan_rmnd_stcn": "1993717",
+ "whol_loan_rmnd_amt": "1368148",
+ "whol_loan_rmnd_rate": "8.14",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.24",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "067310",
+ "hts_kor_isnm": "하나마이크론",
+ "stck_prpr": "31000",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.59",
+ "acml_vol": "2845444",
+ "whol_loan_rmnd_stcn": "4197874",
+ "whol_loan_rmnd_amt": "10546224",
+ "whol_loan_rmnd_rate": "8.04",
+ "whol_stln_rmnd_stcn": "8766",
+ "whol_stln_rmnd_amt": "22042",
+ "whol_stln_rmnd_rate": "0.01",
+ "nday_vrss_loan_rmnd_inrt": "0.54",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "032580",
+ "hts_kor_isnm": "피델릭스",
+ "stck_prpr": "1664",
+ "prdy_vrss": "-13",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.78",
+ "acml_vol": "673012",
+ "whol_loan_rmnd_stcn": "2660198",
+ "whol_loan_rmnd_amt": "417362",
+ "whol_loan_rmnd_rate": "8.02",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.76",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "119850",
+ "hts_kor_isnm": "지엔씨에너지",
+ "stck_prpr": "8300",
+ "prdy_vrss": "330",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.14",
+ "acml_vol": "2745093",
+ "whol_loan_rmnd_stcn": "1319084",
+ "whol_loan_rmnd_amt": "673602",
+ "whol_loan_rmnd_rate": "8.01",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.19",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "045660",
+ "hts_kor_isnm": "에이텍",
+ "stck_prpr": "14870",
+ "prdy_vrss": "1500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.22",
+ "acml_vol": "2077762",
+ "whol_loan_rmnd_stcn": "658980",
+ "whol_loan_rmnd_amt": "995291",
+ "whol_loan_rmnd_rate": "7.97",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.68",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "059120",
+ "hts_kor_isnm": "아진엑스텍",
+ "stck_prpr": "11330",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.26",
+ "acml_vol": "125062",
+ "whol_loan_rmnd_stcn": "774940",
+ "whol_loan_rmnd_amt": "842527",
+ "whol_loan_rmnd_rate": "7.94",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.09",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "060310",
+ "hts_kor_isnm": "3S",
+ "stck_prpr": "2870",
+ "prdy_vrss": "55",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.95",
+ "acml_vol": "2095206",
+ "whol_loan_rmnd_stcn": "3849904",
+ "whol_loan_rmnd_amt": "1168005",
+ "whol_loan_rmnd_rate": "7.92",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.32",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "013990",
+ "hts_kor_isnm": "아가방컴퍼니",
+ "stck_prpr": "5010",
+ "prdy_vrss": "15",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.30",
+ "acml_vol": "709707",
+ "whol_loan_rmnd_stcn": "2607393",
+ "whol_loan_rmnd_amt": "1326597",
+ "whol_loan_rmnd_rate": "7.92",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.03",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "084650",
+ "hts_kor_isnm": "랩지노믹스",
+ "stck_prpr": "2645",
+ "prdy_vrss": "-15",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.56",
+ "acml_vol": "386632",
+ "whol_loan_rmnd_stcn": "5866700",
+ "whol_loan_rmnd_amt": "2248239",
+ "whol_loan_rmnd_rate": "7.89",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.04",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "017040",
+ "hts_kor_isnm": "광명전기",
+ "stck_prpr": "2735",
+ "prdy_vrss": "55",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.05",
+ "acml_vol": "14782305",
+ "whol_loan_rmnd_stcn": "3396695",
+ "whol_loan_rmnd_amt": "797496",
+ "whol_loan_rmnd_rate": "7.82",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.28",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "053050",
+ "hts_kor_isnm": "지에스이",
+ "stck_prpr": "3630",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.55",
+ "acml_vol": "1063396",
+ "whol_loan_rmnd_stcn": "2335946",
+ "whol_loan_rmnd_amt": "852637",
+ "whol_loan_rmnd_rate": "7.78",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.21",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "123410",
+ "hts_kor_isnm": "코리아에프티",
+ "stck_prpr": "6550",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.76",
+ "acml_vol": "1739694",
+ "whol_loan_rmnd_stcn": "2168343",
+ "whol_loan_rmnd_amt": "1069541",
+ "whol_loan_rmnd_rate": "7.78",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.17",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "027580",
+ "hts_kor_isnm": "상보",
+ "stck_prpr": "1715",
+ "prdy_vrss": "14",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.82",
+ "acml_vol": "481651",
+ "whol_loan_rmnd_stcn": "4610038",
+ "whol_loan_rmnd_amt": "799793",
+ "whol_loan_rmnd_rate": "7.78",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.04",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "069410",
+ "hts_kor_isnm": "엔텔스",
+ "stck_prpr": "4840",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.41",
+ "acml_vol": "11108",
+ "whol_loan_rmnd_stcn": "792894",
+ "whol_loan_rmnd_amt": "445356",
+ "whol_loan_rmnd_rate": "7.73",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.01",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "011700",
+ "hts_kor_isnm": "한신기계",
+ "stck_prpr": "4325",
+ "prdy_vrss": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.93",
+ "acml_vol": "234574",
+ "whol_loan_rmnd_stcn": "2506499",
+ "whol_loan_rmnd_amt": "1243551",
+ "whol_loan_rmnd_rate": "7.71",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.08",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "441270",
+ "hts_kor_isnm": "파인엠텍",
+ "stck_prpr": "8290",
+ "prdy_vrss": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.48",
+ "acml_vol": "120184",
+ "whol_loan_rmnd_stcn": "2808021",
+ "whol_loan_rmnd_amt": "2237689",
+ "whol_loan_rmnd_rate": "7.60",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.03",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "058850",
+ "hts_kor_isnm": "KTcs",
+ "stck_prpr": "3255",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.91",
+ "acml_vol": "315560",
+ "whol_loan_rmnd_stcn": "3240142",
+ "whol_loan_rmnd_amt": "1142392",
+ "whol_loan_rmnd_rate": "7.58",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.03",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "091580",
+ "hts_kor_isnm": "상신이디피",
+ "stck_prpr": "16320",
+ "prdy_vrss": "-290",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.75",
+ "acml_vol": "116376",
+ "whol_loan_rmnd_stcn": "1013775",
+ "whol_loan_rmnd_amt": "1820763",
+ "whol_loan_rmnd_rate": "7.54",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.12",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "200710",
+ "hts_kor_isnm": "에이디테크놀로지",
+ "stck_prpr": "43200",
+ "prdy_vrss": "1400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.35",
+ "acml_vol": "768752",
+ "whol_loan_rmnd_stcn": "1005663",
+ "whol_loan_rmnd_amt": "3141897",
+ "whol_loan_rmnd_rate": "7.48",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.02",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "033170",
+ "hts_kor_isnm": "시그네틱스",
+ "stck_prpr": "1768",
+ "prdy_vrss": "-14",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.79",
+ "acml_vol": "1353436",
+ "whol_loan_rmnd_stcn": "6362245",
+ "whol_loan_rmnd_amt": "1042181",
+ "whol_loan_rmnd_rate": "7.41",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.05",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "272110",
+ "hts_kor_isnm": "케이엔제이",
+ "stck_prpr": "19920",
+ "prdy_vrss": "-380",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.87",
+ "acml_vol": "526814",
+ "whol_loan_rmnd_stcn": "587700",
+ "whol_loan_rmnd_amt": "1035337",
+ "whol_loan_rmnd_rate": "7.36",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "2.89",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "126700",
+ "hts_kor_isnm": "하이비젼시스템",
+ "stck_prpr": "21750",
+ "prdy_vrss": "450",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.11",
+ "acml_vol": "250245",
+ "whol_loan_rmnd_stcn": "1081067",
+ "whol_loan_rmnd_amt": "2198402",
+ "whol_loan_rmnd_rate": "7.23",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.06",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "064480",
+ "hts_kor_isnm": "브리지텍",
+ "stck_prpr": "7080",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "70003",
+ "whol_loan_rmnd_stcn": "862374",
+ "whol_loan_rmnd_amt": "674845",
+ "whol_loan_rmnd_rate": "7.20",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.13",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "049070",
+ "hts_kor_isnm": "인탑스",
+ "stck_prpr": "27900",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.36",
+ "acml_vol": "120198",
+ "whol_loan_rmnd_stcn": "1240516",
+ "whol_loan_rmnd_amt": "3631525",
+ "whol_loan_rmnd_rate": "7.20",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.08",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "102120",
+ "hts_kor_isnm": "어보브반도체",
+ "stck_prpr": "16450",
+ "prdy_vrss": "430",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.68",
+ "acml_vol": "1247402",
+ "whol_loan_rmnd_stcn": "1274613",
+ "whol_loan_rmnd_amt": "1945592",
+ "whol_loan_rmnd_rate": "7.16",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.09",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "242040",
+ "hts_kor_isnm": "나무기술",
+ "stck_prpr": "2270",
+ "prdy_vrss": "45",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.02",
+ "acml_vol": "294303",
+ "whol_loan_rmnd_stcn": "2464083",
+ "whol_loan_rmnd_amt": "521855",
+ "whol_loan_rmnd_rate": "7.11",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.05",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "092870",
+ "hts_kor_isnm": "엑시콘",
+ "stck_prpr": "28450",
+ "prdy_vrss": "200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.71",
+ "acml_vol": "1115639",
+ "whol_loan_rmnd_stcn": "771959",
+ "whol_loan_rmnd_amt": "1866596",
+ "whol_loan_rmnd_rate": "7.10",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.29",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "173130",
+ "hts_kor_isnm": "오파스넷",
+ "stck_prpr": "7450",
+ "prdy_vrss": "-90",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.19",
+ "acml_vol": "190126",
+ "whol_loan_rmnd_stcn": "841989",
+ "whol_loan_rmnd_amt": "874835",
+ "whol_loan_rmnd_rate": "7.08",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.16",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "036010",
+ "hts_kor_isnm": "아비코전자",
+ "stck_prpr": "12240",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.57",
+ "acml_vol": "87854",
+ "whol_loan_rmnd_stcn": "942948",
+ "whol_loan_rmnd_amt": "1134247",
+ "whol_loan_rmnd_rate": "7.08",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.04",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "317850",
+ "hts_kor_isnm": "대모",
+ "stck_prpr": "8930",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.11",
+ "acml_vol": "39218",
+ "whol_loan_rmnd_stcn": "587385",
+ "whol_loan_rmnd_amt": "537776",
+ "whol_loan_rmnd_rate": "7.05",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.06",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "356860",
+ "hts_kor_isnm": "티엘비",
+ "stck_prpr": "28100",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.18",
+ "acml_vol": "768183",
+ "whol_loan_rmnd_stcn": "691435",
+ "whol_loan_rmnd_amt": "1698227",
+ "whol_loan_rmnd_rate": "7.02",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.13",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "053690",
+ "hts_kor_isnm": "한미글로벌",
+ "stck_prpr": "15970",
+ "prdy_vrss": "460",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.97",
+ "acml_vol": "114724",
+ "whol_loan_rmnd_stcn": "768802",
+ "whol_loan_rmnd_amt": "1565129",
+ "whol_loan_rmnd_rate": "7.01",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.00",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "119830",
+ "hts_kor_isnm": "아이텍",
+ "stck_prpr": "7800",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.26",
+ "acml_vol": "275384",
+ "whol_loan_rmnd_stcn": "1503355",
+ "whol_loan_rmnd_amt": "1210314",
+ "whol_loan_rmnd_rate": "7.00",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.12",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "079370",
+ "hts_kor_isnm": "제우스",
+ "stck_prpr": "17070",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.29",
+ "acml_vol": "486845",
+ "whol_loan_rmnd_stcn": "2170538",
+ "whol_loan_rmnd_amt": "3909085",
+ "whol_loan_rmnd_rate": "6.99",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.06",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "013810",
+ "hts_kor_isnm": "스페코",
+ "stck_prpr": "4250",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.47",
+ "acml_vol": "1117693",
+ "whol_loan_rmnd_stcn": "1024951",
+ "whol_loan_rmnd_amt": "457257",
+ "whol_loan_rmnd_rate": "6.98",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.53",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "170030",
+ "hts_kor_isnm": "현대공업",
+ "stck_prpr": "7160",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.56",
+ "acml_vol": "62752",
+ "whol_loan_rmnd_stcn": "1070944",
+ "whol_loan_rmnd_amt": "791679",
+ "whol_loan_rmnd_rate": "6.97",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.07",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "105840",
+ "hts_kor_isnm": "우진",
+ "stck_prpr": "8040",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.25",
+ "acml_vol": "213279",
+ "whol_loan_rmnd_stcn": "1414634",
+ "whol_loan_rmnd_amt": "1194554",
+ "whol_loan_rmnd_rate": "6.95",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.12",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "005870",
+ "hts_kor_isnm": "휴니드",
+ "stck_prpr": "7890",
+ "prdy_vrss": "260",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.41",
+ "acml_vol": "867287",
+ "whol_loan_rmnd_stcn": "970639",
+ "whol_loan_rmnd_amt": "596254",
+ "whol_loan_rmnd_rate": "6.86",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "0.21",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "058610",
+ "hts_kor_isnm": "에스피지",
+ "stck_prpr": "27900",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.18",
+ "acml_vol": "123557",
+ "whol_loan_rmnd_stcn": "1508594",
+ "whol_loan_rmnd_amt": "4449364",
+ "whol_loan_rmnd_rate": "6.80",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.03",
+ "nday_vrss_stln_rmnd_inrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "089890",
+ "hts_kor_isnm": "코세스",
+ "stck_prpr": "14770",
+ "prdy_vrss": "460",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.21",
+ "acml_vol": "246072",
+ "whol_loan_rmnd_stcn": "1117343",
+ "whol_loan_rmnd_amt": "1591385",
+ "whol_loan_rmnd_rate": "6.73",
+ "whol_stln_rmnd_stcn": "0",
+ "whol_stln_rmnd_amt": "0",
+ "whol_stln_rmnd_rate": "0.00",
+ "nday_vrss_loan_rmnd_inrt": "-0.31",
+ "nday_vrss_stln_rmnd_
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/142_국내주식-139_국내주식-시간외거래량순위.md b/docs/broker/kis/rest/국내주식/순위분석/142_국내주식-139_국내주식-시간외거래량순위.md
new file mode 100644
index 0000000..5bfac07
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/142_국내주식-139_국내주식-시간외거래량순위.md
@@ -0,0 +1,605 @@
+# 국내주식 시간외거래량순위
+
+- 원본 시트명: 국내주식 시간외거래량순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-139
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02350000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/overtime-volume
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외거래량순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0235] 시간외 거래량순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02350000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J: 주식) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20235) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000(전체), 0001(코스피), 1001(코스닥) |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | 0(매수잔량), 1(매도잔량), 2(거래량) |
+| FID_INPUT_PRICE_1 | 입력 가격1 | string | Y | 12 | 가격 ~ |
+| FID_INPUT_PRICE_2 | 입력 가격2 | string | Y | 12 | ~ 가격 |
+| FID_VOL_CNT | 거래량 수 | string | Y | 12 | 거래량 ~ |
+| FID_TRGT_CLS_CODE | 대상 구분 코드 | string | Y | 32 | 공백 |
+| FID_TRGT_EXLS_CLS_CODE | 대상 제외 구분 코드 | string | Y | 32 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ovtm_untp_exch_vol | 시간외 단일가 거래소 거래량 | string | Y | 18 | |
+| ovtm_untp_exch_tr_pbmn | 시간외 단일가 거래소 거래대금 | string | Y | 18 | |
+| ovtm_untp_kosdaq_vol | 시간외 단일가 KOSDAQ 거래량 | string | Y | 18 | |
+| ovtm_untp_kosdaq_tr_pbmn | 시간외 단일가 KOSDAQ 거래대금 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | Y | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | Y | 82 | |
+| ovtm_untp_seln_rsqn | 시간외 단일가 매도 잔량 | string | Y | 12 | |
+| ovtm_untp_shnu_rsqn | 시간외 단일가 매수 잔량 | string | Y | 12 | |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | Y | 18 | |
+| ovtm_vrss_acml_vol_rlim | 시간외 대비 누적 거래량 비중 | string | Y | 52 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:20235
+FID_INPUT_ISCD:0000
+FID_RANK_SORT_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_VOL_CNT:
+FID_TRGT_CLS_CODE:
+FID_TRGT_EXLS_CLS_CODE:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ovtm_untp_exch_vol": "5806628",
+ "ovtm_untp_exch_tr_pbmn": "54755931392",
+ "ovtm_untp_kosdaq_vol": "5204621",
+ "ovtm_untp_kosdaq_tr_pbmn": "47577538957"
+ },
+ "output2": [
+ {
+ "stck_shrn_iscd": "024840",
+ "hts_kor_isnm": "KBI메탈",
+ "ovtm_untp_prpr": "1805",
+ "ovtm_untp_prdy_vrss": "164",
+ "ovtm_untp_prdy_vrss_sign": "1",
+ "ovtm_untp_prdy_ctrt": "9.99",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "1518111",
+ "ovtm_untp_vol": "830822",
+ "ovtm_vrss_acml_vol_rlim": "5.78",
+ "stck_prpr": "1641",
+ "acml_vol": "14376124",
+ "bidp": "1641",
+ "askp": "1642"
+ },
+ {
+ "stck_shrn_iscd": "251340",
+ "hts_kor_isnm": "KODEX 코스닥150선물인버스",
+ "ovtm_untp_prpr": "3480",
+ "ovtm_untp_prdy_vrss": "-5",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.14",
+ "ovtm_untp_seln_rsqn": "483261",
+ "ovtm_untp_shnu_rsqn": "1280469",
+ "ovtm_untp_vol": "271489",
+ "ovtm_vrss_acml_vol_rlim": "0.76",
+ "stck_prpr": "3485",
+ "acml_vol": "35798171",
+ "bidp": "3480",
+ "askp": "3485"
+ },
+ {
+ "stck_shrn_iscd": "Q530036",
+ "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
+ "ovtm_untp_prpr": "83",
+ "ovtm_untp_prdy_vrss": "-1",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-1.19",
+ "ovtm_untp_seln_rsqn": "733502",
+ "ovtm_untp_shnu_rsqn": "1129085",
+ "ovtm_untp_vol": "500",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "84",
+ "acml_vol": "14500093",
+ "bidp": "83",
+ "askp": "84"
+ },
+ {
+ "stck_shrn_iscd": "900110",
+ "hts_kor_isnm": "이스트아시아홀딩스",
+ "ovtm_untp_prpr": "92",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "116978",
+ "ovtm_untp_shnu_rsqn": "929131",
+ "ovtm_untp_vol": "3590",
+ "ovtm_vrss_acml_vol_rlim": "0.33",
+ "stck_prpr": "92",
+ "acml_vol": "1072096",
+ "bidp": "91",
+ "askp": "92"
+ },
+ {
+ "stck_shrn_iscd": "Q500027",
+ "hts_kor_isnm": "신한 인버스 2X WTI원유 선물 ETN(H)",
+ "ovtm_untp_prpr": "70",
+ "ovtm_untp_prdy_vrss": "-1",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-1.41",
+ "ovtm_untp_seln_rsqn": "146853",
+ "ovtm_untp_shnu_rsqn": "736280",
+ "ovtm_untp_vol": "800",
+ "ovtm_vrss_acml_vol_rlim": "0.01",
+ "stck_prpr": "71",
+ "acml_vol": "11331167",
+ "bidp": "70",
+ "askp": "71"
+ },
+ {
+ "stck_shrn_iscd": "900300",
+ "hts_kor_isnm": "오가닉티코스메틱",
+ "ovtm_untp_prpr": "86",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "259326",
+ "ovtm_untp_shnu_rsqn": "542857",
+ "ovtm_untp_vol": "2054",
+ "ovtm_vrss_acml_vol_rlim": "0.03",
+ "stck_prpr": "86",
+ "acml_vol": "6493528",
+ "bidp": "85",
+ "askp": "86"
+ },
+ {
+ "stck_shrn_iscd": "252670",
+ "hts_kor_isnm": "KODEX 200선물인버스2X",
+ "ovtm_untp_prpr": "2075",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "1095223",
+ "ovtm_untp_shnu_rsqn": "487107",
+ "ovtm_untp_vol": "385969",
+ "ovtm_vrss_acml_vol_rlim": "0.29",
+ "stck_prpr": "2075",
+ "acml_vol": "131543542",
+ "bidp": "2075",
+ "askp": "2080"
+ },
+ {
+ "stck_shrn_iscd": "900280",
+ "hts_kor_isnm": "골든센츄리",
+ "ovtm_untp_prpr": "105",
+ "ovtm_untp_prdy_vrss": "1",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "0.96",
+ "ovtm_untp_seln_rsqn": "305981",
+ "ovtm_untp_shnu_rsqn": "297740",
+ "ovtm_untp_vol": "112558",
+ "ovtm_vrss_acml_vol_rlim": "0.90",
+ "stck_prpr": "104",
+ "acml_vol": "12494891",
+ "bidp": "104",
+ "askp": "105"
+ },
+ {
+ "stck_shrn_iscd": "241770",
+ "hts_kor_isnm": "메카로",
+ "ovtm_untp_prpr": "11050",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "218703",
+ "ovtm_untp_vol": "14328",
+ "ovtm_vrss_acml_vol_rlim": "0.54",
+ "stck_prpr": "11050",
+ "acml_vol": "2660105",
+ "bidp": "11050",
+ "askp": "0"
+ },
+ {
+ "stck_shrn_iscd": "039740",
+ "hts_kor_isnm": "한국정보공학",
+ "ovtm_untp_prpr": "3705",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "212928",
+ "ovtm_untp_vol": "8904",
+ "ovtm_vrss_acml_vol_rlim": "0.32",
+ "stck_prpr": "3705",
+ "acml_vol": "2745049",
+ "bidp": "3705",
+ "askp": "0"
+ },
+ {
+ "stck_shrn_iscd": "443670",
+ "hts_kor_isnm": "에스피소프트",
+ "ovtm_untp_prpr": "19110",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "200228",
+ "ovtm_untp_vol": "8728",
+ "ovtm_vrss_acml_vol_rlim": "0.10",
+ "stck_prpr": "19110",
+ "acml_vol": "8933701",
+ "bidp": "19110",
+ "askp": "0"
+ },
+ {
+ "stck_shrn_iscd": "114800",
+ "hts_kor_isnm": "KODEX 인버스",
+ "ovtm_untp_prpr": "4180",
+ "ovtm_untp_prdy_vrss": "-5",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.12",
+ "ovtm_untp_seln_rsqn": "113209",
+ "ovtm_untp_shnu_rsqn": "132778",
+ "ovtm_untp_vol": "19807",
+ "ovtm_vrss_acml_vol_rlim": "0.08",
+ "stck_prpr": "4185",
+ "acml_vol": "23680596",
+ "bidp": "4180",
+ "askp": "4185"
+ },
+ {
+ "stck_shrn_iscd": "Q550043",
+ "hts_kor_isnm": "QV 인버스 레버리지 WTI원유 선물 ETN(H)",
+ "ovtm_untp_prpr": "65",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "0",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "9499",
+ "ovtm_untp_shnu_rsqn": "121250",
+ "ovtm_untp_vol": "0",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "65",
+ "acml_vol": "857825",
+ "bidp": "64",
+ "askp": "65"
+ },
+ {
+ "stck_shrn_iscd": "032800",
+ "hts_kor_isnm": "판타지오",
+ "ovtm_untp_prpr": "293",
+ "ovtm_untp_prdy_vrss": "-3",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-1.01",
+ "ovtm_untp_seln_rsqn": "23665",
+ "ovtm_untp_shnu_rsqn": "114241",
+ "ovtm_untp_vol": "243174",
+ "ovtm_vrss_acml_vol_rlim": "0.60",
+ "stck_prpr": "296",
+ "acml_vol": "40758423",
+ "bidp": "295",
+ "askp": "296"
+ },
+ {
+ "stck_shrn_iscd": "900120",
+ "hts_kor_isnm": "씨엑스아이",
+ "ovtm_untp_prpr": "114",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "51602",
+ "ovtm_untp_shnu_rsqn": "97874",
+ "ovtm_untp_vol": "6",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "114",
+ "acml_vol": "585089",
+ "bidp": "113",
+ "askp": "114"
+ },
+ {
+ "stck_shrn_iscd": "006345",
+ "hts_kor_isnm": "대원전선우",
+ "ovtm_untp_prpr": "4425",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "73543",
+ "ovtm_untp_vol": "53",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "4425",
+ "acml_vol": "2444147",
+ "bidp": "4425",
+ "askp": "0"
+ },
+ {
+ "stck_shrn_iscd": "152550",
+ "hts_kor_isnm": "한국ANKOR유전",
+ "ovtm_untp_prpr": "370",
+ "ovtm_untp_prdy_vrss": "1",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "0.27",
+ "ovtm_untp_seln_rsqn": "66842",
+ "ovtm_untp_shnu_rsqn": "67407",
+ "ovtm_untp_vol": "48762",
+ "ovtm_vrss_acml_vol_rlim": "1.29",
+ "stck_prpr": "369",
+ "acml_vol": "3781036",
+ "bidp": "368",
+ "askp": "369"
+ },
+ {
+ "stck_shrn_iscd": "036630",
+ "hts_kor_isnm": "세종텔레콤",
+ "ovtm_untp_prpr": "627",
+ "ovtm_untp_prdy_vrss": "-2",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.32",
+ "ovtm_untp_seln_rsqn": "794",
+ "ovtm_untp_shnu_rsqn": "53745",
+ "ovtm_untp_vol": "1660",
+ "ovtm_vrss_acml_vol_rlim": "0.97",
+ "stck_prpr": "629",
+ "acml_vol": "171476",
+ "bidp": "629",
+ "askp": "630"
+ },
+ {
+ "stck_shrn_iscd": "018470",
+ "hts_kor_isnm": "조일알미늄",
+ "ovtm_untp_prpr": "2375",
+ "ovtm_untp_prdy_vrss": "150",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.74",
+ "ovtm_untp_seln_rsqn": "84458",
+ "ovtm_untp_shnu_rsqn": "49908",
+ "ovtm_untp_vol": "1243060",
+ "ovtm_vrss_acml_vol_rlim": "12.24",
+ "stck_prpr": "2225",
+ "acml_vol": "10159482",
+ "bidp": "2225",
+ "askp": "2230"
+ },
+ {
+ "stck_shrn_iscd": "004410",
+ "hts_kor_isnm": "서울식품",
+ "ovtm_untp_prpr": "176",
+ "ovtm_untp_prdy_vrss": "1",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "0.57",
+ "ovtm_untp_seln_rsqn": "68739",
+ "ovtm_untp_shnu_rsqn": "49034",
+ "ovtm_untp_vol": "2",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "175",
+ "acml_vol": "648132",
+ "bidp": "175",
+ "askp": "176"
+ },
+ {
+ "stck_shrn_iscd": "015590",
+ "hts_kor_isnm": "KIB플러그에너지",
+ "ovtm_untp_prpr": "438",
+ "ovtm_untp_prdy_vrss": "1",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "0.23",
+ "ovtm_untp_seln_rsqn": "9286",
+ "ovtm_untp_shnu_rsqn": "45672",
+ "ovtm_untp_vol": "10598",
+ "ovtm_vrss_acml_vol_rlim": "0.30",
+ "stck_prpr": "437",
+ "acml_vol": "3556231",
+ "bidp": "437",
+ "askp": "438"
+ },
+ {
+ "stck_shrn_iscd": "011930",
+ "hts_kor_isnm": "신성이엔지",
+ "ovtm_untp_prpr": "2275",
+ "ovtm_untp_prdy_vrss": "-5",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.22",
+ "ovtm_untp_seln_rsqn": "14814",
+ "ovtm_untp_shnu_rsqn": "45606",
+ "ovtm_untp_vol": "24996",
+ "ovtm_vrss_acml_vol_rlim": "0.88",
+ "stck_prpr": "2280",
+ "acml_vol": "2824930",
+ "bidp": "2280",
+ "askp": "2285"
+ },
+ {
+ "stck_shrn_iscd": "001620",
+ "hts_kor_isnm": "케이비아이동국실업",
+ "ovtm_untp_prpr": "591",
+ "ovtm_untp_prdy_vrss": "-1",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.17",
+ "ovtm_untp_seln_rsqn": "6526",
+ "ovtm_untp_shnu_rsqn": "43357",
+ "ovtm_untp_vol": "10",
+ "ovtm_vrss_acml_vol_rlim": "0.01",
+ "stck_prpr": "592",
+ "acml_vol": "180490",
+ "bidp": "591",
+ "askp": "592"
+ },
+ {
+ "stck_shrn_iscd": "403490",
+ "hts_kor_isnm": "우듬지팜",
+ "ovtm_untp_prpr": "2220",
+ "ovtm_untp_prdy_vrss": "-5",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.22",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_shnu_rsqn": "39260",
+ "ovtm_untp_vol": "785",
+ "ovtm_vrss_acml_vol_rlim": "0.59",
+ "stck_prpr": "2225",
+ "acml_vol": "132387",
+ "bidp": "2225",
+ "askp": "2230"
+ },
+ {
+ "stck_shrn_iscd": "461030",
+ "hts_kor_isnm": "아이엠비디엑스",
+ "ovtm_untp_prpr": "20500",
+ "ovtm_untp_prdy_vrss": "-200",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.97",
+ "ovtm_untp_seln_rsqn": "2804",
+ "ovtm_untp_shnu_rsqn": "34783",
+ "ovtm_untp_vol": "14490",
+ "ovtm_vrss_acml_vol_rlim": "0.54",
+ "stck_prpr": "20700",
+ "acml_vol": "2705963",
+ "bidp": "20650",
+ "askp": "20700"
+ },
+ {
+ "stck_shrn_iscd": "012170",
+ "hts_kor_isnm": "아센디오",
+ "ovtm_untp_prpr": "1059",
+ "ovtm_untp_prdy_vrss": "-5",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.47",
+ "ovtm_untp_seln_rsqn": "2520",
+ "ovtm_untp_shnu_rsqn": "34715",
+ "ovtm_untp_vol": "7166",
+ "ovtm_vrss_acml_vol_rlim": "0.35",
+ "stck_prpr": "1064",
+ "acml_vol": "2070608",
+ "bidp": "1063",
+ "askp": "1064"
+ },
+ {
+ "stck_shrn_iscd": "177350",
+ "hts_kor_isnm": "베셀",
+ "ovtm_untp_prpr": "425",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "11404",
+ "ovtm_untp_shnu_rsqn": "33089",
+ "ovtm_untp_vol": "5185",
+ "ovtm_vrss_acml_vol_rlim": "0.15",
+ "stck_prpr": "425",
+ "acml_vol": "3365030",
+ "bidp": "425",
+ "askp": "426"
+ },
+ {
+ "stck_shrn_iscd": "017040",
+ "hts_kor_isnm": "광명전기",
+ "ovtm_untp_prpr": "2735",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "17827",
+ "ovtm_untp_shnu_rsqn": "33064",
+ "ovtm_untp_vol": "45996",
+ "ovtm_vrss_acml_vol_rlim": "0.31",
+ "stck_prpr": "2735",
+ "acml_vol": "14823773",
+ "bidp": "2735",
+ "askp": "2740"
+ },
+ {
+ "stck_shrn_iscd": "377220",
+ "hts_kor_isnm": "프롬바이오",
+ "ovtm_untp_prpr": "2170",
+ "ovtm_untp_prdy_vrss": "0",
+ "ovtm_untp_prdy_vrss_sign": "3",
+ "ovtm_untp_prdy_ctrt": "0.00",
+ "ovtm_untp_seln_rsqn": "1471",
+ "ovtm_untp_shnu_rsqn": "30408",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "2170",
+ "acml_vol": "220931",
+ "bidp": "2170",
+ "askp": "2190"
+ },
+ {
+ "stck_shrn_iscd": "005320",
+ "hts_kor_isnm": "국동",
+ "ovtm_untp_prpr": "613",
+ "ovtm_untp_prdy_vrss": "-4",
+ "ovtm_untp_prdy_vrss_sign": "5",
+ "ovtm_untp_prdy_ctrt": "-0.65",
+ "ovtm_untp_seln_rsqn": "3",
+ "ovtm_untp_shnu_rsqn": "29101",
+ "ovtm_untp_vol": "23",
+ "ovtm_vrss_acml_vol_rlim": "0.04",
+ "stck_prpr": "617",
+ "acml_vol": "56414",
+ "bidp": "616",
+ "askp": "617"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/143_국내주식-106_국내주식-배당률-상위.md b/docs/broker/kis/rest/국내주식/순위분석/143_국내주식-106_국내주식-배당률-상위.md
new file mode 100644
index 0000000..1ca8189
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/143_국내주식-106_국내주식-배당률-상위.md
@@ -0,0 +1,289 @@
+# 국내주식 배당률 상위
+
+- 원본 시트명: 국내주식 배당률 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-106
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB13470100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/dividend-rate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 배당률 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0188] 배당률 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB13470100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS_AREA | CTS_AREA | string | Y | 17 | 공백 |
+| GB1 | KOSPI | string | Y | 1 | 0:전체, 1:코스피, 2: 코스피200, 3: 코스닥, |
+| UPJONG | 업종구분 | string | Y | 4 | '코스피(0001:종합, 0002:대형주.…0027:제조업 ),
코스닥(1001:종합, …. 1041:IT부품
코스피200 (2001:KOSPI200, 2007:KOSPI100, 2008:KOSPI50)' |
+| GB2 | 종목선택 | string | Y | 1 | 0:전체, 6:보통주, 7:우선주 |
+| GB3 | 배당구분 | string | Y | 1 | 1:주식배당, 2: 현금배당 |
+| F_DT | 기준일From | string | Y | 8 | |
+| T_DT | 기준일To | string | Y | 8 | |
+| GB4 | 결산/중간배당 | string | Y | 1 | 0:전체, 1:결산배당, 2:중간배당 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| rank | 순위 | string | Y | 4 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| record_date | 기준일 | string | Y | 8 | |
+| per_sto_divi_amt | 현금/주식배당금 | string | Y | 12 | |
+| divi_rate | 현금/주식배당률(%) | string | Y | 62 | |
+| divi_kind | 배당종류 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CTS_AREA:
+GB1:0
+UPJONG:0001
+GB2:0
+GB3:1
+F_DT:20200101
+T_DT:20240403
+GB4:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "rank": "1",
+ "sht_cd": "089600",
+ "isin_name": "나스미디어",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "2",
+ "sht_cd": "089600",
+ "isin_name": "나스미디어",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "3",
+ "sht_cd": "089600",
+ "isin_name": "나스미디어",
+ "record_date": "20221231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "4",
+ "sht_cd": "243070",
+ "isin_name": "휴온스",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "5",
+ "sht_cd": "243070",
+ "isin_name": "휴온스",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "6",
+ "sht_cd": "086520",
+ "isin_name": "에코프로",
+ "record_date": "20221231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "7",
+ "sht_cd": "084110",
+ "isin_name": "휴온스글로벌",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "8",
+ "sht_cd": "119610",
+ "isin_name": "인터로조",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "9",
+ "sht_cd": "086520",
+ "isin_name": "에코프로",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "10",
+ "sht_cd": "084110",
+ "isin_name": "휴온스글로벌",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "11",
+ "sht_cd": "239610",
+ "isin_name": "에이치엘사이언스",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "12",
+ "sht_cd": "068270",
+ "isin_name": "셀트리온",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "13",
+ "sht_cd": "049950",
+ "isin_name": "미래컴퍼니",
+ "record_date": "20221231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "14",
+ "sht_cd": "068930",
+ "isin_name": "디지털대성",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "15",
+ "sht_cd": "086520",
+ "isin_name": "에코프로",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "16",
+ "sht_cd": "119610",
+ "isin_name": "인터로조",
+ "record_date": "20201231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "17",
+ "sht_cd": "003300",
+ "isin_name": "한일홀딩스",
+ "record_date": "20211231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "18",
+ "sht_cd": "001530",
+ "isin_name": "디아이동일",
+ "record_date": "20231231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "19",
+ "sht_cd": "282880",
+ "isin_name": "코윈테크",
+ "record_date": "20231231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ },
+ {
+ "rank": "20",
+ "sht_cd": "001530",
+ "isin_name": "디아이동일",
+ "record_date": "20221231",
+ "per_sto_divi_amt": "0",
+ "divi_rate": "0.00",
+ "divi_kind": "결산"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/144_v1_국내주식-093_국내주식-시간외잔량-순위.md b/docs/broker/kis/rest/국내주식/순위분석/144_v1_국내주식-093_국내주식-시간외잔량-순위.md
new file mode 100644
index 0000000..27139db
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/144_v1_국내주식-093_국내주식-시간외잔량-순위.md
@@ -0,0 +1,509 @@
+# 국내주식 시간외잔량 순위
+
+- 원본 시트명: 국내주식 시간외잔량 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-093
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01760000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/after-hour-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외잔량 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0176] 시간외잔량 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01760000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20176 ) |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 1: 장전 시간외, 2: 장후 시간외, 3:매도잔량, 4:매수잔량 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0 : 전체 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| ovtm_total_askp_rsqn | 시간외 총 매도호가 잔량 | string | Y | 12 | |
+| ovtm_total_bidp_rsqn | 시간외 총 매수호가 잔량 | string | Y | 12 | |
+| mkob_otcp_vol | 장개시전 시간외종가 거래량 | string | Y | 18 | |
+| mkfa_otcp_vol | 장종료후 시간외종가 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20176",
+"fid_rank_sort_cls_code":"1",
+"fid_div_cls_code":"0",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0"
+"fid_trgt_exls_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "252670",
+ "data_rank": "1",
+ "hts_kor_isnm": "KODEX 200선물인버스2X",
+ "stck_prpr": "2170",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.46",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "451685",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "255220",
+ "data_rank": "2",
+ "hts_kor_isnm": "SG",
+ "stck_prpr": "2565",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-7.23",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "216921",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "001470",
+ "data_rank": "3",
+ "hts_kor_isnm": "삼부토건",
+ "stck_prpr": "2535",
+ "prdy_vrss": "-155",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.76",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "77285",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "253590",
+ "data_rank": "4",
+ "hts_kor_isnm": "네오셈",
+ "stck_prpr": "15850",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.25",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "45191",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "065450",
+ "data_rank": "5",
+ "hts_kor_isnm": "빅텍",
+ "stck_prpr": "5180",
+ "prdy_vrss": "80",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.57",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "39634",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "001780",
+ "data_rank": "6",
+ "hts_kor_isnm": "알루코",
+ "stck_prpr": "3580",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.83",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "36447",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "043100",
+ "data_rank": "7",
+ "hts_kor_isnm": "솔고바이오",
+ "stck_prpr": "524",
+ "prdy_vrss": "-9",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.69",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "33361",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "109610",
+ "data_rank": "8",
+ "hts_kor_isnm": "에스와이",
+ "stck_prpr": "4700",
+ "prdy_vrss": "-145",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.99",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "32283",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "012170",
+ "data_rank": "9",
+ "hts_kor_isnm": "아센디오",
+ "stck_prpr": "1071",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.47",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "27599",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "033170",
+ "data_rank": "10",
+ "hts_kor_isnm": "시그네틱스",
+ "stck_prpr": "1998",
+ "prdy_vrss": "123",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.56",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "22443",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "114800",
+ "data_rank": "11",
+ "hts_kor_isnm": "KODEX 인버스",
+ "stck_prpr": "4265",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.23",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "21052",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "032800",
+ "data_rank": "12",
+ "hts_kor_isnm": "판타지오",
+ "stck_prpr": "398",
+ "prdy_vrss": "67",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "20.24",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "16326",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "317850",
+ "data_rank": "13",
+ "hts_kor_isnm": "대모",
+ "stck_prpr": "9430",
+ "prdy_vrss": "-230",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.38",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "15514",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "357250",
+ "data_rank": "14",
+ "hts_kor_isnm": "미래에셋맵스리츠",
+ "stck_prpr": "3260",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.61",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "12500",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "066790",
+ "data_rank": "15",
+ "hts_kor_isnm": "씨씨에스",
+ "stck_prpr": "5450",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "10989",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "039980",
+ "data_rank": "16",
+ "hts_kor_isnm": "폴라리스AI",
+ "stck_prpr": "2690",
+ "prdy_vrss": "-55",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.00",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "10086",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "162300",
+ "data_rank": "17",
+ "hts_kor_isnm": "신스틸",
+ "stck_prpr": "3795",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.81",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "9970",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "007460",
+ "data_rank": "18",
+ "hts_kor_isnm": "에이프로젠",
+ "stck_prpr": "1079",
+ "prdy_vrss": "7",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.65",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "9859",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "033230",
+ "data_rank": "19",
+ "hts_kor_isnm": "인성정보",
+ "stck_prpr": "4465",
+ "prdy_vrss": "15",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.34",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "9773",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "251340",
+ "data_rank": "20",
+ "hts_kor_isnm": "KODEX 코스닥150선물인버스",
+ "stck_prpr": "3315",
+ "prdy_vrss": "-65",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.92",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "9049",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "232140",
+ "data_rank": "21",
+ "hts_kor_isnm": "와이아이케이",
+ "stck_prpr": "7300",
+ "prdy_vrss": "80",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.11",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "8832",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "219550",
+ "data_rank": "22",
+ "hts_kor_isnm": "디와이디",
+ "stck_prpr": "1014",
+ "prdy_vrss": "-19",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.84",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "8557",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "032680",
+ "data_rank": "23",
+ "hts_kor_isnm": "소프트센",
+ "stck_prpr": "732",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.68",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "8371",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "256840",
+ "data_rank": "24",
+ "hts_kor_isnm": "한국비엔씨",
+ "stck_prpr": "7240",
+ "prdy_vrss": "90",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.26",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "7590",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "112040",
+ "data_rank": "25",
+ "hts_kor_isnm": "위메이드",
+ "stck_prpr": "60800",
+ "prdy_vrss": "4600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.19",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "7258",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "357430",
+ "data_rank": "26",
+ "hts_kor_isnm": "마스턴프리미어리츠",
+ "stck_prpr": "3045",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.33",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "6870",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "264850",
+ "data_rank": "27",
+ "hts_kor_isnm": "이랜시스",
+ "stck_prpr": "7650",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.13",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "6177",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "113810",
+ "data_rank": "28",
+ "hts_kor_isnm": "디젠스",
+ "stck_prpr": "1033",
+ "prdy_vrss": "3",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.29",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "5874",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "001440",
+ "data_rank": "29",
+ "hts_kor_isnm": "대한전선",
+ "stck_prpr": "11080",
+ "prdy_vrss": "980",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.70",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "5792",
+ "mkfa_otcp_vol": "0"
+ },
+ {
+ "stck_shrn_iscd": "418620",
+ "data_rank": "30",
+ "hts_kor_isnm": "이에이트",
+ "stck_prpr": "23000",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "ovtm_total_askp_rsqn": "0",
+ "ovtm_total_bidp_rsqn": "0",
+ "mkob_otcp_vol": "5486",
+ "mkfa_otcp_vol": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/145_국내주식-133_국내주식-공매도-상위종목.md b/docs/broker/kis/rest/국내주식/순위분석/145_국내주식-133_국내주식-공매도-상위종목.md
new file mode 100644
index 0000000..163b8fa
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/145_국내주식-133_국내주식-공매도-상위종목.md
@@ -0,0 +1,631 @@
+# 국내주식 공매도 상위종목
+
+- 원본 시트명: 국내주식 공매도 상위종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-133
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04820000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/short-sale
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+공매도 상위종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0482] 공매도 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04820000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_APLY_RANG_VOL | FID 적용 범위 거래량 | string | Y | 18 | 공백 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20482) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:코스피, 1001:코스닥, 2001:코스피200, 4001: KRX100, 3003: 코스닥150 |
+| FID_PERIOD_DIV_CODE | 조회구분 (일/월) | string | Y | 32 | 조회구분 (일/월) D: 일, M:월 |
+| FID_INPUT_CNT_1 | 조회가간(일수 | string | Y | 12 | '조회가간(일수):
조회구분(D) 0:1일, 1:2일, 2:3일, 3:4일, 4:1주일, 9:2주일, 14:3주일,
조회구분(M) 1:1개월, 2:2개월, 3:3개월' |
+| FID_TRGT_EXLS_CLS_CODE | 대상 제외 구분 코드 | string | Y | 32 | 공백 |
+| FID_TRGT_CLS_CODE | FID 대상 구분 코드 | string | Y | 32 | 공백 |
+| FID_APLY_RANG_PRC_1 | FID 적용 범위 가격1 | string | Y | 18 | 가격 ~ |
+| FID_APLY_RANG_PRC_2 | FID 적용 범위 가격2 | string | Y | 18 | ~ 가격 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| ssts_cntg_qty | 공매도 체결 수량 | string | Y | 12 | |
+| ssts_vol_rlim | 공매도 거래량 비중 | string | Y | 62 | |
+| ssts_tr_pbmn | 공매도 거래 대금 | string | Y | 18 | |
+| ssts_tr_pbmn_rlim | 공매도 거래대금 비중 | string | Y | 62 | |
+| stnd_date1 | 기준 일자1 | string | Y | 8 | |
+| stnd_date2 | 기준 일자2 | string | Y | 8 | |
+| avrg_prc | 평균가격 | string | Y | 11 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_cond_scr_div_code:20482
+fid_input_iscd:0000
+fid_period_div_code:D
+fid_input_cnt_1:000000000000
+fid_trgt_exls_cls_code:0
+fid_trgt_cls_code:0
+fid_aply_rang_prc_1:
+fid_aply_rang_prc_2:
+fid_aply_rang_vol:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "138930",
+ "hts_kor_isnm": "BNK금융지주",
+ "stck_prpr": "7760",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.13",
+ "acml_vol": "874160",
+ "acml_tr_pbmn": "6842692780",
+ "ssts_cntg_qty": "64031",
+ "ssts_vol_rlim": "7.32",
+ "ssts_tr_pbmn": "499643430",
+ "ssts_tr_pbmn_rlim": "7.30",
+ "stnd_date1": "20240329",
+ "stnd_date2": "20240329",
+ "avrg_prc": "7803"
+ },
+ {
+ "mksc_shrn_iscd": "024110",
+ "hts_kor_isnm": "기업은행",
+ "stck_prpr": "13230",
+ "prdy_vrss": "-270",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.00",
+ "acml_vol": "2940414",
+ "acml_tr_pbmn": "39892800710",
+ "ssts_cntg_qty": "42457",
+ "ssts_vol_rlim": "1.44",
+ "ssts_tr_pbmn": "573293240",
+ "ssts_tr_pbmn_rlim": "1.44",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "13502"
+ },
+ {
+ "mksc_shrn_iscd": "067310",
+ "hts_kor_isnm": "하나마이크론",
+ "stck_prpr": "29300",
+ "prdy_vrss": "650",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.27",
+ "acml_vol": "7785025",
+ "acml_tr_pbmn": "219228491967",
+ "ssts_cntg_qty": "41626",
+ "ssts_vol_rlim": "0.53",
+ "ssts_tr_pbmn": "1195641050",
+ "ssts_tr_pbmn_rlim": "0.55",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "28723"
+ },
+ {
+ "mksc_shrn_iscd": "139130",
+ "hts_kor_isnm": "DGB금융지주",
+ "stck_prpr": "8480",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.82",
+ "acml_vol": "646804",
+ "acml_tr_pbmn": "5579590090",
+ "ssts_cntg_qty": "41615",
+ "ssts_vol_rlim": "6.43",
+ "ssts_tr_pbmn": "357709910",
+ "ssts_tr_pbmn_rlim": "6.41",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "8595"
+ },
+ {
+ "mksc_shrn_iscd": "316140",
+ "hts_kor_isnm": "우리금융지주",
+ "stck_prpr": "14050",
+ "prdy_vrss": "-270",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.89",
+ "acml_vol": "2158189",
+ "acml_tr_pbmn": "30895435840",
+ "ssts_cntg_qty": "39928",
+ "ssts_vol_rlim": "1.85",
+ "ssts_tr_pbmn": "570341910",
+ "ssts_tr_pbmn_rlim": "1.85",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "14284"
+ },
+ {
+ "mksc_shrn_iscd": "005930",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "82800",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.49",
+ "acml_vol": "27126366",
+ "acml_tr_pbmn": "2224901311700",
+ "ssts_cntg_qty": "39325",
+ "ssts_vol_rlim": "0.14",
+ "ssts_tr_pbmn": "3236734600",
+ "ssts_tr_pbmn_rlim": "0.15",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "82307"
+ },
+ {
+ "mksc_shrn_iscd": "00680K",
+ "hts_kor_isnm": "미래에셋증권2우B",
+ "stck_prpr": "3590",
+ "prdy_vrss": "-85",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.31",
+ "acml_vol": "521897",
+ "acml_tr_pbmn": "1920418685",
+ "ssts_cntg_qty": "27624",
+ "ssts_vol_rlim": "5.29",
+ "ssts_tr_pbmn": "101602075",
+ "ssts_tr_pbmn_rlim": "5.29",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "3678"
+ },
+ {
+ "mksc_shrn_iscd": "088350",
+ "hts_kor_isnm": "한화생명",
+ "stck_prpr": "2835",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "2781608",
+ "acml_tr_pbmn": "7916471305",
+ "ssts_cntg_qty": "25456",
+ "ssts_vol_rlim": "0.92",
+ "ssts_tr_pbmn": "72204695",
+ "ssts_tr_pbmn_rlim": "0.91",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "2836"
+ },
+ {
+ "mksc_shrn_iscd": "005940",
+ "hts_kor_isnm": "NH투자증권",
+ "stck_prpr": "11350",
+ "prdy_vrss": "-350",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.99",
+ "acml_vol": "750616",
+ "acml_tr_pbmn": "8827218780",
+ "ssts_cntg_qty": "24915",
+ "ssts_vol_rlim": "3.32",
+ "ssts_tr_pbmn": "292457920",
+ "ssts_tr_pbmn_rlim": "3.31",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "11738"
+ },
+ {
+ "mksc_shrn_iscd": "032640",
+ "hts_kor_isnm": "LG유플러스",
+ "stck_prpr": "9990",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.20",
+ "acml_vol": "796940",
+ "acml_tr_pbmn": "7972130660",
+ "ssts_cntg_qty": "23173",
+ "ssts_vol_rlim": "2.91",
+ "ssts_tr_pbmn": "231604320",
+ "ssts_tr_pbmn_rlim": "2.91",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "9994"
+ },
+ {
+ "mksc_shrn_iscd": "007660",
+ "hts_kor_isnm": "이수페타시스",
+ "stck_prpr": "41950",
+ "prdy_vrss": "-350",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.83",
+ "acml_vol": "5735235",
+ "acml_tr_pbmn": "247424365700",
+ "ssts_cntg_qty": "20252",
+ "ssts_vol_rlim": "0.35",
+ "ssts_tr_pbmn": "861494300",
+ "ssts_tr_pbmn_rlim": "0.35",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "42538"
+ },
+ {
+ "mksc_shrn_iscd": "175330",
+ "hts_kor_isnm": "JB금융지주",
+ "stck_prpr": "12680",
+ "prdy_vrss": "-520",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.94",
+ "acml_vol": "275866",
+ "acml_tr_pbmn": "3642365310",
+ "ssts_cntg_qty": "19076",
+ "ssts_vol_rlim": "6.91",
+ "ssts_tr_pbmn": "251554220",
+ "ssts_tr_pbmn_rlim": "6.91",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "13186"
+ },
+ {
+ "mksc_shrn_iscd": "353200",
+ "hts_kor_isnm": "대덕전자",
+ "stck_prpr": "26850",
+ "prdy_vrss": "2300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.37",
+ "acml_vol": "959488",
+ "acml_tr_pbmn": "23364959800",
+ "ssts_cntg_qty": "18988",
+ "ssts_vol_rlim": "1.98",
+ "ssts_tr_pbmn": "465048200",
+ "ssts_tr_pbmn_rlim": "1.99",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "24491"
+ },
+ {
+ "mksc_shrn_iscd": "403870",
+ "hts_kor_isnm": "HPSP",
+ "stck_prpr": "52000",
+ "prdy_vrss": "-1100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.07",
+ "acml_vol": "1821358",
+ "acml_tr_pbmn": "96690901900",
+ "ssts_cntg_qty": "14408",
+ "ssts_vol_rlim": "0.79",
+ "ssts_tr_pbmn": "764718100",
+ "ssts_tr_pbmn_rlim": "0.79",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "53075"
+ },
+ {
+ "mksc_shrn_iscd": "003540",
+ "hts_kor_isnm": "대신증권",
+ "stck_prpr": "15540",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.64",
+ "acml_vol": "106254",
+ "acml_tr_pbmn": "1670379320",
+ "ssts_cntg_qty": "13935",
+ "ssts_vol_rlim": "13.11",
+ "ssts_tr_pbmn": "218404520",
+ "ssts_tr_pbmn_rlim": "13.08",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "15673"
+ },
+ {
+ "mksc_shrn_iscd": "000660",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "185900",
+ "prdy_vrss": "2900",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.58",
+ "acml_vol": "3035080",
+ "acml_tr_pbmn": "550258980100",
+ "ssts_cntg_qty": "13524",
+ "ssts_vol_rlim": "0.45",
+ "ssts_tr_pbmn": "2459992400",
+ "ssts_tr_pbmn_rlim": "0.45",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "181898"
+ },
+ {
+ "mksc_shrn_iscd": "095340",
+ "hts_kor_isnm": "ISC",
+ "stck_prpr": "95500",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.55",
+ "acml_vol": "387100",
+ "acml_tr_pbmn": "37858878700",
+ "ssts_cntg_qty": "11023",
+ "ssts_vol_rlim": "2.85",
+ "ssts_tr_pbmn": "1080996600",
+ "ssts_tr_pbmn_rlim": "2.86",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "98067"
+ },
+ {
+ "mksc_shrn_iscd": "005935",
+ "hts_kor_isnm": "삼성전자우",
+ "stck_prpr": "68000",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "1792197",
+ "acml_tr_pbmn": "121695607500",
+ "ssts_cntg_qty": "10863",
+ "ssts_vol_rlim": "0.61",
+ "ssts_tr_pbmn": "739454700",
+ "ssts_tr_pbmn_rlim": "0.61",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "68070"
+ },
+ {
+ "mksc_shrn_iscd": "036540",
+ "hts_kor_isnm": "SFA반도체",
+ "stck_prpr": "6100",
+ "prdy_vrss": "70",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.16",
+ "acml_vol": "2015142",
+ "acml_tr_pbmn": "12201512130",
+ "ssts_cntg_qty": "10781",
+ "ssts_vol_rlim": "0.53",
+ "ssts_tr_pbmn": "65141390",
+ "ssts_tr_pbmn_rlim": "0.53",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "6042"
+ },
+ {
+ "mksc_shrn_iscd": "029780",
+ "hts_kor_isnm": "삼성카드",
+ "stck_prpr": "37200",
+ "prdy_vrss": "-650",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.72",
+ "acml_vol": "124920",
+ "acml_tr_pbmn": "4724311400",
+ "ssts_cntg_qty": "10618",
+ "ssts_vol_rlim": "8.50",
+ "ssts_tr_pbmn": "400737650",
+ "ssts_tr_pbmn_rlim": "8.48",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "37741"
+ },
+ {
+ "mksc_shrn_iscd": "003690",
+ "hts_kor_isnm": "코리안리",
+ "stck_prpr": "8350",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.60",
+ "acml_vol": "511433",
+ "acml_tr_pbmn": "4226681430",
+ "ssts_cntg_qty": "10065",
+ "ssts_vol_rlim": "1.97",
+ "ssts_tr_pbmn": "83410590",
+ "ssts_tr_pbmn_rlim": "1.97",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "8287"
+ },
+ {
+ "mksc_shrn_iscd": "030000",
+ "hts_kor_isnm": "제일기획",
+ "stck_prpr": "19110",
+ "prdy_vrss": "330",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.76",
+ "acml_vol": "216890",
+ "acml_tr_pbmn": "4081885780",
+ "ssts_cntg_qty": "10014",
+ "ssts_vol_rlim": "4.62",
+ "ssts_tr_pbmn": "188337710",
+ "ssts_tr_pbmn_rlim": "4.61",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "18807"
+ },
+ {
+ "mksc_shrn_iscd": "090350",
+ "hts_kor_isnm": "노루페인트",
+ "stck_prpr": "9960",
+ "prdy_vrss": "270",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.79",
+ "acml_vol": "168269",
+ "acml_tr_pbmn": "1640849400",
+ "ssts_cntg_qty": "9186",
+ "ssts_vol_rlim": "5.46",
+ "ssts_tr_pbmn": "89164490",
+ "ssts_tr_pbmn_rlim": "5.43",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "9706"
+ },
+ {
+ "mksc_shrn_iscd": "086790",
+ "hts_kor_isnm": "하나금융지주",
+ "stck_prpr": "56600",
+ "prdy_vrss": "-1100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.91",
+ "acml_vol": "740105",
+ "acml_tr_pbmn": "43037308100",
+ "ssts_cntg_qty": "8114",
+ "ssts_vol_rlim": "1.10",
+ "ssts_tr_pbmn": "471499600",
+ "ssts_tr_pbmn_rlim": "1.10",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "58109"
+ },
+ {
+ "mksc_shrn_iscd": "042700",
+ "hts_kor_isnm": "한미반도체",
+ "stck_prpr": "140400",
+ "prdy_vrss": "6700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.01",
+ "acml_vol": "4188468",
+ "acml_tr_pbmn": "562948611100",
+ "ssts_cntg_qty": "7927",
+ "ssts_vol_rlim": "0.19",
+ "ssts_tr_pbmn": "1061391800",
+ "ssts_tr_pbmn_rlim": "0.19",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "133895"
+ },
+ {
+ "mksc_shrn_iscd": "055550",
+ "hts_kor_isnm": "신한지주",
+ "stck_prpr": "45500",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.09",
+ "acml_vol": "1377596",
+ "acml_tr_pbmn": "63828246950",
+ "ssts_cntg_qty": "7790",
+ "ssts_vol_rlim": "0.57",
+ "ssts_tr_pbmn": "360468750",
+ "ssts_tr_pbmn_rlim": "0.56",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "46273"
+ },
+ {
+ "mksc_shrn_iscd": "044450",
+ "hts_kor_isnm": "KSS해운",
+ "stck_prpr": "8220",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.24",
+ "acml_vol": "42700",
+ "acml_tr_pbmn": "353638500",
+ "ssts_cntg_qty": "7617",
+ "ssts_vol_rlim": "17.84",
+ "ssts_tr_pbmn": "62980890",
+ "ssts_tr_pbmn_rlim": "17.81",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "8268"
+ },
+ {
+ "mksc_shrn_iscd": "300720",
+ "hts_kor_isnm": "한일시멘트",
+ "stck_prpr": "12180",
+ "prdy_vrss": "-120",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.98",
+ "acml_vol": "28707",
+ "acml_tr_pbmn": "354558700",
+ "ssts_cntg_qty": "7547",
+ "ssts_vol_rlim": "26.29",
+ "ssts_tr_pbmn": "93090530",
+ "ssts_tr_pbmn_rlim": "26.26",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "12334"
+ },
+ {
+ "mksc_shrn_iscd": "105560",
+ "hts_kor_isnm": "KB금융",
+ "stck_prpr": "68800",
+ "prdy_vrss": "-700",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.01",
+ "acml_vol": "1004163",
+ "acml_tr_pbmn": "70541592600",
+ "ssts_cntg_qty": "7255",
+ "ssts_vol_rlim": "0.72",
+ "ssts_tr_pbmn": "508167300",
+ "ssts_tr_pbmn_rlim": "0.72",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "70043"
+ },
+ {
+ "mksc_shrn_iscd": "017670",
+ "hts_kor_isnm": "SK텔레콤",
+ "stck_prpr": "52000",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.95",
+ "acml_vol": "382896",
+ "acml_tr_pbmn": "20200687400",
+ "ssts_cntg_qty": "6834",
+ "ssts_vol_rlim": "1.78",
+ "ssts_tr_pbmn": "359735100",
+ "ssts_tr_pbmn_rlim": "1.78",
+ "stnd_date1": "0",
+ "stnd_date2": "0",
+ "avrg_prc": "52639"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/146_v1_국내주식-095_국내주식-이격도-순위.md b/docs/broker/kis/rest/국내주식/순위분석/146_v1_국내주식-095_국내주식-이격도-순위.md
new file mode 100644
index 0000000..c403a66
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/146_v1_국내주식-095_국내주식-이격도-순위.md
@@ -0,0 +1,573 @@
+# 국내주식 이격도 순위
+
+- 원본 시트명: 국내주식 이격도 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-095
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01780000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/disparity
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 이격도 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0178] 이격도 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01780000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20178 ) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보톧주, 7:우선주 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0: 이격도상위순, 1:이격도하위순 |
+| fid_hour_cls_code | 시간 구분 코드 | string | Y | 5 | 5:이격도5, 10:이격도10, 20:이격도20, 60:이격도60, 120:이격도120 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| d5_dsrt | 5일 이격도 | string | Y | 112 | |
+| d10_dsrt | 10일 이격도 | string | Y | 112 | |
+| d20_dsrt | 20일 이격도 | string | Y | 112 | |
+| d60_dsrt | 60일 이격도 | string | Y | 112 | |
+| d120_dsrt | 120일 이격도 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20178",
+"fid_div_cls_code":"0",
+"fid_rank_sort_cls_code":"0",
+"fid_hour_cls_code":"0000",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "199800",
+ "data_rank": "1",
+ "hts_kor_isnm": "툴젠",
+ "stck_prpr": "76100",
+ "prdy_vrss": "17500",
+ "prdy_ctrt": "29.86",
+ "prdy_vrss_sign": "1",
+ "acml_vol": "333421",
+ "d5_dsrt": "126.92",
+ "d10_dsrt": "137.66",
+ "d20_dsrt": "143.04",
+ "d60_dsrt": "134.37",
+ "d120_dsrt": "146.59"
+ },
+ {
+ "mksc_shrn_iscd": "032800",
+ "data_rank": "2",
+ "hts_kor_isnm": "판타지오",
+ "stck_prpr": "394",
+ "prdy_vrss": "63",
+ "prdy_ctrt": "19.03",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "42856944",
+ "d5_dsrt": "125.32",
+ "d10_dsrt": "154.75",
+ "d20_dsrt": "181.27",
+ "d60_dsrt": "183.38",
+ "d120_dsrt": "169.90"
+ },
+ {
+ "mksc_shrn_iscd": "083790",
+ "data_rank": "3",
+ "hts_kor_isnm": "CG인바이츠",
+ "stck_prpr": "4235",
+ "prdy_vrss": "855",
+ "prdy_ctrt": "25.30",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "3067053",
+ "d5_dsrt": "123.18",
+ "d10_dsrt": "121.02",
+ "d20_dsrt": "118.13",
+ "d60_dsrt": "138.02",
+ "d120_dsrt": "145.73"
+ },
+ {
+ "mksc_shrn_iscd": "237690",
+ "data_rank": "4",
+ "hts_kor_isnm": "에스티팜",
+ "stck_prpr": "96400",
+ "prdy_vrss": "18800",
+ "prdy_ctrt": "24.23",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "1694242",
+ "d5_dsrt": "121.72",
+ "d10_dsrt": "127.83",
+ "d20_dsrt": "138.42",
+ "d60_dsrt": "147.80",
+ "d120_dsrt": "142.70"
+ },
+ {
+ "mksc_shrn_iscd": "010660",
+ "data_rank": "5",
+ "hts_kor_isnm": "화천기계",
+ "stck_prpr": "7250",
+ "prdy_vrss": "990",
+ "prdy_ctrt": "15.81",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "10506735",
+ "d5_dsrt": "120.59",
+ "d10_dsrt": "135.12",
+ "d20_dsrt": "149.55",
+ "d60_dsrt": "179.64",
+ "d120_dsrt": "175.87"
+ },
+ {
+ "mksc_shrn_iscd": "103590",
+ "data_rank": "6",
+ "hts_kor_isnm": "일진전기",
+ "stck_prpr": "17370",
+ "prdy_vrss": "2690",
+ "prdy_ctrt": "18.32",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "10956331",
+ "d5_dsrt": "119.93",
+ "d10_dsrt": "128.02",
+ "d20_dsrt": "142.95",
+ "d60_dsrt": "149.68",
+ "d120_dsrt": "144.38"
+ },
+ {
+ "mksc_shrn_iscd": "276730",
+ "data_rank": "7",
+ "hts_kor_isnm": "제주맥주",
+ "stck_prpr": "1492",
+ "prdy_vrss": "148",
+ "prdy_ctrt": "11.01",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "3304408",
+ "d5_dsrt": "116.44",
+ "d10_dsrt": "127.45",
+ "d20_dsrt": "137.72",
+ "d60_dsrt": "150.64",
+ "d120_dsrt": "147.72"
+ },
+ {
+ "mksc_shrn_iscd": "189330",
+ "data_rank": "8",
+ "hts_kor_isnm": "씨이랩",
+ "stck_prpr": "17130",
+ "prdy_vrss": "-70",
+ "prdy_ctrt": "-0.41",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "552497",
+ "d5_dsrt": "116.28",
+ "d10_dsrt": "131.23",
+ "d20_dsrt": "137.29",
+ "d60_dsrt": "145.68",
+ "d120_dsrt": "143.29"
+ },
+ {
+ "mksc_shrn_iscd": "255220",
+ "data_rank": "9",
+ "hts_kor_isnm": "SG",
+ "stck_prpr": "2550",
+ "prdy_vrss": "-215",
+ "prdy_ctrt": "-7.78",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "16959683",
+ "d5_dsrt": "116.25",
+ "d10_dsrt": "128.68",
+ "d20_dsrt": "143.81",
+ "d60_dsrt": "155.60",
+ "d120_dsrt": "176.12"
+ },
+ {
+ "mksc_shrn_iscd": "101000",
+ "data_rank": "10",
+ "hts_kor_isnm": "상상인인더스트리",
+ "stck_prpr": "3510",
+ "prdy_vrss": "55",
+ "prdy_ctrt": "1.59",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "679073",
+ "d5_dsrt": "115.96",
+ "d10_dsrt": "134.74",
+ "d20_dsrt": "149.26",
+ "d60_dsrt": "154.00",
+ "d120_dsrt": "159.79"
+ },
+ {
+ "mksc_shrn_iscd": "060230",
+ "data_rank": "11",
+ "hts_kor_isnm": "소니드",
+ "stck_prpr": "2570",
+ "prdy_vrss": "475",
+ "prdy_ctrt": "22.67",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "3807050",
+ "d5_dsrt": "115.71",
+ "d10_dsrt": "115.45",
+ "d20_dsrt": "105.64",
+ "d60_dsrt": "121.17",
+ "d120_dsrt": "110.82"
+ },
+ {
+ "mksc_shrn_iscd": "073570",
+ "data_rank": "12",
+ "hts_kor_isnm": "리튬포어스",
+ "stck_prpr": "6870",
+ "prdy_vrss": "1470",
+ "prdy_ctrt": "27.22",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "5384918",
+ "d5_dsrt": "115.58",
+ "d10_dsrt": "112.84",
+ "d20_dsrt": "118.04",
+ "d60_dsrt": "113.48",
+ "d120_dsrt": "93.27"
+ },
+ {
+ "mksc_shrn_iscd": "036220",
+ "data_rank": "13",
+ "hts_kor_isnm": "오상헬스케어",
+ "stck_prpr": "25300",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "0.40",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "175169",
+ "d5_dsrt": "115.47",
+ "d10_dsrt": "202.87",
+ "d20_dsrt": "287.60",
+ "d60_dsrt": "385.34",
+ "d120_dsrt": "327.55"
+ },
+ {
+ "mksc_shrn_iscd": "321370",
+ "data_rank": "14",
+ "hts_kor_isnm": "센서뷰",
+ "stck_prpr": "4890",
+ "prdy_vrss": "790",
+ "prdy_ctrt": "19.27",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "5626573",
+ "d5_dsrt": "114.73",
+ "d10_dsrt": "117.60",
+ "d20_dsrt": "112.33",
+ "d60_dsrt": "102.91",
+ "d120_dsrt": "108.28"
+ },
+ {
+ "mksc_shrn_iscd": "030350",
+ "data_rank": "15",
+ "hts_kor_isnm": "드래곤플라이",
+ "stck_prpr": "614",
+ "prdy_vrss": "-7",
+ "prdy_ctrt": "-1.13",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "13499054",
+ "d5_dsrt": "114.72",
+ "d10_dsrt": "119.64",
+ "d20_dsrt": "116.56",
+ "d60_dsrt": "103.46",
+ "d120_dsrt": "105.08"
+ },
+ {
+ "mksc_shrn_iscd": "066910",
+ "data_rank": "16",
+ "hts_kor_isnm": "손오공",
+ "stck_prpr": "3800",
+ "prdy_vrss": "470",
+ "prdy_ctrt": "14.11",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "2211703",
+ "d5_dsrt": "114.25",
+ "d10_dsrt": "125.60",
+ "d20_dsrt": "132.42",
+ "d60_dsrt": "132.81",
+ "d120_dsrt": "148.85"
+ },
+ {
+ "mksc_shrn_iscd": "115530",
+ "data_rank": "17",
+ "hts_kor_isnm": "씨엔플러스",
+ "stck_prpr": "340",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-1.45",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "9226496",
+ "d5_dsrt": "114.17",
+ "d10_dsrt": "117.16",
+ "d20_dsrt": "110.16",
+ "d60_dsrt": "103.26",
+ "d120_dsrt": "92.59"
+ },
+ {
+ "mksc_shrn_iscd": "219130",
+ "data_rank": "18",
+ "hts_kor_isnm": "타이거일렉",
+ "stck_prpr": "38550",
+ "prdy_vrss": "5550",
+ "prdy_ctrt": "16.82",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "306979",
+ "d5_dsrt": "112.98",
+ "d10_dsrt": "115.90",
+ "d20_dsrt": "119.17",
+ "d60_dsrt": "147.68",
+ "d120_dsrt": "168.89"
+ },
+ {
+ "mksc_shrn_iscd": "053030",
+ "data_rank": "19",
+ "hts_kor_isnm": "바이넥스",
+ "stck_prpr": "18190",
+ "prdy_vrss": "1730",
+ "prdy_ctrt": "10.51",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "6841463",
+ "d5_dsrt": "112.84",
+ "d10_dsrt": "128.02",
+ "d20_dsrt": "143.73",
+ "d60_dsrt": "174.00",
+ "d120_dsrt": "198.06"
+ },
+ {
+ "mksc_shrn_iscd": "008600",
+ "data_rank": "20",
+ "hts_kor_isnm": "윌비스",
+ "stck_prpr": "575",
+ "prdy_vrss": "45",
+ "prdy_ctrt": "8.49",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "4543051",
+ "d5_dsrt": "112.83",
+ "d10_dsrt": "115.30",
+ "d20_dsrt": "111.54",
+ "d60_dsrt": "97.44",
+ "d120_dsrt": "97.79"
+ },
+ {
+ "mksc_shrn_iscd": "091970",
+ "data_rank": "21",
+ "hts_kor_isnm": "나노캠텍",
+ "stck_prpr": "777",
+ "prdy_vrss": "123",
+ "prdy_ctrt": "18.81",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "1580766",
+ "d5_dsrt": "112.12",
+ "d10_dsrt": "110.95",
+ "d20_dsrt": "103.11",
+ "d60_dsrt": "88.09",
+ "d120_dsrt": "83.87"
+ },
+ {
+ "mksc_shrn_iscd": "000680",
+ "data_rank": "22",
+ "hts_kor_isnm": "LS네트웍스",
+ "stck_prpr": "5350",
+ "prdy_vrss": "-290",
+ "prdy_ctrt": "-5.14",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "7951524",
+ "d5_dsrt": "112.04",
+ "d10_dsrt": "121.22",
+ "d20_dsrt": "123.64",
+ "d60_dsrt": "121.96",
+ "d120_dsrt": "121.76"
+ },
+ {
+ "mksc_shrn_iscd": "010640",
+ "data_rank": "23",
+ "hts_kor_isnm": "진양폴리",
+ "stck_prpr": "6700",
+ "prdy_vrss": "560",
+ "prdy_ctrt": "9.12",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "330657",
+ "d5_dsrt": "111.74",
+ "d10_dsrt": "116.85",
+ "d20_dsrt": "119.33",
+ "d60_dsrt": "113.49",
+ "d120_dsrt": "104.66"
+ },
+ {
+ "mksc_shrn_iscd": "000150",
+ "data_rank": "24",
+ "hts_kor_isnm": "두산",
+ "stck_prpr": "150400",
+ "prdy_vrss": "5400",
+ "prdy_ctrt": "3.72",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "205583",
+ "d5_dsrt": "111.71",
+ "d10_dsrt": "126.98",
+ "d20_dsrt": "140.65",
+ "d60_dsrt": "158.32",
+ "d120_dsrt": "164.12"
+ },
+ {
+ "mksc_shrn_iscd": "119860",
+ "data_rank": "25",
+ "hts_kor_isnm": "커넥트웨이브",
+ "stck_prpr": "15270",
+ "prdy_vrss": "10",
+ "prdy_ctrt": "0.07",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "196410",
+ "d5_dsrt": "111.46",
+ "d10_dsrt": "113.09",
+ "d20_dsrt": "110.40",
+ "d60_dsrt": "106.56",
+ "d120_dsrt": "120.72"
+ },
+ {
+ "mksc_shrn_iscd": "105740",
+ "data_rank": "26",
+ "hts_kor_isnm": "디케이락",
+ "stck_prpr": "9420",
+ "prdy_vrss": "1070",
+ "prdy_ctrt": "12.81",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "3498003",
+ "d5_dsrt": "111.40",
+ "d10_dsrt": "115.50",
+ "d20_dsrt": "115.86",
+ "d60_dsrt": "111.85",
+ "d120_dsrt": "106.17"
+ },
+ {
+ "mksc_shrn_iscd": "219550",
+ "data_rank": "27",
+ "hts_kor_isnm": "디와이디",
+ "stck_prpr": "1010",
+ "prdy_vrss": "-23",
+ "prdy_ctrt": "-2.23",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "1923238",
+ "d5_dsrt": "111.14",
+ "d10_dsrt": "118.50",
+ "d20_dsrt": "128.36",
+ "d60_dsrt": "126.66",
+ "d120_dsrt": "113.85"
+ },
+ {
+ "mksc_shrn_iscd": "001040",
+ "data_rank": "28",
+ "hts_kor_isnm": "CJ",
+ "stck_prpr": "111100",
+ "prdy_vrss": "1900",
+ "prdy_ctrt": "1.74",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "234342",
+ "d5_dsrt": "111.06",
+ "d10_dsrt": "113.97",
+ "d20_dsrt": "113.04",
+ "d60_dsrt": "115.40",
+ "d120_dsrt": "120.89"
+ },
+ {
+ "mksc_shrn_iscd": "110020",
+ "data_rank": "29",
+ "hts_kor_isnm": "전진바이오팜",
+ "stck_prpr": "8690",
+ "prdy_vrss": "680",
+ "prdy_ctrt": "8.49",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "173087",
+ "d5_dsrt": "110.79",
+ "d10_dsrt": "111.85",
+ "d20_dsrt": "110.95",
+ "d60_dsrt": "103.49",
+ "d120_dsrt": "109.97"
+ },
+ {
+ "mksc_shrn_iscd": "001440",
+ "data_rank": "30",
+ "hts_kor_isnm": "대한전선",
+ "stck_prpr": "10990",
+ "prdy_vrss": "890",
+ "prdy_ctrt": "8.81",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "6305591",
+ "d5_dsrt": "110.76",
+ "d10_dsrt": "115.88",
+ "d20_dsrt": "116.62",
+ "d60_dsrt": "118.40",
+ "d120_dsrt": "109.38"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/147_국내주식-214_HTS조회상위20종목.md b/docs/broker/kis/rest/국내주식/순위분석/147_국내주식-214_HTS조회상위20종목.md
new file mode 100644
index 0000000..c7cc26c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/147_국내주식-214_HTS조회상위20종목.md
@@ -0,0 +1,163 @@
+# HTS조회상위20종목
+
+- 원본 시트명: HTS조회상위20종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-214
+- HTTP Method: GET
+- 실전 TR_ID: HHMCM000100C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/hts-top-view
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+HTS조회상위20종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0158] 조회종목상위 화면의 "종목명", "종목코드" 표시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHMCM000100C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+없음
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| mrkt_div_cls_code | 시장구분 | string | Y | 9 | J : 코스피, Q : 코스닥 |
+| mksc_shrn_iscd | 종목코드 | string | Y | 2 | 종목코드 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+없음
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "005930"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "233740"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "458650"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "042660"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "251340"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "000660"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "196170"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "475560"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "163280"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "001470"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "272210"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "017860"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "475960"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "000100"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "035420"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "460930"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "066970"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "378800"
+ },
+ {
+ "mrkt_div_cls_code": "J",
+ "mksc_shrn_iscd": "373220"
+ },
+ {
+ "mrkt_div_cls_code": "Q",
+ "mksc_shrn_iscd": "255220"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/148_v1_국내주식-047_거래량순위.md b/docs/broker/kis/rest/국내주식/순위분석/148_v1_국내주식-047_거래량순위.md
new file mode 100644
index 0000000..83ab77e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/148_v1_국내주식-047_거래량순위.md
@@ -0,0 +1,761 @@
+# 거래량순위
+
+- 원본 시트명: 거래량순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-047
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01710000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/volume-rank
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 거래량순위 API입니다.
+
+한국투자 HTS(eFriend Plus) > [0171] 거래량 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
++
+30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+HTS [0110]에서 여러가지 조건을 설정할 수 있는데, 그 중 거래량 순위(ex. 0봉전 거래량 상위순 100종목) 에 대해서도 설정해서 종목을 검색할 수 있습니다.
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01710000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | 20171 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000(전체) 기타(업종코드) |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0(전체) 1(보통주) 2(우선주) |
+| FID_BLNG_CLS_CODE | 소속 구분 코드 | string | Y | 2 | 0 : 평균거래량 1:거래증가율 2:평균거래회전율 3:거래금액순 4:평균거래금액회전율 |
+| FID_TRGT_CLS_CODE | 대상 구분 코드 | string | Y | 32 | 1 or 0 9자리 (차례대로 증거금 30% 40% 50% 60% 100% 신용보증금 30% 40% 50% 60%)
ex) "111111111" |
+| FID_TRGT_EXLS_CLS_CODE | 대상 제외 구분 코드 | string | Y | 32 | 1 or 0 10자리 (차례대로 투자위험/경고/주의 관리종목 정리매매 불성실공시 우선주 거래정지 ETF ETN 신용주문불가 SPAC)
ex) "0000000000" |
+| FID_INPUT_PRICE_1 | 입력 가격1 | string | Y | 12 | 가격 ~
ex) "0"
전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 ""(공란) 입력 |
+| FID_INPUT_PRICE_2 | 입력 가격2 | string | Y | 12 | ~ 가격
ex) "1000000"
전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 ""(공란) 입력 |
+| FID_VOL_CNT | 거래량 수 | string | Y | 12 | 거래량 ~
ex) "100000"
전체 거래량 대상 조회 시 FID_VOL_CNT ""(공란) 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output | 응답상세 | object array | Y | | Array |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| lstn_stcn | 상장 주수 | string | Y | 18 | |
+| avrg_vol | 평균 거래량 | string | Y | 18 | |
+| n_befr_clpr_vrss_prpr_rate | N일전종가대비현재가대비율 | string | Y | 82 | |
+| vol_inrt | 거래량증가율 | string | Y | 84 | |
+| vol_tnrt | 거래량 회전율 | string | Y | 82 | |
+| nday_vol_tnrt | N일 거래량 회전율 | string | Y | 8 | |
+| avrg_tr_pbmn | 평균 거래 대금 | string | Y | 18 | |
+| tr_pbmn_tnrt | 거래대금회전율 | string | Y | 82 | |
+| nday_tr_pbmn_tnrt | N일 거래대금 회전율 | string | Y | 8 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"FID_COND_MRKT_DIV_CODE":"J",
+"FID_COND_SCR_DIV_CODE":"20171",
+"FID_INPUT_ISCD":"0000",
+"FID_DIV_CLS_CODE":"0",
+"FID_BLNG_CLS_CODE":"0",
+"FID_TRGT_CLS_CODE":"111111111",
+"FID_TRGT_EXLS_CLS_CODE":"000000",
+"FID_INPUT_PRICE_1":"0",
+"FID_INPUT_PRICE_2":"0",
+"FID_VOL_CNT":"0",
+"FID_INPUT_DATE_1":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "hts_kor_isnm": "삼성전자",
+ "mksc_shrn_iscd": "005930",
+ "data_rank": "1",
+ "stck_prpr": "65100",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-300",
+ "prdy_ctrt": "-0.46",
+ "acml_vol": "8958147",
+ "prdy_vol": "12334657",
+ "lstn_stcn": "5969782550",
+ "avrg_vol": "8958147",
+ "n_befr_clpr_vrss_prpr_rate": "-0.46",
+ "vol_inrt": "72.63",
+ "vol_tnrt": "0.15",
+ "nday_vol_tnrt": "0.15",
+ "avrg_tr_pbmn": "584861890300",
+ "tr_pbmn_tnrt": "0.15",
+ "nday_tr_pbmn_tnrt": "0.15",
+ "acml_tr_pbmn": "584861890300"
+ },
+ {
+ "hts_kor_isnm": "두산에너빌리티",
+ "mksc_shrn_iscd": "034020",
+ "data_rank": "2",
+ "stck_prpr": "15730",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-90",
+ "prdy_ctrt": "-0.57",
+ "acml_vol": "3285533",
+ "prdy_vol": "6090991",
+ "lstn_stcn": "640561146",
+ "avrg_vol": "3285533",
+ "n_befr_clpr_vrss_prpr_rate": "-0.57",
+ "vol_inrt": "53.94",
+ "vol_tnrt": "0.51",
+ "nday_vol_tnrt": "0.51",
+ "avrg_tr_pbmn": "52081429080",
+ "tr_pbmn_tnrt": "0.52",
+ "nday_tr_pbmn_tnrt": "0.52",
+ "acml_tr_pbmn": "52081429080"
+ },
+ {
+ "hts_kor_isnm": "LG디스플레이",
+ "mksc_shrn_iscd": "034220",
+ "data_rank": "3",
+ "stck_prpr": "15670",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "470",
+ "prdy_ctrt": "3.09",
+ "acml_vol": "3171164",
+ "prdy_vol": "1476096",
+ "lstn_stcn": "357815700",
+ "avrg_vol": "3171164",
+ "n_befr_clpr_vrss_prpr_rate": "3.09",
+ "vol_inrt": "214.83",
+ "vol_tnrt": "0.89",
+ "nday_vol_tnrt": "0.89",
+ "avrg_tr_pbmn": "50045759170",
+ "tr_pbmn_tnrt": "0.89",
+ "nday_tr_pbmn_tnrt": "0.89",
+ "acml_tr_pbmn": "50045759170"
+ },
+ {
+ "hts_kor_isnm": "SK하이닉스",
+ "mksc_shrn_iscd": "000660",
+ "data_rank": "4",
+ "stck_prpr": "91700",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1300",
+ "prdy_ctrt": "1.44",
+ "acml_vol": "2833739",
+ "prdy_vol": "5121364",
+ "lstn_stcn": "728002365",
+ "avrg_vol": "2833739",
+ "n_befr_clpr_vrss_prpr_rate": "1.44",
+ "vol_inrt": "55.33",
+ "vol_tnrt": "0.39",
+ "nday_vol_tnrt": "0.39",
+ "avrg_tr_pbmn": "258969317100",
+ "tr_pbmn_tnrt": "0.39",
+ "nday_tr_pbmn_tnrt": "0.39",
+ "acml_tr_pbmn": "258969317100"
+ },
+ {
+ "hts_kor_isnm": "현대로템",
+ "mksc_shrn_iscd": "064350",
+ "data_rank": "5",
+ "stck_prpr": "31450",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-1500",
+ "prdy_ctrt": "-4.55",
+ "acml_vol": "2709946",
+ "prdy_vol": "1161286",
+ "lstn_stcn": "109142293",
+ "avrg_vol": "2709946",
+ "n_befr_clpr_vrss_prpr_rate": "-4.55",
+ "vol_inrt": "233.36",
+ "vol_tnrt": "2.48",
+ "nday_vol_tnrt": "2.48",
+ "avrg_tr_pbmn": "85496575550",
+ "tr_pbmn_tnrt": "2.49",
+ "nday_tr_pbmn_tnrt": "2.49",
+ "acml_tr_pbmn": "85496575550"
+ },
+ {
+ "hts_kor_isnm": "HMM",
+ "mksc_shrn_iscd": "011200",
+ "data_rank": "6",
+ "stck_prpr": "18250",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-550",
+ "prdy_ctrt": "-2.93",
+ "acml_vol": "2286426",
+ "prdy_vol": "1530846",
+ "lstn_stcn": "489039496",
+ "avrg_vol": "2286426",
+ "n_befr_clpr_vrss_prpr_rate": "-2.93",
+ "vol_inrt": "149.36",
+ "vol_tnrt": "0.47",
+ "nday_vol_tnrt": "0.47",
+ "avrg_tr_pbmn": "42083654470",
+ "tr_pbmn_tnrt": "0.47",
+ "nday_tr_pbmn_tnrt": "0.47",
+ "acml_tr_pbmn": "42083654470"
+ },
+ {
+ "hts_kor_isnm": "카카오",
+ "mksc_shrn_iscd": "035720",
+ "data_rank": "7",
+ "stck_prpr": "57700",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1600",
+ "prdy_ctrt": "2.85",
+ "acml_vol": "1873007",
+ "prdy_vol": "922948",
+ "lstn_stcn": "445841128",
+ "avrg_vol": "1873007",
+ "n_befr_clpr_vrss_prpr_rate": "2.85",
+ "vol_inrt": "202.94",
+ "vol_tnrt": "0.42",
+ "nday_vol_tnrt": "0.42",
+ "avrg_tr_pbmn": "107707977500",
+ "tr_pbmn_tnrt": "0.42",
+ "nday_tr_pbmn_tnrt": "0.42",
+ "acml_tr_pbmn": "107707977500"
+ },
+ {
+ "hts_kor_isnm": "삼성중공업",
+ "mksc_shrn_iscd": "010140",
+ "data_rank": "8",
+ "stck_prpr": "5510",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "30",
+ "prdy_ctrt": "0.55",
+ "acml_vol": "1711650",
+ "prdy_vol": "1979941",
+ "lstn_stcn": "880000000",
+ "avrg_vol": "1711650",
+ "n_befr_clpr_vrss_prpr_rate": "0.55",
+ "vol_inrt": "86.45",
+ "vol_tnrt": "0.19",
+ "nday_vol_tnrt": "0.19",
+ "avrg_tr_pbmn": "9363354660",
+ "tr_pbmn_tnrt": "0.19",
+ "nday_tr_pbmn_tnrt": "0.19",
+ "acml_tr_pbmn": "9363354660"
+ },
+ {
+ "hts_kor_isnm": "한화솔루션",
+ "mksc_shrn_iscd": "009830",
+ "data_rank": "9",
+ "stck_prpr": "48000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1150",
+ "prdy_ctrt": "2.45",
+ "acml_vol": "1582296",
+ "prdy_vol": "910120",
+ "lstn_stcn": "171892536",
+ "avrg_vol": "1582296",
+ "n_befr_clpr_vrss_prpr_rate": "2.45",
+ "vol_inrt": "173.86",
+ "vol_tnrt": "0.92",
+ "nday_vol_tnrt": "0.92",
+ "avrg_tr_pbmn": "75841144250",
+ "tr_pbmn_tnrt": "0.92",
+ "nday_tr_pbmn_tnrt": "0.92",
+ "acml_tr_pbmn": "75841144250"
+ },
+ {
+ "hts_kor_isnm": "포스코인터내셔널",
+ "mksc_shrn_iscd": "047050",
+ "data_rank": "10",
+ "stck_prpr": "28550",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "200",
+ "prdy_ctrt": "0.71",
+ "acml_vol": "1390133",
+ "prdy_vol": "2369179",
+ "lstn_stcn": "175922788",
+ "avrg_vol": "1390133",
+ "n_befr_clpr_vrss_prpr_rate": "0.71",
+ "vol_inrt": "58.68",
+ "vol_tnrt": "0.79",
+ "nday_vol_tnrt": "0.79",
+ "avrg_tr_pbmn": "39675793900",
+ "tr_pbmn_tnrt": "0.79",
+ "nday_tr_pbmn_tnrt": "0.79",
+ "acml_tr_pbmn": "39675793900"
+ },
+ {
+ "hts_kor_isnm": "한국전력",
+ "mksc_shrn_iscd": "015760",
+ "data_rank": "11",
+ "stck_prpr": "18450",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-230",
+ "prdy_ctrt": "-1.23",
+ "acml_vol": "1312142",
+ "prdy_vol": "1844472",
+ "lstn_stcn": "641964077",
+ "avrg_vol": "1312142",
+ "n_befr_clpr_vrss_prpr_rate": "-1.23",
+ "vol_inrt": "71.14",
+ "vol_tnrt": "0.20",
+ "nday_vol_tnrt": "0.20",
+ "avrg_tr_pbmn": "24308085110",
+ "tr_pbmn_tnrt": "0.21",
+ "nday_tr_pbmn_tnrt": "0.21",
+ "acml_tr_pbmn": "24308085110"
+ },
+ {
+ "hts_kor_isnm": "우리금융지주",
+ "mksc_shrn_iscd": "316140",
+ "data_rank": "12",
+ "stck_prpr": "11720",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-80",
+ "prdy_ctrt": "-0.68",
+ "acml_vol": "1270105",
+ "prdy_vol": "1455657",
+ "lstn_stcn": "728060549",
+ "avrg_vol": "1270105",
+ "n_befr_clpr_vrss_prpr_rate": "-0.68",
+ "vol_inrt": "87.25",
+ "vol_tnrt": "0.17",
+ "nday_vol_tnrt": "0.17",
+ "avrg_tr_pbmn": "14886199950",
+ "tr_pbmn_tnrt": "0.17",
+ "nday_tr_pbmn_tnrt": "0.17",
+ "acml_tr_pbmn": "14886199950"
+ },
+ {
+ "hts_kor_isnm": "팬오션",
+ "mksc_shrn_iscd": "028670",
+ "data_rank": "13",
+ "stck_prpr": "5100",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "1156091",
+ "prdy_vol": "1296967",
+ "lstn_stcn": "534569512",
+ "avrg_vol": "1156091",
+ "n_befr_clpr_vrss_prpr_rate": "0.00",
+ "vol_inrt": "89.14",
+ "vol_tnrt": "0.22",
+ "nday_vol_tnrt": "0.22",
+ "avrg_tr_pbmn": "5900434210",
+ "tr_pbmn_tnrt": "0.22",
+ "nday_tr_pbmn_tnrt": "0.22",
+ "acml_tr_pbmn": "5900434210"
+ },
+ {
+ "hts_kor_isnm": "기아",
+ "mksc_shrn_iscd": "000270",
+ "data_rank": "14",
+ "stck_prpr": "88000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "700",
+ "prdy_ctrt": "0.80",
+ "acml_vol": "935222",
+ "prdy_vol": "1866373",
+ "lstn_stcn": "405363347",
+ "avrg_vol": "935222",
+ "n_befr_clpr_vrss_prpr_rate": "0.80",
+ "vol_inrt": "50.11",
+ "vol_tnrt": "0.23",
+ "nday_vol_tnrt": "0.23",
+ "avrg_tr_pbmn": "82381989600",
+ "tr_pbmn_tnrt": "0.23",
+ "nday_tr_pbmn_tnrt": "0.23",
+ "acml_tr_pbmn": "82381989600"
+ },
+ {
+ "hts_kor_isnm": "신한지주",
+ "mksc_shrn_iscd": "055550",
+ "data_rank": "15",
+ "stck_prpr": "34600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "50",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "930868",
+ "prdy_vol": "1351786",
+ "lstn_stcn": "505108399",
+ "avrg_vol": "930868",
+ "n_befr_clpr_vrss_prpr_rate": "0.14",
+ "vol_inrt": "68.86",
+ "vol_tnrt": "0.18",
+ "nday_vol_tnrt": "0.18",
+ "avrg_tr_pbmn": "32273778800",
+ "tr_pbmn_tnrt": "0.18",
+ "nday_tr_pbmn_tnrt": "0.18",
+ "acml_tr_pbmn": "32273778800"
+ },
+ {
+ "hts_kor_isnm": "메리츠금융지주",
+ "mksc_shrn_iscd": "138040",
+ "data_rank": "16",
+ "stck_prpr": "45300",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-400",
+ "prdy_ctrt": "-0.88",
+ "acml_vol": "627094",
+ "prdy_vol": "817468",
+ "lstn_stcn": "208217858",
+ "avrg_vol": "627094",
+ "n_befr_clpr_vrss_prpr_rate": "-0.88",
+ "vol_inrt": "76.71",
+ "vol_tnrt": "0.30",
+ "nday_vol_tnrt": "0.30",
+ "avrg_tr_pbmn": "28375338250",
+ "tr_pbmn_tnrt": "0.30",
+ "nday_tr_pbmn_tnrt": "0.30",
+ "acml_tr_pbmn": "28375338250"
+ },
+ {
+ "hts_kor_isnm": "카카오뱅크",
+ "mksc_shrn_iscd": "323410",
+ "data_rank": "17",
+ "stck_prpr": "24850",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-300",
+ "prdy_ctrt": "-1.19",
+ "acml_vol": "625836",
+ "prdy_vol": "1527116",
+ "lstn_stcn": "476767137",
+ "avrg_vol": "625836",
+ "n_befr_clpr_vrss_prpr_rate": "-1.19",
+ "vol_inrt": "40.98",
+ "vol_tnrt": "0.13",
+ "nday_vol_tnrt": "0.13",
+ "avrg_tr_pbmn": "15712615750",
+ "tr_pbmn_tnrt": "0.13",
+ "nday_tr_pbmn_tnrt": "0.13",
+ "acml_tr_pbmn": "15712615750"
+ },
+ {
+ "hts_kor_isnm": "KT",
+ "mksc_shrn_iscd": "030200",
+ "data_rank": "18",
+ "stck_prpr": "31300",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "0.32",
+ "acml_vol": "569371",
+ "prdy_vol": "1294632",
+ "lstn_stcn": "261111808",
+ "avrg_vol": "569371",
+ "n_befr_clpr_vrss_prpr_rate": "0.32",
+ "vol_inrt": "43.98",
+ "vol_tnrt": "0.22",
+ "nday_vol_tnrt": "0.22",
+ "avrg_tr_pbmn": "17771655950",
+ "tr_pbmn_tnrt": "0.22",
+ "nday_tr_pbmn_tnrt": "0.22",
+ "acml_tr_pbmn": "17771655950"
+ },
+ {
+ "hts_kor_isnm": "에스디바이오센서",
+ "mksc_shrn_iscd": "137310",
+ "data_rank": "19",
+ "stck_prpr": "17860",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-540",
+ "prdy_ctrt": "-2.93",
+ "acml_vol": "520565",
+ "prdy_vol": "487837",
+ "lstn_stcn": "104452353",
+ "avrg_vol": "520565",
+ "n_befr_clpr_vrss_prpr_rate": "-2.93",
+ "vol_inrt": "106.71",
+ "vol_tnrt": "0.50",
+ "nday_vol_tnrt": "0.50",
+ "avrg_tr_pbmn": "9342427100",
+ "tr_pbmn_tnrt": "0.50",
+ "nday_tr_pbmn_tnrt": "0.50",
+ "acml_tr_pbmn": "9342427100"
+ },
+ {
+ "hts_kor_isnm": "NAVER",
+ "mksc_shrn_iscd": "035420",
+ "data_rank": "20",
+ "stck_prpr": "213000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5500",
+ "prdy_ctrt": "2.65",
+ "acml_vol": "484026",
+ "prdy_vol": "528940",
+ "lstn_stcn": "164049085",
+ "avrg_vol": "484026",
+ "n_befr_clpr_vrss_prpr_rate": "2.65",
+ "vol_inrt": "91.51",
+ "vol_tnrt": "0.30",
+ "nday_vol_tnrt": "0.30",
+ "avrg_tr_pbmn": "102530676000",
+ "tr_pbmn_tnrt": "0.29",
+ "nday_tr_pbmn_tnrt": "0.29",
+ "acml_tr_pbmn": "102530676000"
+ },
+ {
+ "hts_kor_isnm": "기업은행",
+ "mksc_shrn_iscd": "024110",
+ "data_rank": "21",
+ "stck_prpr": "10070",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-30",
+ "prdy_ctrt": "-0.30",
+ "acml_vol": "469367",
+ "prdy_vol": "707261",
+ "lstn_stcn": "797425869",
+ "avrg_vol": "469367",
+ "n_befr_clpr_vrss_prpr_rate": "-0.30",
+ "vol_inrt": "66.36",
+ "vol_tnrt": "0.06",
+ "nday_vol_tnrt": "0.06",
+ "avrg_tr_pbmn": "4736559470",
+ "tr_pbmn_tnrt": "0.06",
+ "nday_tr_pbmn_tnrt": "0.06",
+ "acml_tr_pbmn": "4736559470"
+ },
+ {
+ "hts_kor_isnm": "포스코퓨처엠",
+ "mksc_shrn_iscd": "003670",
+ "data_rank": "22",
+ "stck_prpr": "312500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "2500",
+ "prdy_ctrt": "0.81",
+ "acml_vol": "468389",
+ "prdy_vol": "856091",
+ "lstn_stcn": "77463220",
+ "avrg_vol": "468389",
+ "n_befr_clpr_vrss_prpr_rate": "0.81",
+ "vol_inrt": "54.71",
+ "vol_tnrt": "0.60",
+ "nday_vol_tnrt": "0.60",
+ "avrg_tr_pbmn": "145466512000",
+ "tr_pbmn_tnrt": "0.60",
+ "nday_tr_pbmn_tnrt": "0.60",
+ "acml_tr_pbmn": "145466512000"
+ },
+ {
+ "hts_kor_isnm": "KB금융",
+ "mksc_shrn_iscd": "105560",
+ "data_rank": "23",
+ "stck_prpr": "49000",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-300",
+ "prdy_ctrt": "-0.61",
+ "acml_vol": "459214",
+ "prdy_vol": "1293549",
+ "lstn_stcn": "403511072",
+ "avrg_vol": "459214",
+ "n_befr_clpr_vrss_prpr_rate": "-0.61",
+ "vol_inrt": "35.50",
+ "vol_tnrt": "0.11",
+ "nday_vol_tnrt": "0.11",
+ "avrg_tr_pbmn": "22593198000",
+ "tr_pbmn_tnrt": "0.11",
+ "nday_tr_pbmn_tnrt": "0.11",
+ "acml_tr_pbmn": "22593198000"
+ },
+ {
+ "hts_kor_isnm": "한화에어로스페이스",
+ "mksc_shrn_iscd": "012450",
+ "data_rank": "24",
+ "stck_prpr": "103900",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "400",
+ "prdy_ctrt": "0.39",
+ "acml_vol": "458706",
+ "prdy_vol": "345873",
+ "lstn_stcn": "50630000",
+ "avrg_vol": "458706",
+ "n_befr_clpr_vrss_prpr_rate": "0.39",
+ "vol_inrt": "132.62",
+ "vol_tnrt": "0.91",
+ "nday_vol_tnrt": "0.91",
+ "avrg_tr_pbmn": "47298434100",
+ "tr_pbmn_tnrt": "0.90",
+ "nday_tr_pbmn_tnrt": "0.90",
+ "acml_tr_pbmn": "47298434100"
+ },
+ {
+ "hts_kor_isnm": "LG유플러스",
+ "mksc_shrn_iscd": "032640",
+ "data_rank": "25",
+ "stck_prpr": "11090",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "60",
+ "prdy_ctrt": "0.54",
+ "acml_vol": "451459",
+ "prdy_vol": "971303",
+ "lstn_stcn": "436611361",
+ "avrg_vol": "451459",
+ "n_befr_clpr_vrss_prpr_rate": "0.54",
+ "vol_inrt": "46.48",
+ "vol_tnrt": "0.10",
+ "nday_vol_tnrt": "0.10",
+ "avrg_tr_pbmn": "5009396470",
+ "tr_pbmn_tnrt": "0.10",
+ "nday_tr_pbmn_tnrt": "0.10",
+ "acml_tr_pbmn": "5009396470"
+ },
+ {
+ "hts_kor_isnm": "삼성엔지니어링",
+ "mksc_shrn_iscd": "028050",
+ "data_rank": "26",
+ "stck_prpr": "28950",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-250",
+ "prdy_ctrt": "-0.86",
+ "acml_vol": "446635",
+ "prdy_vol": "512916",
+ "lstn_stcn": "196000000",
+ "avrg_vol": "446635",
+ "n_befr_clpr_vrss_prpr_rate": "-0.86",
+ "vol_inrt": "87.08",
+ "vol_tnrt": "0.23",
+ "nday_vol_tnrt": "0.23",
+ "avrg_tr_pbmn": "12942967050",
+ "tr_pbmn_tnrt": "0.23",
+ "nday_tr_pbmn_tnrt": "0.23",
+ "acml_tr_pbmn": "12942967050"
+ },
+ {
+ "hts_kor_isnm": "현대차",
+ "mksc_shrn_iscd": "005380",
+ "data_rank": "27",
+ "stck_prpr": "204500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "2000",
+ "prdy_ctrt": "0.99",
+ "acml_vol": "432033",
+ "prdy_vol": "874247",
+ "lstn_stcn": "211531506",
+ "avrg_vol": "432033",
+ "n_befr_clpr_vrss_prpr_rate": "0.99",
+ "vol_inrt": "49.42",
+ "vol_tnrt": "0.20",
+ "nday_vol_tnrt": "0.20",
+ "avrg_tr_pbmn": "88091018500",
+ "tr_pbmn_tnrt": "0.20",
+ "nday_tr_pbmn_tnrt": "0.20",
+ "acml_tr_pbmn": "88091018500"
+ },
+ {
+ "hts_kor_isnm": "한국항공우주",
+ "mksc_shrn_iscd": "047810",
+ "data_rank": "28",
+ "stck_prpr": "51700",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.58",
+ "acml_vol": "418249",
+ "prdy_vol": "431203",
+ "lstn_stcn": "97475107",
+ "avrg_vol": "418249",
+ "n_befr_clpr_vrss_prpr_rate": "0.58",
+ "vol_inrt": "97.00",
+ "vol_tnrt": "0.43",
+ "nday_vol_tnrt": "0.43",
+ "avrg_tr_pbmn": "21574340000",
+ "tr_pbmn_tnrt": "0.43",
+ "nday_tr_pbmn_tnrt": "0.43",
+ "acml_tr_pbmn": "21574340000"
+ },
+ {
+ "hts_kor_isnm": "대한항공",
+ "mksc_shrn_iscd": "003490",
+ "data_rank": "29",
+ "stck_prpr": "22500",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "400822",
+ "prdy_vol": "578620",
+ "lstn_stcn": "368220661",
+ "avrg_vol": "400822",
+ "n_befr_clpr_vrss_prpr_rate": "0.00",
+ "vol_inrt": "69.27",
+ "vol_tnrt": "0.11",
+ "nday_vol_tnrt": "0.11",
+ "avrg_tr_pbmn": "9020223200",
+ "tr_pbmn_tnrt": "0.11",
+ "nday_tr_pbmn_tnrt": "0.11",
+ "acml_tr_pbmn": "9020223200"
+ },
+ {
+ "hts_kor_isnm": "한국가스공사",
+ "mksc_shrn_iscd": "036460",
+ "data_rank": "30",
+ "stck_prpr": "25350",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-500",
+ "prdy_ctrt": "-1.93",
+ "acml_vol": "369094",
+ "prdy_vol": "340512",
+ "lstn_stcn": "92313000",
+ "avrg_vol": "369094",
+ "n_befr_clpr_vrss_prpr_rate": "-1.93",
+ "vol_inrt": "108.39",
+ "vol_tnrt": "0.40",
+ "nday_vol_tnrt": "0.40",
+ "avrg_tr_pbmn": "9408072150",
+ "tr_pbmn_tnrt": "0.40",
+ "nday_tr_pbmn_tnrt": "0.40",
+ "acml_tr_pbmn": "9408072150"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/149_v1_국내주식-090_국내주식-수익자산지표-순위.md b/docs/broker/kis/rest/국내주식/순위분석/149_v1_국내주식-090_국내주식-수익자산지표-순위.md
new file mode 100644
index 0000000..60298c4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/149_v1_국내주식-090_국내주식-수익자산지표-순위.md
@@ -0,0 +1,732 @@
+# 국내주식 수익자산지표 순위
+
+- 원본 시트명: 국내주식 수익자산지표 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-090
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01730000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/profit-asset-index
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 수익자산지표 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0173] 수익자산지표 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01730000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20173 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_input_option_1 | 입력 옵션1 | string | Y | 10 | 회계연도 (2023) |
+| fid_input_option_2 | 입력 옵션2 | string | Y | 10 | 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:매출이익 1:영업이익 2:경상이익 3:당기순이익 4:자산총계 5:부채총계 6:자본총계 |
+| fid_blng_cls_code | 소속 구분 코드 | string | Y | 2 | 0:전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0:전체 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| sale_totl_prfi | 매출 총 이익 | string | Y | 182 | |
+| bsop_prti | 영업 이익 | string | Y | 182 | |
+| op_prfi | 경상 이익 | string | Y | 182 | |
+| thtr_ntin | 당기순이익 | string | Y | 102 | |
+| total_aset | 자산총계 | string | Y | 102 | |
+| total_lblt | 부채총계 | string | Y | 102 | |
+| total_cptl | 자본총계 | string | Y | 102 | |
+| stac_month | 결산 월 | string | Y | 2 | |
+| stac_month_cls_code | 결산 월 구분 코드 | string | Y | 2 | |
+| iqry_csnu | 조회 건수 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20173",
+"fid_input_iscd":"0000",
+"fid_div_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_input_option_1":"2023",
+"fid_input_option_2":"0",
+"fid_rank_sort_cls_code":"0",
+"fid_blng_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_trgt_cls_code":"0",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "data_rank": "1",
+ "hts_kor_isnm": "삼성전자",
+ "mksc_shrn_iscd": "005930",
+ "stck_prpr": "72800",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.69",
+ "acml_vol": "3682788",
+ "sale_totl_prfi": "177383.00",
+ "bsop_prti": "6402.00",
+ "op_prfi": "18264.00",
+ "thtr_ntin": "15746.00",
+ "total_aset": "4540918.00",
+ "total_lblt": "942924.00",
+ "total_cptl": "3597994.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "2",
+ "hts_kor_isnm": "현대차",
+ "mksc_shrn_iscd": "005380",
+ "stck_prpr": "246500",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.23",
+ "acml_vol": "264085",
+ "sale_totl_prfi": "77220.00",
+ "bsop_prti": "35927.00",
+ "op_prfi": "45909.00",
+ "thtr_ntin": "34194.00",
+ "total_aset": "2643636.00",
+ "total_lblt": "1704440.00",
+ "total_cptl": "939195.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "3",
+ "hts_kor_isnm": "KT",
+ "mksc_shrn_iscd": "030200",
+ "stck_prpr": "38100",
+ "prdy_vrss": "-150",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.39",
+ "acml_vol": "98431",
+ "sale_totl_prfi": "64437.00",
+ "bsop_prti": "4861.00",
+ "op_prfi": "4376.00",
+ "thtr_ntin": "3096.00",
+ "total_aset": "402144.00",
+ "total_lblt": "220625.00",
+ "total_cptl": "181520.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "4",
+ "hts_kor_isnm": "기아",
+ "mksc_shrn_iscd": "000270",
+ "stck_prpr": "127400",
+ "prdy_vrss": "2400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.92",
+ "acml_vol": "505419",
+ "sale_totl_prfi": "53734.00",
+ "bsop_prti": "28740.00",
+ "op_prfi": "31421.00",
+ "thtr_ntin": "21198.00",
+ "total_aset": "776127.00",
+ "total_lblt": "375811.00",
+ "total_cptl": "400316.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "5",
+ "hts_kor_isnm": "LG전자",
+ "mksc_shrn_iscd": "066570",
+ "stck_prpr": "97900",
+ "prdy_vrss": "-1000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.01",
+ "acml_vol": "123952",
+ "sale_totl_prfi": "51699.00",
+ "bsop_prti": "14974.00",
+ "op_prfi": "9337.00",
+ "thtr_ntin": "5465.00",
+ "total_aset": "574906.00",
+ "total_lblt": "341309.00",
+ "total_cptl": "233598.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "6",
+ "hts_kor_isnm": "SK텔레콤",
+ "mksc_shrn_iscd": "017670",
+ "stck_prpr": "52900",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.38",
+ "acml_vol": "145002",
+ "sale_totl_prfi": "43722.00",
+ "bsop_prti": "4948.00",
+ "op_prfi": "4209.00",
+ "thtr_ntin": "3025.00",
+ "total_aset": "305397.00",
+ "total_lblt": "182230.00",
+ "total_cptl": "123167.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "7",
+ "hts_kor_isnm": "삼성화재",
+ "mksc_shrn_iscd": "000810",
+ "stck_prpr": "307500",
+ "prdy_vrss": "-2000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.65",
+ "acml_vol": "38892",
+ "sale_totl_prfi": "40846.00",
+ "bsop_prti": "8333.00",
+ "op_prfi": "8593.00",
+ "thtr_ntin": "6133.00",
+ "total_aset": "814661.00",
+ "total_lblt": "682398.00",
+ "total_cptl": "132264.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "8",
+ "hts_kor_isnm": "DB손해보험",
+ "mksc_shrn_iscd": "005830",
+ "stck_prpr": "99700",
+ "prdy_vrss": "-2200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.16",
+ "acml_vol": "60493",
+ "sale_totl_prfi": "35945.00",
+ "bsop_prti": "6782.00",
+ "op_prfi": "6873.00",
+ "thtr_ntin": "5274.00",
+ "total_aset": "550956.00",
+ "total_lblt": "457981.00",
+ "total_cptl": "92975.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "9",
+ "hts_kor_isnm": "LG유플러스",
+ "mksc_shrn_iscd": "032640",
+ "stck_prpr": "9990",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.70",
+ "acml_vol": "242577",
+ "sale_totl_prfi": "35413.00",
+ "bsop_prti": "2602.00",
+ "op_prfi": "2110.00",
+ "thtr_ntin": "1551.00",
+ "total_aset": "200178.00",
+ "total_lblt": "115891.00",
+ "total_cptl": "84287.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "10",
+ "hts_kor_isnm": "현대해상",
+ "mksc_shrn_iscd": "001450",
+ "stck_prpr": "33850",
+ "prdy_vrss": "-650",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.88",
+ "acml_vol": "157602",
+ "sale_totl_prfi": "32220.00",
+ "bsop_prti": "2861.00",
+ "op_prfi": "2769.00",
+ "thtr_ntin": "2136.00",
+ "total_aset": "430393.00",
+ "total_lblt": "364840.00",
+ "total_cptl": "65552.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "11",
+ "hts_kor_isnm": "SK",
+ "mksc_shrn_iscd": "034730",
+ "stck_prpr": "185100",
+ "prdy_vrss": "-2200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.17",
+ "acml_vol": "31227",
+ "sale_totl_prfi": "30209.00",
+ "bsop_prti": "11304.00",
+ "op_prfi": "148.00",
+ "thtr_ntin": "-66.00",
+ "total_aset": "1977927.00",
+ "total_lblt": "1239833.00",
+ "total_cptl": "738094.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "12",
+ "hts_kor_isnm": "흥국화재",
+ "mksc_shrn_iscd": "000540",
+ "stck_prpr": "4500",
+ "prdy_vrss": "-125",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.70",
+ "acml_vol": "92773",
+ "sale_totl_prfi": "29739.00",
+ "bsop_prti": "1860.00",
+ "op_prfi": "1868.00",
+ "thtr_ntin": "1475.00",
+ "total_aset": "139661.00",
+ "total_lblt": "132461.00",
+ "total_cptl": "7200.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "13",
+ "hts_kor_isnm": "KB금융",
+ "mksc_shrn_iscd": "105560",
+ "stck_prpr": "73000",
+ "prdy_vrss": "-3200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.20",
+ "acml_vol": "999009",
+ "sale_totl_prfi": "27856.00",
+ "bsop_prti": "21250.00",
+ "op_prfi": "20289.00",
+ "thtr_ntin": "14992.00",
+ "total_aset": "6914356.00",
+ "total_lblt": "6351955.00",
+ "total_cptl": "562402.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "14",
+ "hts_kor_isnm": "CJ",
+ "mksc_shrn_iscd": "001040",
+ "stck_prpr": "109700",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.46",
+ "acml_vol": "216421",
+ "sale_totl_prfi": "26296.00",
+ "bsop_prti": "3293.00",
+ "op_prfi": "1272.00",
+ "thtr_ntin": "117.00",
+ "total_aset": "489176.00",
+ "total_lblt": "310436.00",
+ "total_cptl": "178740.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "15",
+ "hts_kor_isnm": "신한지주",
+ "mksc_shrn_iscd": "055550",
+ "stck_prpr": "48700",
+ "prdy_vrss": "-900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.81",
+ "acml_vol": "907017",
+ "sale_totl_prfi": "25738.00",
+ "bsop_prti": "17562.00",
+ "op_prfi": "18568.00",
+ "thtr_ntin": "14143.00",
+ "total_aset": "6761756.00",
+ "total_lblt": "6203801.00",
+ "total_cptl": "557955.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "16",
+ "hts_kor_isnm": "삼성생명",
+ "mksc_shrn_iscd": "032830",
+ "stck_prpr": "96000",
+ "prdy_vrss": "-3100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.13",
+ "acml_vol": "233938",
+ "sale_totl_prfi": "23550.00",
+ "bsop_prti": "8818.00",
+ "op_prfi": "9564.00",
+ "thtr_ntin": "7391.00",
+ "total_aset": "2997953.00",
+ "total_lblt": "2599820.00",
+ "total_cptl": "398133.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "17",
+ "hts_kor_isnm": "LG화학",
+ "mksc_shrn_iscd": "051910",
+ "stck_prpr": "439000",
+ "prdy_vrss": "8000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.86",
+ "acml_vol": "66448",
+ "sale_totl_prfi": "23251.00",
+ "bsop_prti": "6907.00",
+ "op_prfi": "9160.00",
+ "thtr_ntin": "6691.00",
+ "total_aset": "708960.00",
+ "total_lblt": "324919.00",
+ "total_cptl": "384041.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "18",
+ "hts_kor_isnm": "롯데손해보험",
+ "mksc_shrn_iscd": "000400",
+ "stck_prpr": "2920",
+ "prdy_vrss": "55",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.92",
+ "acml_vol": "365380",
+ "sale_totl_prfi": "23071.00",
+ "bsop_prti": "-765.00",
+ "op_prfi": "-845.00",
+ "thtr_ntin": "-631.00",
+ "total_aset": "179258.00",
+ "total_lblt": "174772.00",
+ "total_cptl": "4486.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "19",
+ "hts_kor_isnm": "한화",
+ "mksc_shrn_iscd": "000880",
+ "stck_prpr": "28600",
+ "prdy_vrss": "650",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.33",
+ "acml_vol": "123355",
+ "sale_totl_prfi": "22992.00",
+ "bsop_prti": "13738.00",
+ "op_prfi": "16434.00",
+ "thtr_ntin": "11553.00",
+ "total_aset": "2018543.00",
+ "total_lblt": "1675732.00",
+ "total_cptl": "342811.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "20",
+ "hts_kor_isnm": "한화생명",
+ "mksc_shrn_iscd": "088350",
+ "stck_prpr": "3170",
+ "prdy_vrss": "-80",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.46",
+ "acml_vol": "926965",
+ "sale_totl_prfi": "22965.00",
+ "bsop_prti": "7619.00",
+ "op_prfi": "6103.00",
+ "thtr_ntin": "4635.00",
+ "total_aset": "1469270.00",
+ "total_lblt": "1305749.00",
+ "total_cptl": "163521.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "21",
+ "hts_kor_isnm": "NAVER",
+ "mksc_shrn_iscd": "035420",
+ "stck_prpr": "184600",
+ "prdy_vrss": "-1500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.81",
+ "acml_vol": "338155",
+ "sale_totl_prfi": "22804.00",
+ "bsop_prti": "3305.00",
+ "op_prfi": "1166.00",
+ "thtr_ntin": "437.00",
+ "total_aset": "357733.00",
+ "total_lblt": "116494.00",
+ "total_cptl": "241239.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "22",
+ "hts_kor_isnm": "우리금융지주",
+ "mksc_shrn_iscd": "316140",
+ "stck_prpr": "14740",
+ "prdy_vrss": "-490",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.22",
+ "acml_vol": "1903659",
+ "sale_totl_prfi": "22188.00",
+ "bsop_prti": "12520.00",
+ "op_prfi": "12703.00",
+ "thtr_ntin": "9466.00",
+ "total_aset": "4780793.00",
+ "total_lblt": "4454756.00",
+ "total_cptl": "326036.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "23",
+ "hts_kor_isnm": "하나금융지주",
+ "mksc_shrn_iscd": "086790",
+ "stck_prpr": "61700",
+ "prdy_vrss": "-400",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.64",
+ "acml_vol": "731232",
+ "sale_totl_prfi": "21750.00",
+ "bsop_prti": "15188.00",
+ "op_prfi": "14958.00",
+ "thtr_ntin": "11095.00",
+ "total_aset": "5877306.00",
+ "total_lblt": "5491426.00",
+ "total_cptl": "385880.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "24",
+ "hts_kor_isnm": "이마트",
+ "mksc_shrn_iscd": "139480",
+ "stck_prpr": "69800",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.71",
+ "acml_vol": "38727",
+ "sale_totl_prfi": "19974.00",
+ "bsop_prti": "137.00",
+ "op_prfi": "53.00",
+ "thtr_ntin": "27.00",
+ "total_aset": "329952.00",
+ "total_lblt": "196451.00",
+ "total_cptl": "133500.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "25",
+ "hts_kor_isnm": "기업은행",
+ "mksc_shrn_iscd": "024110",
+ "stck_prpr": "15150",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.66",
+ "acml_vol": "937861",
+ "sale_totl_prfi": "19482.00",
+ "bsop_prti": "9156.00",
+ "op_prfi": "9371.00",
+ "thtr_ntin": "7233.00",
+ "total_aset": "4378441.00",
+ "total_lblt": "4079864.00",
+ "total_cptl": "298577.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "26",
+ "hts_kor_isnm": "GS",
+ "mksc_shrn_iscd": "078930",
+ "stck_prpr": "49150",
+ "prdy_vrss": "-250",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.51",
+ "acml_vol": "19800",
+ "sale_totl_prfi": "17946.00",
+ "bsop_prti": "10625.00",
+ "op_prfi": "10055.00",
+ "thtr_ntin": "5211.00",
+ "total_aset": "345250.00",
+ "total_lblt": "178336.00",
+ "total_cptl": "166914.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "27",
+ "hts_kor_isnm": "카카오",
+ "mksc_shrn_iscd": "035720",
+ "stck_prpr": "53500",
+ "prdy_vrss": "-600",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.11",
+ "acml_vol": "370033",
+ "sale_totl_prfi": "17403.00",
+ "bsop_prti": "711.00",
+ "op_prfi": "733.00",
+ "thtr_ntin": "638.00",
+ "total_aset": "255864.00",
+ "total_lblt": "102841.00",
+ "total_cptl": "153023.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "28",
+ "hts_kor_isnm": "롯데쇼핑",
+ "mksc_shrn_iscd": "023530",
+ "stck_prpr": "73300",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.41",
+ "acml_vol": "11381",
+ "sale_totl_prfi": "16117.00",
+ "bsop_prti": "1125.00",
+ "op_prfi": "1051.00",
+ "thtr_ntin": "578.00",
+ "total_aset": "318847.00",
+ "total_lblt": "208468.00",
+ "total_cptl": "110379.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "29",
+ "hts_kor_isnm": "삼성물산",
+ "mksc_shrn_iscd": "028260",
+ "stck_prpr": "151000",
+ "prdy_vrss": "-3100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.01",
+ "acml_vol": "281396",
+ "sale_totl_prfi": "15087.00",
+ "bsop_prti": "6405.00",
+ "op_prfi": "9179.00",
+ "thtr_ntin": "7519.00",
+ "total_aset": "618621.00",
+ "total_lblt": "275928.00",
+ "total_cptl": "342693.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ },
+ {
+ "data_rank": "30",
+ "hts_kor_isnm": "CJ제일제당",
+ "mksc_shrn_iscd": "097950",
+ "stck_prpr": "291000",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.22",
+ "acml_vol": "5733",
+ "sale_totl_prfi": "14572.00",
+ "bsop_prti": "2528.00",
+ "op_prfi": "993.00",
+ "thtr_ntin": "493.00",
+ "total_aset": "305950.00",
+ "total_lblt": "188033.00",
+ "total_cptl": "117916.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "2468"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/150_v1_국내주식-105_국내주식-신고_신저근접종목-상위.md b/docs/broker/kis/rest/국내주식/순위분석/150_v1_국내주식-105_국내주식-신고_신저근접종목-상위.md
new file mode 100644
index 0000000..76a9b60
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/150_v1_국내주식-105_국내주식-신고_신저근접종목-상위.md
@@ -0,0 +1,668 @@
+# 국내주식 신고_신저근접종목 상위
+
+- 원본 시트명: 국내주식 신고_신저근접종목 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-105
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01870000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/near-new-highlow
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 신고/신저근접종목 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0187] 신고/신저 근접종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01870000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_aply_rang_vol | 적용 범위 거래량 | string | Y | 18 | 0: 전체, 100: 100주 이상 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20187) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체, 1:관리종목, 2:투자주의, 3:투자경고 |
+| fid_input_cnt_1 | 입력 수1 | string | Y | 2 | 괴리율 최소 |
+| fid_input_cnt_2 | 입력 수2 | string | Y | 10 | 괴리율 최대 |
+| fid_prc_cls_code | 가격 구분 코드 | string | Y | 10 | 0:신고근접, 1:신저근접 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0: 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0:전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보통주, 7:우선주 |
+| fid_aply_rang_prc_1 | 적용 범위 가격1 | string | Y | 18 | 가격 ~ |
+| fid_aply_rang_prc_2 | 적용 범위 가격2 | string | Y | 18 | ~ 가격 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| askp | 매도호가 | string | Y | 10 | |
+| askp_rsqn1 | 매도호가 잔량1 | string | Y | 12 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| bidp_rsqn1 | 매수호가 잔량1 | string | Y | 12 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| new_hgpr | 신 최고가 | string | Y | 10 | |
+| hprc_near_rate | 고가 근접 비율 | string | Y | 84 | |
+| new_lwpr | 신 최저가 | string | Y | 10 | |
+| lwpr_near_rate | 저가 근접 비율 | string | Y | 84 | |
+| stck_sdpr | 주식 기준가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20187",
+"fid_div_cls_code":"0",
+"fid_input_cnt_1":"",
+"fid_input_cnt_2":"",
+"fid_prc_cls_code":"0",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_aply_rang_prc_1":"",
+"fid_aply_rang_prc_2":"",
+"fid_aply_rang_vol":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "hts_kor_isnm": "IHQ",
+ "mksc_shrn_iscd": "003560",
+ "stck_prpr": "10760",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "10760",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "185",
+ "lwpr_near_rate": "-98.28",
+ "stck_sdpr": "10760"
+ },
+ {
+ "hts_kor_isnm": "선도전기",
+ "mksc_shrn_iscd": "007610",
+ "stck_prpr": "3000",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "3000",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "3000",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "3000"
+ },
+ {
+ "hts_kor_isnm": "청호ICT",
+ "mksc_shrn_iscd": "012600",
+ "stck_prpr": "2490",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2490",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "2490",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "2490"
+ },
+ {
+ "hts_kor_isnm": "광림",
+ "mksc_shrn_iscd": "014200",
+ "stck_prpr": "1006",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "1006",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "1006",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "1006"
+ },
+ {
+ "hts_kor_isnm": "비케이탑스",
+ "mksc_shrn_iscd": "030790",
+ "stck_prpr": "904",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "904",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "904",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "904"
+ },
+ {
+ "hts_kor_isnm": "더라미",
+ "mksc_shrn_iscd": "032860",
+ "stck_prpr": "3640",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "3640",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "3640",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "3640"
+ },
+ {
+ "hts_kor_isnm": "KH 필룩스",
+ "mksc_shrn_iscd": "033180",
+ "stck_prpr": "6630",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "6630",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "325",
+ "lwpr_near_rate": "-95.10",
+ "stck_sdpr": "6630"
+ },
+ {
+ "hts_kor_isnm": "좋은사람들",
+ "mksc_shrn_iscd": "033340",
+ "stck_prpr": "2110",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2110",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "2110",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "2110"
+ },
+ {
+ "hts_kor_isnm": "한국테크놀로지",
+ "mksc_shrn_iscd": "053590",
+ "stck_prpr": "334",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "334",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "334",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "334"
+ },
+ {
+ "hts_kor_isnm": "이노시스",
+ "mksc_shrn_iscd": "056090",
+ "stck_prpr": "1180",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "1180",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "1180",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "1180"
+ },
+ {
+ "hts_kor_isnm": "피에이치씨",
+ "mksc_shrn_iscd": "057880",
+ "stck_prpr": "17570",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "17570",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "1740",
+ "lwpr_near_rate": "-90.10",
+ "stck_sdpr": "17570"
+ },
+ {
+ "hts_kor_isnm": "아리온",
+ "mksc_shrn_iscd": "058220",
+ "stck_prpr": "275",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "275",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "275",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "275"
+ },
+ {
+ "hts_kor_isnm": "파나케이아",
+ "mksc_shrn_iscd": "058530",
+ "stck_prpr": "1620",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "1620",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "1620",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "1620"
+ },
+ {
+ "hts_kor_isnm": "티엘아이",
+ "mksc_shrn_iscd": "062860",
+ "stck_prpr": "5800",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "5800",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "5800",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "5800"
+ },
+ {
+ "hts_kor_isnm": "녹원씨엔아이",
+ "mksc_shrn_iscd": "065560",
+ "stck_prpr": "11540",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "11540",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "5770",
+ "lwpr_near_rate": "-50.00",
+ "stck_sdpr": "11540"
+ },
+ {
+ "hts_kor_isnm": "버킷스튜디오",
+ "mksc_shrn_iscd": "066410",
+ "stck_prpr": "1153",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "1153",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "1153",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "1153"
+ },
+ {
+ "hts_kor_isnm": "국일제지",
+ "mksc_shrn_iscd": "078130",
+ "stck_prpr": "800",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "800",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "800",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "800"
+ },
+ {
+ "hts_kor_isnm": "세원이앤씨",
+ "mksc_shrn_iscd": "091090",
+ "stck_prpr": "1270",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "1270",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "185",
+ "lwpr_near_rate": "-85.43",
+ "stck_sdpr": "1270"
+ },
+ {
+ "hts_kor_isnm": "인바이오젠",
+ "mksc_shrn_iscd": "101140",
+ "stck_prpr": "9340",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "9340",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "462",
+ "lwpr_near_rate": "-95.05",
+ "stck_sdpr": "9340"
+ },
+ {
+ "hts_kor_isnm": "주성코퍼레이션",
+ "mksc_shrn_iscd": "109070",
+ "stck_prpr": "4100",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "4100",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "4100",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "4100"
+ },
+ {
+ "hts_kor_isnm": "KH 전자",
+ "mksc_shrn_iscd": "111870",
+ "stck_prpr": "2970",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2970",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "145",
+ "lwpr_near_rate": "-95.12",
+ "stck_sdpr": "2970"
+ },
+ {
+ "hts_kor_isnm": "스마트솔루션즈",
+ "mksc_shrn_iscd": "136510",
+ "stck_prpr": "11600",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "11600",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "11600",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "11600"
+ },
+ {
+ "hts_kor_isnm": "비디아이",
+ "mksc_shrn_iscd": "148140",
+ "stck_prpr": "6140",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "6140",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "640",
+ "lwpr_near_rate": "-89.58",
+ "stck_sdpr": "6140"
+ },
+ {
+ "hts_kor_isnm": "인트로메딕",
+ "mksc_shrn_iscd": "150840",
+ "stck_prpr": "5850",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "5850",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "5850",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "5850"
+ },
+ {
+ "hts_kor_isnm": "이큐셀",
+ "mksc_shrn_iscd": "160600",
+ "stck_prpr": "3100",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "3100",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "3100",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "3100"
+ },
+ {
+ "hts_kor_isnm": "장원테크",
+ "mksc_shrn_iscd": "174880",
+ "stck_prpr": "2650",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2650",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "455",
+ "lwpr_near_rate": "-82.83",
+ "stck_sdpr": "2650"
+ },
+ {
+ "hts_kor_isnm": "일월지엠엘",
+ "mksc_shrn_iscd": "178780",
+ "stck_prpr": "8650",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "8650",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "8650",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "8650"
+ },
+ {
+ "hts_kor_isnm": "이즈미디어",
+ "mksc_shrn_iscd": "181340",
+ "stck_prpr": "2705",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2705",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "2705",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "2705"
+ },
+ {
+ "hts_kor_isnm": "KODEX 미국S&P500산업재(합성)",
+ "mksc_shrn_iscd": "200030",
+ "stck_prpr": "28335",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "200",
+ "prdy_ctrt": "0.71",
+ "askp": "28330",
+ "askp_rsqn1": "5000",
+ "bidp": "28270",
+ "bidp_rsqn1": "7",
+ "acml_vol": "4998",
+ "new_hgpr": "28335",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "21600",
+ "lwpr_near_rate": "-23.77",
+ "stck_sdpr": "28135"
+ },
+ {
+ "hts_kor_isnm": "엔지스테크널러지",
+ "mksc_shrn_iscd": "208860",
+ "stck_prpr": "2205",
+ "prdy_vrss_sign": "0",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "askp": "0",
+ "askp_rsqn1": "0",
+ "bidp": "0",
+ "bidp_rsqn1": "0",
+ "acml_vol": "0",
+ "new_hgpr": "2205",
+ "hprc_near_rate": "0.00",
+ "new_lwpr": "2205",
+ "lwpr_near_rate": "0.00",
+ "stck_sdpr": "2205"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/151_v1_국내주식-094_국내주식-우선주_괴리율-상위.md b/docs/broker/kis/rest/국내주식/순위분석/151_v1_국내주식-094_국내주식-우선주_괴리율-상위.md
new file mode 100644
index 0000000..94dd379
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/151_v1_국내주식-094_국내주식-우선주_괴리율-상위.md
@@ -0,0 +1,693 @@
+# 국내주식 우선주_괴리율 상위
+
+- 원본 시트명: 국내주식 우선주_괴리율 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-094
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01770000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/prefer-disparate-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 우선주/괴리율 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0177] 우선주/괴리율 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01770000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20177 ) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 전체 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 10 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 10 | |
+| prst_iscd | 우선주 종목코드 | string | Y | 10 | |
+| prst_kor_isnm | 우선주 한글 종목명 | string | Y | 10 | |
+| prst_prpr | 우선주 현재가 | string | Y | 10 | |
+| prst_prdy_vrss | 우선주 전일대비 | string | Y | 10 | |
+| prst_prdy_vrss_sign | 우선주 전일 대비 부호 | string | Y | 10 | |
+| prst_acml_vol | 우선주 누적 거래량 | string | Y | 40 | |
+| diff_prpr | 차이 현재가 | string | Y | 10 | |
+| dprt | 괴리율 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 1 | |
+| prst_prdy_ctrt | 우선주 전일 대비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20177",
+"fid_div_cls_code":"0",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0"
+"fid_trgt_exls_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "336370",
+ "data_rank": "1",
+ "hts_kor_isnm": "솔루스첨단소재",
+ "stck_prpr": "13610",
+ "prdy_vrss": "210",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "108604",
+ "prst_iscd": "A33637K",
+ "prst_kor_isnm": "솔루스첨단소재1우",
+ "prst_prpr": "2890",
+ "prst_prdy_vrss": "30",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "8203",
+ "diff_prpr": "10720",
+ "dprt": "78.77",
+ "prdy_ctrt": "1.57",
+ "prst_prdy_ctrt": "1.05"
+ },
+ {
+ "mksc_shrn_iscd": "336260",
+ "data_rank": "2",
+ "hts_kor_isnm": "두산퓨얼셀",
+ "stck_prpr": "20300",
+ "prdy_vrss": "510",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "186883",
+ "prst_iscd": "A33626K",
+ "prst_kor_isnm": "두산퓨얼셀1우",
+ "prst_prpr": "6140",
+ "prst_prdy_vrss": "40",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "4656",
+ "diff_prpr": "14160",
+ "dprt": "69.75",
+ "prdy_ctrt": "2.58",
+ "prst_prdy_ctrt": "0.66"
+ },
+ {
+ "mksc_shrn_iscd": "090430",
+ "data_rank": "3",
+ "hts_kor_isnm": "아모레퍼시픽",
+ "stck_prpr": "113000",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "28537",
+ "prst_iscd": "A090435",
+ "prst_kor_isnm": "아모레퍼시픽우",
+ "prst_prpr": "34900",
+ "prst_prdy_vrss": "900",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "4561",
+ "diff_prpr": "78100",
+ "dprt": "69.12",
+ "prdy_ctrt": "-0.09",
+ "prst_prdy_ctrt": "2.65"
+ },
+ {
+ "mksc_shrn_iscd": "336370",
+ "data_rank": "4",
+ "hts_kor_isnm": "솔루스첨단소재",
+ "stck_prpr": "13610",
+ "prdy_vrss": "210",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "108604",
+ "prst_iscd": "A33637L",
+ "prst_kor_isnm": "솔루스첨단소재2우B",
+ "prst_prpr": "4825",
+ "prst_prdy_vrss": "40",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "8216",
+ "diff_prpr": "8785",
+ "dprt": "64.55",
+ "prdy_ctrt": "1.57",
+ "prst_prdy_ctrt": "0.84"
+ },
+ {
+ "mksc_shrn_iscd": "007810",
+ "data_rank": "5",
+ "hts_kor_isnm": "코리아써키트",
+ "stck_prpr": "18580",
+ "prdy_vrss": "340",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "89546",
+ "prst_iscd": "A007815",
+ "prst_kor_isnm": "코리아써우",
+ "prst_prpr": "6610",
+ "prst_prdy_vrss": "0",
+ "prst_prdy_vrss_sign": "3",
+ "prst_acml_vol": "2062",
+ "diff_prpr": "11970",
+ "dprt": "64.42",
+ "prdy_ctrt": "1.86",
+ "prst_prdy_ctrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "002790",
+ "data_rank": "6",
+ "hts_kor_isnm": "아모레G",
+ "stck_prpr": "26050",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "25297",
+ "prst_iscd": "A002795",
+ "prst_kor_isnm": "아모레G우",
+ "prst_prpr": "9780",
+ "prst_prdy_vrss": "-30",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "1796",
+ "diff_prpr": "16270",
+ "dprt": "62.46",
+ "prdy_ctrt": "0.39",
+ "prst_prdy_ctrt": "-0.31"
+ },
+ {
+ "mksc_shrn_iscd": "001460",
+ "data_rank": "7",
+ "hts_kor_isnm": "BYC",
+ "stck_prpr": "481000",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "89",
+ "prst_iscd": "A001465",
+ "prst_kor_isnm": "BYC우",
+ "prst_prpr": "182500",
+ "prst_prdy_vrss": "2700",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "169",
+ "diff_prpr": "298500",
+ "dprt": "62.06",
+ "prdy_ctrt": "0.63",
+ "prst_prdy_ctrt": "1.50"
+ },
+ {
+ "mksc_shrn_iscd": "007810",
+ "data_rank": "8",
+ "hts_kor_isnm": "코리아써키트",
+ "stck_prpr": "18580",
+ "prdy_vrss": "340",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "89546",
+ "prst_iscd": "A00781K",
+ "prst_kor_isnm": "코리아써키트2우B",
+ "prst_prpr": "7110",
+ "prst_prdy_vrss": "-80",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "477",
+ "diff_prpr": "11470",
+ "dprt": "61.73",
+ "prdy_ctrt": "1.86",
+ "prst_prdy_ctrt": "-1.11"
+ },
+ {
+ "mksc_shrn_iscd": "002350",
+ "data_rank": "9",
+ "hts_kor_isnm": "넥센타이어",
+ "stck_prpr": "8170",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "18622",
+ "prst_iscd": "A002355",
+ "prst_kor_isnm": "넥센타이어1우B",
+ "prst_prpr": "3240",
+ "prst_prdy_vrss": "-10",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "671",
+ "diff_prpr": "4930",
+ "dprt": "60.34",
+ "prdy_ctrt": "-1.21",
+ "prst_prdy_ctrt": "-0.31"
+ },
+ {
+ "mksc_shrn_iscd": "353200",
+ "data_rank": "10",
+ "hts_kor_isnm": "대덕전자",
+ "stck_prpr": "22750",
+ "prdy_vrss": "-150",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "94610",
+ "prst_iscd": "A35320K",
+ "prst_kor_isnm": "대덕전자1우",
+ "prst_prpr": "9400",
+ "prst_prdy_vrss": "-80",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "2310",
+ "diff_prpr": "13350",
+ "dprt": "58.68",
+ "prdy_ctrt": "-0.66",
+ "prst_prdy_ctrt": "-0.84"
+ },
+ {
+ "mksc_shrn_iscd": "336260",
+ "data_rank": "11",
+ "hts_kor_isnm": "두산퓨얼셀",
+ "stck_prpr": "20300",
+ "prdy_vrss": "510",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "186883",
+ "prst_iscd": "A33626L",
+ "prst_kor_isnm": "두산퓨얼셀2우B",
+ "prst_prpr": "8450",
+ "prst_prdy_vrss": "80",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "1058",
+ "diff_prpr": "11850",
+ "dprt": "58.37",
+ "prdy_ctrt": "2.58",
+ "prst_prdy_ctrt": "0.96"
+ },
+ {
+ "mksc_shrn_iscd": "285130",
+ "data_rank": "12",
+ "hts_kor_isnm": "SK케미칼",
+ "stck_prpr": "65200",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "acml_vol": "6644",
+ "prst_iscd": "A28513K",
+ "prst_kor_isnm": "SK케미칼우",
+ "prst_prpr": "28300",
+ "prst_prdy_vrss": "0",
+ "prst_prdy_vrss_sign": "3",
+ "prst_acml_vol": "497",
+ "diff_prpr": "36900",
+ "dprt": "56.60",
+ "prdy_ctrt": "0.00",
+ "prst_prdy_ctrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "051900",
+ "data_rank": "13",
+ "hts_kor_isnm": "LG생활건강",
+ "stck_prpr": "353500",
+ "prdy_vrss": "8000",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "34567",
+ "prst_iscd": "A051905",
+ "prst_kor_isnm": "LG생활건강우",
+ "prst_prpr": "153700",
+ "prst_prdy_vrss": "1700",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "1066",
+ "diff_prpr": "199800",
+ "dprt": "56.52",
+ "prdy_ctrt": "2.32",
+ "prst_prdy_ctrt": "1.12"
+ },
+ {
+ "mksc_shrn_iscd": "180640",
+ "data_rank": "14",
+ "hts_kor_isnm": "한진칼",
+ "stck_prpr": "59500",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "47348",
+ "prst_iscd": "A18064K",
+ "prst_kor_isnm": "한진칼우",
+ "prst_prpr": "25900",
+ "prst_prdy_vrss": "250",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "229",
+ "diff_prpr": "33600",
+ "dprt": "56.47",
+ "prdy_ctrt": "0.68",
+ "prst_prdy_ctrt": "0.97"
+ },
+ {
+ "mksc_shrn_iscd": "066570",
+ "data_rank": "15",
+ "hts_kor_isnm": "LG전자",
+ "stck_prpr": "97600",
+ "prdy_vrss": "-1300",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "149144",
+ "prst_iscd": "A066575",
+ "prst_kor_isnm": "LG전자우",
+ "prst_prpr": "43600",
+ "prst_prdy_vrss": "-300",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "9737",
+ "diff_prpr": "54000",
+ "dprt": "55.33",
+ "prdy_ctrt": "-1.31",
+ "prst_prdy_ctrt": "-0.68"
+ },
+ {
+ "mksc_shrn_iscd": "000150",
+ "data_rank": "16",
+ "hts_kor_isnm": "두산",
+ "stck_prpr": "150700",
+ "prdy_vrss": "5700",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "203379",
+ "prst_iscd": "A000155",
+ "prst_kor_isnm": "두산우",
+ "prst_prpr": "69600",
+ "prst_prdy_vrss": "4700",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "46666",
+ "diff_prpr": "81100",
+ "dprt": "53.82",
+ "prdy_ctrt": "3.93",
+ "prst_prdy_ctrt": "7.24"
+ },
+ {
+ "mksc_shrn_iscd": "097950",
+ "data_rank": "17",
+ "hts_kor_isnm": "CJ제일제당",
+ "stck_prpr": "290500",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "6350",
+ "prst_iscd": "A097955",
+ "prst_kor_isnm": "CJ제일제당 우",
+ "prst_prpr": "134600",
+ "prst_prdy_vrss": "700",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "743",
+ "diff_prpr": "155900",
+ "dprt": "53.67",
+ "prdy_ctrt": "1.04",
+ "prst_prdy_ctrt": "0.52"
+ },
+ {
+ "mksc_shrn_iscd": "006800",
+ "data_rank": "18",
+ "hts_kor_isnm": "미래에셋증권",
+ "stck_prpr": "8080",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "149300",
+ "prst_iscd": "A00680K",
+ "prst_kor_isnm": "미래에셋증권2우B",
+ "prst_prpr": "3845",
+ "prst_prdy_vrss": "15",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "74992",
+ "diff_prpr": "4235",
+ "dprt": "52.41",
+ "prdy_ctrt": "0.75",
+ "prst_prdy_ctrt": "0.39"
+ },
+ {
+ "mksc_shrn_iscd": "009150",
+ "data_rank": "19",
+ "hts_kor_isnm": "삼성전기",
+ "stck_prpr": "143800",
+ "prdy_vrss": "-1800",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "225844",
+ "prst_iscd": "A009155",
+ "prst_kor_isnm": "삼성전기우",
+ "prst_prpr": "70300",
+ "prst_prdy_vrss": "-500",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "1722",
+ "diff_prpr": "73500",
+ "dprt": "51.11",
+ "prdy_ctrt": "-1.24",
+ "prst_prdy_ctrt": "-0.71"
+ },
+ {
+ "mksc_shrn_iscd": "011780",
+ "data_rank": "20",
+ "hts_kor_isnm": "금호석유",
+ "stck_prpr": "138000",
+ "prdy_vrss": "-1700",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "19759",
+ "prst_iscd": "A011785",
+ "prst_kor_isnm": "금호석유우",
+ "prst_prpr": "69100",
+ "prst_prdy_vrss": "-700",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "793",
+ "diff_prpr": "68900",
+ "dprt": "49.93",
+ "prdy_ctrt": "-1.22",
+ "prst_prdy_ctrt": "-1.00"
+ },
+ {
+ "mksc_shrn_iscd": "375500",
+ "data_rank": "21",
+ "hts_kor_isnm": "DL이앤씨",
+ "stck_prpr": "35000",
+ "prdy_vrss": "150",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "34365",
+ "prst_iscd": "A37550K",
+ "prst_kor_isnm": "DL이앤씨우",
+ "prst_prpr": "17920",
+ "prst_prdy_vrss": "-350",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "1575",
+ "diff_prpr": "17080",
+ "dprt": "48.80",
+ "prdy_ctrt": "0.43",
+ "prst_prdy_ctrt": "-1.92"
+ },
+ {
+ "mksc_shrn_iscd": "000880",
+ "data_rank": "22",
+ "hts_kor_isnm": "한화",
+ "stck_prpr": "28650",
+ "prdy_vrss": "700",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "135191",
+ "prst_iscd": "A00088K",
+ "prst_kor_isnm": "한화3우B",
+ "prst_prpr": "15050",
+ "prst_prdy_vrss": "110",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "9206",
+ "diff_prpr": "13600",
+ "dprt": "47.47",
+ "prdy_ctrt": "2.50",
+ "prst_prdy_ctrt": "0.74"
+ },
+ {
+ "mksc_shrn_iscd": "108670",
+ "data_rank": "23",
+ "hts_kor_isnm": "LX하우시스",
+ "stck_prpr": "39200",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "acml_vol": "4608",
+ "prst_iscd": "A108675",
+ "prst_kor_isnm": "LX하우시스우",
+ "prst_prpr": "20600",
+ "prst_prdy_vrss": "-300",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "555",
+ "diff_prpr": "18600",
+ "dprt": "47.45",
+ "prdy_ctrt": "-0.13",
+ "prst_prdy_ctrt": "-1.44"
+ },
+ {
+ "mksc_shrn_iscd": "006800",
+ "data_rank": "24",
+ "hts_kor_isnm": "미래에셋증권",
+ "stck_prpr": "8080",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "149300",
+ "prst_iscd": "A006805",
+ "prst_kor_isnm": "미래에셋증권우",
+ "prst_prpr": "4300",
+ "prst_prdy_vrss": "-60",
+ "prst_prdy_vrss_sign": "5",
+ "prst_acml_vol": "18334",
+ "diff_prpr": "3780",
+ "dprt": "46.78",
+ "prdy_ctrt": "0.75",
+ "prst_prdy_ctrt": "-1.38"
+ },
+ {
+ "mksc_shrn_iscd": "000210",
+ "data_rank": "25",
+ "hts_kor_isnm": "DL",
+ "stck_prpr": "46400",
+ "prdy_vrss": "1550",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "39343",
+ "prst_iscd": "A000215",
+ "prst_kor_isnm": "DL우",
+ "prst_prpr": "24900",
+ "prst_prdy_vrss": "250",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "147",
+ "diff_prpr": "21500",
+ "dprt": "46.34",
+ "prdy_ctrt": "3.46",
+ "prst_prdy_ctrt": "1.01"
+ },
+ {
+ "mksc_shrn_iscd": "000150",
+ "data_rank": "26",
+ "hts_kor_isnm": "두산",
+ "stck_prpr": "150700",
+ "prdy_vrss": "5700",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "203379",
+ "prst_iscd": "A000157",
+ "prst_kor_isnm": "두산2우B",
+ "prst_prpr": "81400",
+ "prst_prdy_vrss": "2800",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "2430",
+ "diff_prpr": "69300",
+ "dprt": "45.99",
+ "prdy_ctrt": "3.93",
+ "prst_prdy_ctrt": "3.56"
+ },
+ {
+ "mksc_shrn_iscd": "001040",
+ "data_rank": "27",
+ "hts_kor_isnm": "CJ",
+ "stck_prpr": "110600",
+ "prdy_vrss": "1400",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "229827",
+ "prst_iscd": "A001045",
+ "prst_kor_isnm": "CJ우",
+ "prst_prpr": "59800",
+ "prst_prdy_vrss": "0",
+ "prst_prdy_vrss_sign": "3",
+ "prst_acml_vol": "2681",
+ "diff_prpr": "50800",
+ "dprt": "45.93",
+ "prdy_ctrt": "1.28",
+ "prst_prdy_ctrt": "0.00"
+ },
+ {
+ "mksc_shrn_iscd": "005300",
+ "data_rank": "28",
+ "hts_kor_isnm": "롯데칠성",
+ "stck_prpr": "126500",
+ "prdy_vrss": "300",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "3080",
+ "prst_iscd": "A005305",
+ "prst_kor_isnm": "롯데칠성우",
+ "prst_prpr": "68400",
+ "prst_prdy_vrss": "300",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "267",
+ "diff_prpr": "58100",
+ "dprt": "45.93",
+ "prdy_ctrt": "0.24",
+ "prst_prdy_ctrt": "0.44"
+ },
+ {
+ "mksc_shrn_iscd": "014820",
+ "data_rank": "29",
+ "hts_kor_isnm": "동원시스템즈",
+ "stck_prpr": "46200",
+ "prdy_vrss": "3150",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "224535",
+ "prst_iscd": "A014825",
+ "prst_kor_isnm": "동원시스템즈우",
+ "prst_prpr": "25200",
+ "prst_prdy_vrss": "1250",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "456",
+ "diff_prpr": "21000",
+ "dprt": "45.45",
+ "prdy_ctrt": "7.32",
+ "prst_prdy_ctrt": "5.22"
+ },
+ {
+ "mksc_shrn_iscd": "006400",
+ "data_rank": "30",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "438000",
+ "prdy_vrss": "13000",
+ "prdy_vrss_sign": "2",
+ "acml_vol": "236248",
+ "prst_iscd": "A006405",
+ "prst_kor_isnm": "삼성SDI우",
+ "prst_prpr": "245500",
+ "prst_prdy_vrss": "2500",
+ "prst_prdy_vrss_sign": "2",
+ "prst_acml_vol": "1166",
+ "diff_prpr": "192500",
+ "dprt": "43.95",
+ "prdy_ctrt": "3.06",
+ "prst_prdy_ctrt": "1.03"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/152_국내주식-107_국내주식-대량체결건수-상위.md b/docs/broker/kis/rest/국내주식/순위분석/152_국내주식-107_국내주식-대량체결건수-상위.md
new file mode 100644
index 0000000..c1ef80d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/152_국내주식-107_국내주식-대량체결건수-상위.md
@@ -0,0 +1,506 @@
+# 국내주식 대량체결건수 상위
+
+- 원본 시트명: 국내주식 대량체결건수 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-107
+- HTTP Method: GET
+- 실전 TR_ID: FHKST190900C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/bulk-trans-num
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 대량체결건수 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0169] 대량체결건수 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST190900C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_aply_rang_prc_2 | 적용 범위 가격2 | string | Y | 18 | ~ 가격 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11909) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:매수상위, 1:매도상위 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 건별금액 ~ |
+| fid_aply_rang_prc_1 | 적용 범위 가격1 | string | Y | 18 | 가격 ~ |
+| fid_input_iscd_2 | 입력 종목코드2 | string | Y | 8 | 공백:전체종목, 개별종목 조회시 종목코드 (000660) |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 거래량 ~ |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| shnu_cntg_csnu | 매수2 체결 건수 | string | Y | 10 | |
+| seln_cntg_csnu | 매도 체결 건수 | string | Y | 10 | |
+| ntby_cnqn | 순매수 체결량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "000660",
+ "data_rank": "1",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "162600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1400",
+ "prdy_ctrt": "0.87",
+ "acml_vol": "1593227",
+ "shnu_cntg_csnu": "3172",
+ "seln_cntg_csnu": "2104",
+ "ntby_cnqn": "1068"
+ },
+ {
+ "mksc_shrn_iscd": "207940",
+ "data_rank": "2",
+ "hts_kor_isnm": "삼성바이오로직스",
+ "stck_prpr": "869000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "43000",
+ "prdy_ctrt": "5.21",
+ "acml_vol": "140772",
+ "shnu_cntg_csnu": "1446",
+ "seln_cntg_csnu": "725",
+ "ntby_cnqn": "721"
+ },
+ {
+ "mksc_shrn_iscd": "006400",
+ "data_rank": "3",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "444000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "19000",
+ "prdy_ctrt": "4.47",
+ "acml_vol": "441633",
+ "shnu_cntg_csnu": "2167",
+ "seln_cntg_csnu": "1488",
+ "ntby_cnqn": "679"
+ },
+ {
+ "mksc_shrn_iscd": "007660",
+ "data_rank": "4",
+ "hts_kor_isnm": "이수페타시스",
+ "stck_prpr": "37150",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "3700",
+ "prdy_ctrt": "11.06",
+ "acml_vol": "7737796",
+ "shnu_cntg_csnu": "2920",
+ "seln_cntg_csnu": "2361",
+ "ntby_cnqn": "559"
+ },
+ {
+ "mksc_shrn_iscd": "112040",
+ "data_rank": "5",
+ "hts_kor_isnm": "위메이드",
+ "stck_prpr": "67100",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10900",
+ "prdy_ctrt": "19.40",
+ "acml_vol": "3088002",
+ "shnu_cntg_csnu": "2150",
+ "seln_cntg_csnu": "1697",
+ "ntby_cnqn": "453"
+ },
+ {
+ "mksc_shrn_iscd": "457190",
+ "data_rank": "6",
+ "hts_kor_isnm": "이수스페셜티케미컬",
+ "stck_prpr": "389500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "47000",
+ "prdy_ctrt": "13.72",
+ "acml_vol": "671298",
+ "shnu_cntg_csnu": "2582",
+ "seln_cntg_csnu": "2201",
+ "ntby_cnqn": "381"
+ },
+ {
+ "mksc_shrn_iscd": "454910",
+ "data_rank": "7",
+ "hts_kor_isnm": "두산로보틱스",
+ "stck_prpr": "92900",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5800",
+ "prdy_ctrt": "6.66",
+ "acml_vol": "1169659",
+ "shnu_cntg_csnu": "1214",
+ "seln_cntg_csnu": "836",
+ "ntby_cnqn": "378"
+ },
+ {
+ "mksc_shrn_iscd": "441540",
+ "data_rank": "8",
+ "hts_kor_isnm": "HANARO Fn조선해운",
+ "stck_prpr": "10610",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "245",
+ "prdy_ctrt": "2.36",
+ "acml_vol": "2423370",
+ "shnu_cntg_csnu": "458",
+ "seln_cntg_csnu": "82",
+ "ntby_cnqn": "376"
+ },
+ {
+ "mksc_shrn_iscd": "066970",
+ "data_rank": "9",
+ "hts_kor_isnm": "엘앤에프",
+ "stck_prpr": "174700",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "12500",
+ "prdy_ctrt": "7.71",
+ "acml_vol": "424191",
+ "shnu_cntg_csnu": "676",
+ "seln_cntg_csnu": "328",
+ "ntby_cnqn": "348"
+ },
+ {
+ "mksc_shrn_iscd": "006260",
+ "data_rank": "10",
+ "hts_kor_isnm": "LS",
+ "stck_prpr": "111000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "6900",
+ "prdy_ctrt": "6.63",
+ "acml_vol": "475967",
+ "shnu_cntg_csnu": "831",
+ "seln_cntg_csnu": "510",
+ "ntby_cnqn": "321"
+ },
+ {
+ "mksc_shrn_iscd": "247540",
+ "data_rank": "11",
+ "hts_kor_isnm": "에코프로비엠",
+ "stck_prpr": "265500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "9000",
+ "prdy_ctrt": "3.51",
+ "acml_vol": "484949",
+ "shnu_cntg_csnu": "1320",
+ "seln_cntg_csnu": "1004",
+ "ntby_cnqn": "316"
+ },
+ {
+ "mksc_shrn_iscd": "051910",
+ "data_rank": "12",
+ "hts_kor_isnm": "LG화학",
+ "stck_prpr": "441500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10500",
+ "prdy_ctrt": "2.44",
+ "acml_vol": "119939",
+ "shnu_cntg_csnu": "708",
+ "seln_cntg_csnu": "399",
+ "ntby_cnqn": "309"
+ },
+ {
+ "mksc_shrn_iscd": "196170",
+ "data_rank": "13",
+ "hts_kor_isnm": "알테오젠",
+ "stck_prpr": "209500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5000",
+ "prdy_ctrt": "2.44",
+ "acml_vol": "1859846",
+ "shnu_cntg_csnu": "3637",
+ "seln_cntg_csnu": "3379",
+ "ntby_cnqn": "258"
+ },
+ {
+ "mksc_shrn_iscd": "042660",
+ "data_rank": "14",
+ "hts_kor_isnm": "한화오션",
+ "stck_prpr": "28850",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1850",
+ "prdy_ctrt": "6.85",
+ "acml_vol": "3370897",
+ "shnu_cntg_csnu": "1112",
+ "seln_cntg_csnu": "856",
+ "ntby_cnqn": "256"
+ },
+ {
+ "mksc_shrn_iscd": "000270",
+ "data_rank": "15",
+ "hts_kor_isnm": "기아",
+ "stck_prpr": "127500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "2500",
+ "prdy_ctrt": "2.00",
+ "acml_vol": "866368",
+ "shnu_cntg_csnu": "1342",
+ "seln_cntg_csnu": "1110",
+ "ntby_cnqn": "232"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "000660",
+ "data_rank": "1",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "162600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1400",
+ "prdy_ctrt": "0.87",
+ "acml_vol": "1593227",
+ "shnu_cntg_csnu": "3172",
+ "seln_cntg_csnu": "2104",
+ "ntby_cnqn": "1068"
+ },
+ {
+ "mksc_shrn_iscd": "207940",
+ "data_rank": "2",
+ "hts_kor_isnm": "삼성바이오로직스",
+ "stck_prpr": "869000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "43000",
+ "prdy_ctrt": "5.21",
+ "acml_vol": "140772",
+ "shnu_cntg_csnu": "1446",
+ "seln_cntg_csnu": "725",
+ "ntby_cnqn": "721"
+ },
+ {
+ "mksc_shrn_iscd": "006400",
+ "data_rank": "3",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "444000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "19000",
+ "prdy_ctrt": "4.47",
+ "acml_vol": "441633",
+ "shnu_cntg_csnu": "2167",
+ "seln_cntg_csnu": "1488",
+ "ntby_cnqn": "679"
+ },
+ {
+ "mksc_shrn_iscd": "007660",
+ "data_rank": "4",
+ "hts_kor_isnm": "이수페타시스",
+ "stck_prpr": "37150",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "3700",
+ "prdy_ctrt": "11.06",
+ "acml_vol": "7737796",
+ "shnu_cntg_csnu": "2920",
+ "seln_cntg_csnu": "2361",
+ "ntby_cnqn": "559"
+ },
+ {
+ "mksc_shrn_iscd": "112040",
+ "data_rank": "5",
+ "hts_kor_isnm": "위메이드",
+ "stck_prpr": "67100",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10900",
+ "prdy_ctrt": "19.40",
+ "acml_vol": "3088002",
+ "shnu_cntg_csnu": "2150",
+ "seln_cntg_csnu": "1697",
+ "ntby_cnqn": "453"
+ },
+ {
+ "mksc_shrn_iscd": "457190",
+ "data_rank": "6",
+ "hts_kor_isnm": "이수스페셜티케미컬",
+ "stck_prpr": "389500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "47000",
+ "prdy_ctrt": "13.72",
+ "acml_vol": "671298",
+ "shnu_cntg_csnu": "2582",
+ "seln_cntg_csnu": "2201",
+ "ntby_cnqn": "381"
+ },
+ {
+ "mksc_shrn_iscd": "454910",
+ "data_rank": "7",
+ "hts_kor_isnm": "두산로보틱스",
+ "stck_prpr": "92900",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5800",
+ "prdy_ctrt": "6.66",
+ "acml_vol": "1169659",
+ "shnu_cntg_csnu": "1214",
+ "seln_cntg_csnu": "836",
+ "ntby_cnqn": "378"
+ },
+ {
+ "mksc_shrn_iscd": "441540",
+ "data_rank": "8",
+ "hts_kor_isnm": "HANARO Fn조선해운",
+ "stck_prpr": "10610",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "245",
+ "prdy_ctrt": "2.36",
+ "acml_vol": "2423370",
+ "shnu_cntg_csnu": "458",
+ "seln_cntg_csnu": "82",
+ "ntby_cnqn": "376"
+ },
+ {
+ "mksc_shrn_iscd": "066970",
+ "data_rank": "9",
+ "hts_kor_isnm": "엘앤에프",
+ "stck_prpr": "174700",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "12500",
+ "prdy_ctrt": "7.71",
+ "acml_vol": "424191",
+ "shnu_cntg_csnu": "676",
+ "seln_cntg_csnu": "328",
+ "ntby_cnqn": "348"
+ },
+ {
+ "mksc_shrn_iscd": "006260",
+ "data_rank": "10",
+ "hts_kor_isnm": "LS",
+ "stck_prpr": "111000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "6900",
+ "prdy_ctrt": "6.63",
+ "acml_vol": "475967",
+ "shnu_cntg_csnu": "831",
+ "seln_cntg_csnu": "510",
+ "ntby_cnqn": "321"
+ },
+ {
+ "mksc_shrn_iscd": "247540",
+ "data_rank": "11",
+ "hts_kor_isnm": "에코프로비엠",
+ "stck_prpr": "265500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "9000",
+ "prdy_ctrt": "3.51",
+ "acml_vol": "484949",
+ "shnu_cntg_csnu": "1320",
+ "seln_cntg_csnu": "1004",
+ "ntby_cnqn": "316"
+ },
+ {
+ "mksc_shrn_iscd": "051910",
+ "data_rank": "12",
+ "hts_kor_isnm": "LG화학",
+ "stck_prpr": "441500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10500",
+ "prdy_ctrt": "2.44",
+ "acml_vol": "119939",
+ "shnu_cntg_csnu": "708",
+ "seln_cntg_csnu": "399",
+ "ntby_cnqn": "309"
+ },
+ {
+ "mksc_shrn_iscd": "196170",
+ "data_rank": "13",
+ "hts_kor_isnm": "알테오젠",
+ "stck_prpr": "209500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5000",
+ "prdy_ctrt": "2.44",
+ "acml_vol": "1859846",
+ "shnu_cntg_csnu": "3637",
+ "seln_cntg_csnu": "3379",
+ "ntby_cnqn": "258"
+ },
+ {
+ "mksc_shrn_iscd": "042660",
+ "data_rank": "14",
+ "hts_kor_isnm": "한화오션",
+ "stck_prpr": "28850",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1850",
+ "prdy_ctrt": "6.85",
+ "acml_vol": "3370897",
+ "shnu_cntg_csnu": "1112",
+ "seln_cntg_csnu": "856",
+ "ntby_cnqn": "256"
+ },
+ {
+ "mksc_shrn_iscd": "000270",
+ "data_rank": "15",
+ "hts_kor_isnm": "기아",
+ "stck_prpr": "127500",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "2500",
+ "prdy_ctrt": "2.00",
+ "acml_vol": "866368",
+ "shnu_cntg_csnu": "1342",
+ "seln_cntg_csnu": "1110",
+ "ntby_cnqn": "232"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/153_v1_국내주식-092_국내주식-재무비율-순위.md b/docs/broker/kis/rest/국내주식/순위분석/153_v1_국내주식-092_국내주식-재무비율-순위.md
new file mode 100644
index 0000000..da2d645
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/153_v1_국내주식-092_국내주식-재무비율-순위.md
@@ -0,0 +1,1011 @@
+# 국내주식 재무비율 순위
+
+- 원본 시트명: 국내주식 재무비율 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-092
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01750000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/finance-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 재무비율 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0175] 재무비율순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01750000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20175 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0 : 전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_input_option_1 | 입력 옵션1 | string | Y | 10 | 회계년도 입력 (ex 2023) |
+| fid_input_option_2 | 입력 옵션2 | string | Y | 10 | 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 7: 수익성 분석, 11 : 안정성 분석, 15: 성장성 분석, 20: 활동성 분석 |
+| fid_blng_cls_code | 소속 구분 코드 | string | Y | 2 | 0 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cptl_op_prfi | 총자본경상이익율 | string | Y | 92 | |
+| cptl_ntin_rate | 총자본 순이익율 | string | Y | 92 | |
+| sale_totl_rate | 매출액 총이익율 | string | Y | 92 | |
+| sale_ntin_rate | 매출액 순이익율 | string | Y | 92 | |
+| bis | 자기자본비율 | string | Y | 92 | |
+| lblt_rate | 부채 비율 | string | Y | 84 | |
+| bram_depn | 차입금 의존도 | string | Y | 92 | |
+| rsrv_rate | 유보 비율 | string | Y | 124 | |
+| grs | 매출액 증가율 | string | Y | 124 | |
+| op_prfi_inrt | 경상 이익 증가율 | string | Y | 124 | |
+| bsop_prfi_inrt | 영업 이익 증가율 | string | Y | 124 | |
+| ntin_inrt | 순이익 증가율 | string | Y | 124 | |
+| equt_inrt | 자기자본 증가율 | string | Y | 92 | |
+| cptl_tnrt | 총자본회전율 | string | Y | 92 | |
+| sale_bond_tnrt | 매출 채권 회전율 | string | Y | 92 | |
+| totl_aset_inrt | 총자산 증가율 | string | Y | 92 | |
+| stac_month | 결산 월 | string | Y | 2 | |
+| stac_month_cls_code | 결산 월 구분 코드 | string | Y | 2 | |
+| iqry_csnu | 조회 건수 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20175",
+"fid_input_iscd":"0000",
+"fid_div_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_input_option_1":"2023",
+"fid_input_option_2":"3",
+"fid_rank_sort_cls_code":"7",
+"fid_blng_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_trgt_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "data_rank": "1",
+ "hts_kor_isnm": "한진칼",
+ "mksc_shrn_iscd": "180640",
+ "stck_prpr": "59500",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.68",
+ "acml_vol": "46057",
+ "cptl_op_prfi": "177.14",
+ "cptl_ntin_rate": "12.41",
+ "sale_totl_rate": "51.17",
+ "sale_ntin_rate": "177.14",
+ "bis": "75.41",
+ "lblt_rate": "32.61",
+ "bram_depn": "16.29",
+ "rsrv_rate": "1583.70",
+ "grs": "43.44",
+ "op_prfi_inrt": "13.31",
+ "bsop_prfi_inrt": "259.13",
+ "ntin_inrt": "-52.67",
+ "equt_inrt": "17.84",
+ "cptl_tnrt": "0.10",
+ "sale_bond_tnrt": "10.18",
+ "totl_aset_inrt": "1.39",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "2",
+ "hts_kor_isnm": "한미반도체",
+ "mksc_shrn_iscd": "042700",
+ "stck_prpr": "97500",
+ "prdy_vrss": "1300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.35",
+ "acml_vol": "319052",
+ "cptl_op_prfi": "170.24",
+ "cptl_ntin_rate": "44.40",
+ "sale_totl_rate": "45.81",
+ "sale_ntin_rate": "170.24",
+ "bis": "87.56",
+ "lblt_rate": "14.20",
+ "bram_depn": "0.22",
+ "rsrv_rate": "4282.44",
+ "grs": "-59.96",
+ "op_prfi_inrt": "85.51",
+ "bsop_prfi_inrt": "-83.40",
+ "ntin_inrt": "91.05",
+ "equt_inrt": "41.88",
+ "cptl_tnrt": "0.30",
+ "sale_bond_tnrt": "2.32",
+ "totl_aset_inrt": "34.34",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "3",
+ "hts_kor_isnm": "한라IMS",
+ "mksc_shrn_iscd": "092460",
+ "stck_prpr": "6000",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.84",
+ "acml_vol": "6707",
+ "cptl_op_prfi": "115.30",
+ "cptl_ntin_rate": "45.59",
+ "sale_totl_rate": "35.14",
+ "sale_ntin_rate": "115.30",
+ "bis": "73.41",
+ "lblt_rate": "36.21",
+ "bram_depn": "11.43",
+ "rsrv_rate": "1769.56",
+ "grs": "-15.09",
+ "op_prfi_inrt": "799.56",
+ "bsop_prfi_inrt": "-56.41",
+ "ntin_inrt": "722.02",
+ "equt_inrt": "66.58",
+ "cptl_tnrt": "0.61",
+ "sale_bond_tnrt": "15.19",
+ "totl_aset_inrt": "20.84",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "4",
+ "hts_kor_isnm": "엘앤씨바이오",
+ "mksc_shrn_iscd": "290650",
+ "stck_prpr": "23600",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.72",
+ "acml_vol": "23299",
+ "cptl_op_prfi": "99.18",
+ "cptl_ntin_rate": "29.41",
+ "sale_totl_rate": "52.81",
+ "sale_ntin_rate": "99.18",
+ "bis": "59.42",
+ "lblt_rate": "68.28",
+ "bram_depn": "30.27",
+ "rsrv_rate": "1254.06",
+ "grs": "40.39",
+ "op_prfi_inrt": "1621.06",
+ "bsop_prfi_inrt": "32.30",
+ "ntin_inrt": "1616.82",
+ "equt_inrt": "51.74",
+ "cptl_tnrt": "0.52",
+ "sale_bond_tnrt": "4.22",
+ "totl_aset_inrt": "36.35",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "5",
+ "hts_kor_isnm": "LX홀딩스",
+ "mksc_shrn_iscd": "383800",
+ "stck_prpr": "6960",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.57",
+ "acml_vol": "43462",
+ "cptl_op_prfi": "71.39",
+ "cptl_ntin_rate": "6.68",
+ "sale_totl_rate": "94.96",
+ "sale_ntin_rate": "71.39",
+ "bis": "97.97",
+ "lblt_rate": "2.07",
+ "bram_depn": "0.04",
+ "rsrv_rate": "2078.39",
+ "grs": "-49.15",
+ "op_prfi_inrt": "-54.13",
+ "bsop_prfi_inrt": "-56.95",
+ "ntin_inrt": "-55.41",
+ "equt_inrt": "0.00",
+ "cptl_tnrt": "0.10",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "6",
+ "hts_kor_isnm": "남화산업",
+ "mksc_shrn_iscd": "111710",
+ "stck_prpr": "5550",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.25",
+ "acml_vol": "6167",
+ "cptl_op_prfi": "67.83",
+ "cptl_ntin_rate": "11.81",
+ "sale_totl_rate": "100.00",
+ "sale_ntin_rate": "67.83",
+ "bis": "92.25",
+ "lblt_rate": "8.40",
+ "bram_depn": "0.00",
+ "rsrv_rate": "3992.60",
+ "grs": "17.54",
+ "op_prfi_inrt": "39.10",
+ "bsop_prfi_inrt": "28.15",
+ "ntin_inrt": "50.28",
+ "equt_inrt": "10.96",
+ "cptl_tnrt": "0.19",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "9.40",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "7",
+ "hts_kor_isnm": "한국자산신탁",
+ "mksc_shrn_iscd": "123890",
+ "stck_prpr": "3435",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.15",
+ "acml_vol": "114745",
+ "cptl_op_prfi": "58.16",
+ "cptl_ntin_rate": "10.28",
+ "sale_totl_rate": "69.89",
+ "sale_ntin_rate": "58.16",
+ "bis": "69.40",
+ "lblt_rate": "44.10",
+ "bram_depn": "23.44",
+ "rsrv_rate": "1556.75",
+ "grs": "9.52",
+ "op_prfi_inrt": "24.86",
+ "bsop_prfi_inrt": "-20.40",
+ "ntin_inrt": "26.18",
+ "equt_inrt": "11.47",
+ "cptl_tnrt": "0.26",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "8.51",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "8",
+ "hts_kor_isnm": "현대지에프홀딩스",
+ "mksc_shrn_iscd": "005440",
+ "stck_prpr": "4190",
+ "prdy_vrss": "85",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.07",
+ "acml_vol": "119703",
+ "cptl_op_prfi": "57.82",
+ "cptl_ntin_rate": "32.87",
+ "sale_totl_rate": "16.24",
+ "sale_ntin_rate": "63.46",
+ "bis": "69.32",
+ "lblt_rate": "44.25",
+ "bram_depn": "7.16",
+ "rsrv_rate": "3097.52",
+ "grs": "7.28",
+ "op_prfi_inrt": "1767.95",
+ "bsop_prfi_inrt": "152.41",
+ "ntin_inrt": "957.30",
+ "equt_inrt": "46.84",
+ "cptl_tnrt": "0.75",
+ "sale_bond_tnrt": "3.42",
+ "totl_aset_inrt": "46.43",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "9",
+ "hts_kor_isnm": "HB솔루션",
+ "mksc_shrn_iscd": "297890",
+ "stck_prpr": "4395",
+ "prdy_vrss": "240",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.78",
+ "acml_vol": "4360947",
+ "cptl_op_prfi": "56.59",
+ "cptl_ntin_rate": "26.88",
+ "sale_totl_rate": "26.37",
+ "sale_ntin_rate": "56.59",
+ "bis": "76.96",
+ "lblt_rate": "29.94",
+ "bram_depn": "9.95",
+ "rsrv_rate": "483.05",
+ "grs": "-40.05",
+ "op_prfi_inrt": "87.41",
+ "bsop_prfi_inrt": "-53.78",
+ "ntin_inrt": "57.18",
+ "equt_inrt": "56.07",
+ "cptl_tnrt": "0.66",
+ "sale_bond_tnrt": "9.13",
+ "totl_aset_inrt": "31.92",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "10",
+ "hts_kor_isnm": "액토즈소프트",
+ "mksc_shrn_iscd": "052790",
+ "stck_prpr": "9200",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.32",
+ "acml_vol": "11322",
+ "cptl_op_prfi": "52.47",
+ "cptl_ntin_rate": "13.07",
+ "sale_totl_rate": "85.52",
+ "sale_ntin_rate": "52.47",
+ "bis": "67.95",
+ "lblt_rate": "47.16",
+ "bram_depn": "1.56",
+ "rsrv_rate": "4140.61",
+ "grs": "35.08",
+ "op_prfi_inrt": "173.49",
+ "bsop_prfi_inrt": "50.33",
+ "ntin_inrt": "339.23",
+ "equt_inrt": "4.24",
+ "cptl_tnrt": "0.38",
+ "sale_bond_tnrt": "1.69",
+ "totl_aset_inrt": "-0.86",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "11",
+ "hts_kor_isnm": "비올",
+ "mksc_shrn_iscd": "335890",
+ "stck_prpr": "9000",
+ "prdy_vrss": "-220",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.39",
+ "acml_vol": "2021224",
+ "cptl_op_prfi": "50.71",
+ "cptl_ntin_rate": "39.77",
+ "sale_totl_rate": "77.77",
+ "sale_ntin_rate": "50.71",
+ "bis": "89.42",
+ "lblt_rate": "11.83",
+ "bram_depn": "1.02",
+ "rsrv_rate": "930.70",
+ "grs": "36.69",
+ "op_prfi_inrt": "89.29",
+ "bsop_prfi_inrt": "72.80",
+ "ntin_inrt": "87.93",
+ "equt_inrt": "46.71",
+ "cptl_tnrt": "0.89",
+ "sale_bond_tnrt": "9.93",
+ "totl_aset_inrt": "43.43",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "12",
+ "hts_kor_isnm": "케어젠",
+ "mksc_shrn_iscd": "214370",
+ "stck_prpr": "24250",
+ "prdy_vrss": "300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.25",
+ "acml_vol": "92291",
+ "cptl_op_prfi": "50.41",
+ "cptl_ntin_rate": "16.59",
+ "sale_totl_rate": "73.68",
+ "sale_ntin_rate": "50.41",
+ "bis": "91.92",
+ "lblt_rate": "8.79",
+ "bram_depn": "0.00",
+ "rsrv_rate": "5382.82",
+ "grs": "14.63",
+ "op_prfi_inrt": "43.87",
+ "bsop_prfi_inrt": "20.08",
+ "ntin_inrt": "46.71",
+ "equt_inrt": "5.24",
+ "cptl_tnrt": "0.36",
+ "sale_bond_tnrt": "7.88",
+ "totl_aset_inrt": "5.64",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "13",
+ "hts_kor_isnm": "캡스톤파트너스",
+ "mksc_shrn_iscd": "452300",
+ "stck_prpr": "4840",
+ "prdy_vrss": "470",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "10.76",
+ "acml_vol": "929728",
+ "cptl_op_prfi": "50.13",
+ "cptl_ntin_rate": "20.74",
+ "sale_totl_rate": "90.77",
+ "sale_ntin_rate": "50.13",
+ "bis": "62.63",
+ "lblt_rate": "59.66",
+ "bram_depn": "25.63",
+ "rsrv_rate": "867.77",
+ "grs": "-15.09",
+ "op_prfi_inrt": "13.50",
+ "bsop_prfi_inrt": "-7.40",
+ "ntin_inrt": "8.21",
+ "equt_inrt": "40.76",
+ "cptl_tnrt": "0.68",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "33.35",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "14",
+ "hts_kor_isnm": "HB인베스트먼트",
+ "mksc_shrn_iscd": "440290",
+ "stck_prpr": "3215",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "26774",
+ "cptl_op_prfi": "46.91",
+ "cptl_ntin_rate": "15.32",
+ "sale_totl_rate": "90.90",
+ "sale_ntin_rate": "46.91",
+ "bis": "90.89",
+ "lblt_rate": "10.03",
+ "bram_depn": "0.00",
+ "rsrv_rate": "388.81",
+ "grs": "39.39",
+ "op_prfi_inrt": "19.39",
+ "bsop_prfi_inrt": "19.53",
+ "ntin_inrt": "22.90",
+ "equt_inrt": "20.05",
+ "cptl_tnrt": "0.36",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "22.87",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "15",
+ "hts_kor_isnm": "클래시스",
+ "mksc_shrn_iscd": "214150",
+ "stck_prpr": "34650",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "73547",
+ "cptl_op_prfi": "43.97",
+ "cptl_ntin_rate": "22.47",
+ "sale_totl_rate": "77.78",
+ "sale_ntin_rate": "43.97",
+ "bis": "74.68",
+ "lblt_rate": "33.91",
+ "bram_depn": "18.35",
+ "rsrv_rate": "4332.41",
+ "grs": "31.36",
+ "op_prfi_inrt": "34.19",
+ "bsop_prfi_inrt": "36.92",
+ "ntin_inrt": "29.08",
+ "equt_inrt": "34.41",
+ "cptl_tnrt": "0.71",
+ "sale_bond_tnrt": "15.34",
+ "totl_aset_inrt": "8.62",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "16",
+ "hts_kor_isnm": "코엔텍",
+ "mksc_shrn_iscd": "029960",
+ "stck_prpr": "6830",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.58",
+ "acml_vol": "14290",
+ "cptl_op_prfi": "43.84",
+ "cptl_ntin_rate": "19.67",
+ "sale_totl_rate": "58.73",
+ "sale_ntin_rate": "43.84",
+ "bis": "81.88",
+ "lblt_rate": "22.13",
+ "bram_depn": "5.39",
+ "rsrv_rate": "622.42",
+ "grs": "21.85",
+ "op_prfi_inrt": "34.98",
+ "bsop_prfi_inrt": "32.27",
+ "ntin_inrt": "33.51",
+ "equt_inrt": "9.68",
+ "cptl_tnrt": "0.55",
+ "sale_bond_tnrt": "9.00",
+ "totl_aset_inrt": "7.26",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "17",
+ "hts_kor_isnm": "폴라리스오피스",
+ "mksc_shrn_iscd": "041020",
+ "stck_prpr": "7150",
+ "prdy_vrss": "-60",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.83",
+ "acml_vol": "560557",
+ "cptl_op_prfi": "43.82",
+ "cptl_ntin_rate": "18.08",
+ "sale_totl_rate": "39.36",
+ "sale_ntin_rate": "43.82",
+ "bis": "81.59",
+ "lblt_rate": "22.57",
+ "bram_depn": "4.04",
+ "rsrv_rate": "247.49",
+ "grs": "254.29",
+ "op_prfi_inrt": "125.32",
+ "bsop_prfi_inrt": "221.82",
+ "ntin_inrt": "116.06",
+ "equt_inrt": "331.24",
+ "cptl_tnrt": "0.50",
+ "sale_bond_tnrt": "4.79",
+ "totl_aset_inrt": "375.94",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "18",
+ "hts_kor_isnm": "바이오플러스",
+ "mksc_shrn_iscd": "099430",
+ "stck_prpr": "6810",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "54755",
+ "cptl_op_prfi": "41.60",
+ "cptl_ntin_rate": "17.49",
+ "sale_totl_rate": "60.54",
+ "sale_ntin_rate": "41.60",
+ "bis": "79.41",
+ "lblt_rate": "25.92",
+ "bram_depn": "4.46",
+ "rsrv_rate": "336.08",
+ "grs": "21.50",
+ "op_prfi_inrt": "28.55",
+ "bsop_prfi_inrt": "16.99",
+ "ntin_inrt": "36.82",
+ "equt_inrt": "18.57",
+ "cptl_tnrt": "0.53",
+ "sale_bond_tnrt": "3.47",
+ "totl_aset_inrt": "39.69",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "19",
+ "hts_kor_isnm": "HPSP",
+ "mksc_shrn_iscd": "403870",
+ "stck_prpr": "52800",
+ "prdy_vrss": "600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.15",
+ "acml_vol": "224631",
+ "cptl_op_prfi": "41.43",
+ "cptl_ntin_rate": "37.44",
+ "sale_totl_rate": "69.10",
+ "sale_ntin_rate": "41.43",
+ "bis": "74.88",
+ "lblt_rate": "33.55",
+ "bram_depn": "1.17",
+ "rsrv_rate": "1825.82",
+ "grs": "73.66",
+ "op_prfi_inrt": "86.18",
+ "bsop_prfi_inrt": "88.39",
+ "ntin_inrt": "86.75",
+ "equt_inrt": "270.38",
+ "cptl_tnrt": "1.28",
+ "sale_bond_tnrt": "41.66",
+ "totl_aset_inrt": "184.79",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "20",
+ "hts_kor_isnm": "컴퍼니케이",
+ "mksc_shrn_iscd": "307930",
+ "stck_prpr": "8030",
+ "prdy_vrss": "-60",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.74",
+ "acml_vol": "209397",
+ "cptl_op_prfi": "40.84",
+ "cptl_ntin_rate": "7.52",
+ "sale_totl_rate": "71.06",
+ "sale_ntin_rate": "40.84",
+ "bis": "89.16",
+ "lblt_rate": "12.16",
+ "bram_depn": "6.37",
+ "rsrv_rate": "692.91",
+ "grs": "-42.27",
+ "op_prfi_inrt": "-71.04",
+ "bsop_prfi_inrt": "-70.37",
+ "ntin_inrt": "-65.74",
+ "equt_inrt": "3.96",
+ "cptl_tnrt": "0.21",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "1.62",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "21",
+ "hts_kor_isnm": "피에스케이홀딩스",
+ "mksc_shrn_iscd": "031980",
+ "stck_prpr": "41050",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "72338",
+ "cptl_op_prfi": "39.98",
+ "cptl_ntin_rate": "8.26",
+ "sale_totl_rate": "58.99",
+ "sale_ntin_rate": "39.98",
+ "bis": "84.33",
+ "lblt_rate": "18.58",
+ "bram_depn": "5.18",
+ "rsrv_rate": "2906.96",
+ "grs": "33.25",
+ "op_prfi_inrt": "-0.40",
+ "bsop_prfi_inrt": "81.06",
+ "ntin_inrt": "-5.79",
+ "equt_inrt": "20.21",
+ "cptl_tnrt": "0.24",
+ "sale_bond_tnrt": "8.37",
+ "totl_aset_inrt": "15.97",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "22",
+ "hts_kor_isnm": "린드먼아시아",
+ "mksc_shrn_iscd": "277070",
+ "stck_prpr": "5920",
+ "prdy_vrss": "-110",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.82",
+ "acml_vol": "10616",
+ "cptl_op_prfi": "39.24",
+ "cptl_ntin_rate": "3.86",
+ "sale_totl_rate": "88.54",
+ "sale_ntin_rate": "39.24",
+ "bis": "85.69",
+ "lblt_rate": "16.70",
+ "bram_depn": "0.00",
+ "rsrv_rate": "778.36",
+ "grs": "-38.51",
+ "op_prfi_inrt": "-55.32",
+ "bsop_prfi_inrt": "-56.61",
+ "ntin_inrt": "-51.01",
+ "equt_inrt": "1.44",
+ "cptl_tnrt": "0.12",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "0.79",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "23",
+ "hts_kor_isnm": "인포바인",
+ "mksc_shrn_iscd": "115310",
+ "stck_prpr": "22150",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.89",
+ "acml_vol": "631",
+ "cptl_op_prfi": "38.66",
+ "cptl_ntin_rate": "7.68",
+ "sale_totl_rate": "100.00",
+ "sale_ntin_rate": "38.66",
+ "bis": "92.45",
+ "lblt_rate": "8.17",
+ "bram_depn": "0.00",
+ "rsrv_rate": "8316.36",
+ "grs": "8.90",
+ "op_prfi_inrt": "25.12",
+ "bsop_prfi_inrt": "14.40",
+ "ntin_inrt": "25.51",
+ "equt_inrt": "7.80",
+ "cptl_tnrt": "0.21",
+ "sale_bond_tnrt": "6.74",
+ "totl_aset_inrt": "7.94",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "24",
+ "hts_kor_isnm": "제놀루션",
+ "mksc_shrn_iscd": "225220",
+ "stck_prpr": "3865",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.26",
+ "acml_vol": "8931",
+ "cptl_op_prfi": "38.34",
+ "cptl_ntin_rate": "13.95",
+ "sale_totl_rate": "69.20",
+ "sale_ntin_rate": "38.34",
+ "bis": "82.74",
+ "lblt_rate": "20.86",
+ "bram_depn": "14.75",
+ "rsrv_rate": "2070.62",
+ "grs": "-47.71",
+ "op_prfi_inrt": "-60.40",
+ "bsop_prfi_inrt": "-64.30",
+ "ntin_inrt": "-57.55",
+ "equt_inrt": "15.20",
+ "cptl_tnrt": "0.43",
+ "sale_bond_tnrt": "7.55",
+ "totl_aset_inrt": "20.55",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "25",
+ "hts_kor_isnm": "스틱인베스트먼트",
+ "mksc_shrn_iscd": "026890",
+ "stck_prpr": "7310",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "42011",
+ "cptl_op_prfi": "37.72",
+ "cptl_ntin_rate": "9.19",
+ "sale_totl_rate": "95.87",
+ "sale_ntin_rate": "37.72",
+ "bis": "92.91",
+ "lblt_rate": "7.63",
+ "bram_depn": "0.00",
+ "rsrv_rate": "1156.76",
+ "grs": "-5.22",
+ "op_prfi_inrt": "65.18",
+ "bsop_prfi_inrt": "38.47",
+ "ntin_inrt": "-6.51",
+ "equt_inrt": "3.14",
+ "cptl_tnrt": "0.26",
+ "sale_bond_tnrt": "0.00",
+ "totl_aset_inrt": "-0.15",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "26",
+ "hts_kor_isnm": "SG&G",
+ "mksc_shrn_iscd": "040610",
+ "stck_prpr": "1690",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.59",
+ "acml_vol": "78652",
+ "cptl_op_prfi": "37.65",
+ "cptl_ntin_rate": "3.79",
+ "sale_totl_rate": "10.17",
+ "sale_ntin_rate": "37.65",
+ "bis": "83.63",
+ "lblt_rate": "19.57",
+ "bram_depn": "10.94",
+ "rsrv_rate": "1802.44",
+ "grs": "-9.37",
+ "op_prfi_inrt": "-26.36",
+ "bsop_prfi_inrt": "-21.22",
+ "ntin_inrt": "-17.25",
+ "equt_inrt": "10.68",
+ "cptl_tnrt": "0.12",
+ "sale_bond_tnrt": "6.31",
+ "totl_aset_inrt": "1.69",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "27",
+ "hts_kor_isnm": "선바이오",
+ "mksc_shrn_iscd": "067370",
+ "stck_prpr": "8860",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.11",
+ "acml_vol": "9474",
+ "cptl_op_prfi": "37.48",
+ "cptl_ntin_rate": "10.17",
+ "sale_totl_rate": "70.26",
+ "sale_ntin_rate": "37.48",
+ "bis": "58.97",
+ "lblt_rate": "69.59",
+ "bram_depn": "34.57",
+ "rsrv_rate": "360.22",
+ "grs": "65.65",
+ "op_prfi_inrt": "492.04",
+ "bsop_prfi_inrt": "2619.78",
+ "ntin_inrt": "429.92",
+ "equt_inrt": "17.90",
+ "cptl_tnrt": "0.47",
+ "sale_bond_tnrt": "2.98",
+ "totl_aset_inrt": "11.11",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "28",
+ "hts_kor_isnm": "넥스틴",
+ "mksc_shrn_iscd": "348210",
+ "stck_prpr": "71400",
+ "prdy_vrss": "600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.85",
+ "acml_vol": "20944",
+ "cptl_op_prfi": "37.13",
+ "cptl_ntin_rate": "25.40",
+ "sale_totl_rate": "70.61",
+ "sale_ntin_rate": "37.13",
+ "bis": "83.18",
+ "lblt_rate": "20.21",
+ "bram_depn": "1.18",
+ "rsrv_rate": "2409.86",
+ "grs": "-26.81",
+ "op_prfi_inrt": "-38.52",
+ "bsop_prfi_inrt": "-37.71",
+ "ntin_inrt": "-36.78",
+ "equt_inrt": "26.57",
+ "cptl_tnrt": "0.83",
+ "sale_bond_tnrt": "8.40",
+ "totl_aset_inrt": "18.22",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "29",
+ "hts_kor_isnm": "인지소프트",
+ "mksc_shrn_iscd": "100030",
+ "stck_prpr": "18730",
+ "prdy_vrss": "-170",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.90",
+ "acml_vol": "264",
+ "cptl_op_prfi": "36.63",
+ "cptl_ntin_rate": "13.91",
+ "sale_totl_rate": "41.78",
+ "sale_ntin_rate": "36.63",
+ "bis": "86.72",
+ "lblt_rate": "15.32",
+ "bram_depn": "2.89",
+ "rsrv_rate": "3548.32",
+ "grs": "6.75",
+ "op_prfi_inrt": "-38.13",
+ "bsop_prfi_inrt": "-21.98",
+ "ntin_inrt": "-38.07",
+ "equt_inrt": "-5.06",
+ "cptl_tnrt": "0.45",
+ "sale_bond_tnrt": "17.55",
+ "totl_aset_inrt": "-7.15",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ },
+ {
+ "data_rank": "30",
+ "hts_kor_isnm": "티케이케미칼",
+ "mksc_shrn_iscd": "104480",
+ "stck_prpr": "1685",
+ "prdy_vrss": "3",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.18",
+ "acml_vol": "26105",
+ "cptl_op_prfi": "36.53",
+ "cptl_ntin_rate": "21.33",
+ "sale_totl_rate": "4.15",
+ "sale_ntin_rate": "36.53",
+ "bis": "66.22",
+ "lblt_rate": "51.01",
+ "bram_depn": "16.52",
+ "rsrv_rate": "1985.76",
+ "grs": "8.57",
+ "op_prfi_inrt": "-25.90",
+ "bsop_prfi_inrt": "-99.28",
+ "ntin_inrt": "-21.55",
+ "equt_inrt": "41.94",
+ "cptl_tnrt": "0.93",
+ "sale_bond_tnrt": "13.54",
+ "totl_aset_inrt": "24.61",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1283"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/154_v1_국내주식-091_국내주식-시가총액-상위.md b/docs/broker/kis/rest/국내주식/순위분석/154_v1_국내주식-091_국내주식-시가총액-상위.md
new file mode 100644
index 0000000..a8cdd2d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/154_v1_국내주식-091_국내주식-시가총액-상위.md
@@ -0,0 +1,507 @@
+# 국내주식 시가총액 상위
+
+- 원본 시트명: 국내주식 시가총액 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-091
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01740000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/market-cap
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시가총액 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0174] 시가총액 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01740000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20174 ) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 전체, 1:보통주, 2:우선주 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| lstn_stcn | 상장 주수 | string | Y | 18 | |
+| stck_avls | 시가 총액 | string | Y | 18 | |
+| mrkt_whol_avls_rlim | 시장 전체 시가총액 비중 | string | Y | 52 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20174",
+"fid_div_cls_code":"0",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0"
+"fid_trgt_exls_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "005930",
+ "data_rank": "1",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "72700",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.55",
+ "acml_vol": "3686661",
+ "lstn_stcn": "5969782550",
+ "stck_avls": "4340032",
+ "mrkt_whol_avls_rlim": "15.77"
+ },
+ {
+ "mksc_shrn_iscd": "000660",
+ "data_rank": "2",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "162300",
+ "prdy_vrss": "1100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.68",
+ "acml_vol": "807093",
+ "lstn_stcn": "728002365",
+ "stck_avls": "1181548",
+ "mrkt_whol_avls_rlim": "4.29"
+ },
+ {
+ "mksc_shrn_iscd": "373220",
+ "data_rank": "3",
+ "hts_kor_isnm": "LG에너지솔루션",
+ "stck_prpr": "404000",
+ "prdy_vrss": "5500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.38",
+ "acml_vol": "43109",
+ "lstn_stcn": "234000000",
+ "stck_avls": "945360",
+ "mrkt_whol_avls_rlim": "3.43"
+ },
+ {
+ "mksc_shrn_iscd": "207940",
+ "data_rank": "4",
+ "hts_kor_isnm": "삼성바이오로직스",
+ "stck_prpr": "863000",
+ "prdy_vrss": "37000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.48",
+ "acml_vol": "95134",
+ "lstn_stcn": "71174000",
+ "stck_avls": "614232",
+ "mrkt_whol_avls_rlim": "2.23"
+ },
+ {
+ "mksc_shrn_iscd": "005380",
+ "data_rank": "5",
+ "hts_kor_isnm": "현대차",
+ "stck_prpr": "246500",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.23",
+ "acml_vol": "264371",
+ "lstn_stcn": "211531506",
+ "stck_avls": "521425",
+ "mrkt_whol_avls_rlim": "1.89"
+ },
+ {
+ "mksc_shrn_iscd": "005935",
+ "data_rank": "6",
+ "hts_kor_isnm": "삼성전자우",
+ "stck_prpr": "62500",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.81",
+ "acml_vol": "198907",
+ "lstn_stcn": "822886700",
+ "stck_avls": "514304",
+ "mrkt_whol_avls_rlim": "1.87"
+ },
+ {
+ "mksc_shrn_iscd": "000270",
+ "data_rank": "7",
+ "hts_kor_isnm": "기아",
+ "stck_prpr": "127400",
+ "prdy_vrss": "2400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.92",
+ "acml_vol": "505817",
+ "lstn_stcn": "402044203",
+ "stck_avls": "512204",
+ "mrkt_whol_avls_rlim": "1.86"
+ },
+ {
+ "mksc_shrn_iscd": "068270",
+ "data_rank": "8",
+ "hts_kor_isnm": "셀트리온",
+ "stck_prpr": "182000",
+ "prdy_vrss": "1200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.66",
+ "acml_vol": "247817",
+ "lstn_stcn": "218049762",
+ "stck_avls": "396851",
+ "mrkt_whol_avls_rlim": "1.44"
+ },
+ {
+ "mksc_shrn_iscd": "005490",
+ "data_rank": "9",
+ "hts_kor_isnm": "POSCO홀딩스",
+ "stck_prpr": "437000",
+ "prdy_vrss": "2000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.46",
+ "acml_vol": "154280",
+ "lstn_stcn": "84571230",
+ "stck_avls": "369576",
+ "mrkt_whol_avls_rlim": "1.34"
+ },
+ {
+ "mksc_shrn_iscd": "051910",
+ "data_rank": "10",
+ "hts_kor_isnm": "LG화학",
+ "stck_prpr": "438500",
+ "prdy_vrss": "7500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.74",
+ "acml_vol": "66555",
+ "lstn_stcn": "70592343",
+ "stck_avls": "309547",
+ "mrkt_whol_avls_rlim": "1.12"
+ },
+ {
+ "mksc_shrn_iscd": "006400",
+ "data_rank": "11",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "438000",
+ "prdy_vrss": "13000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.06",
+ "acml_vol": "227802",
+ "lstn_stcn": "68764530",
+ "stck_avls": "301189",
+ "mrkt_whol_avls_rlim": "1.09"
+ },
+ {
+ "mksc_shrn_iscd": "035420",
+ "data_rank": "12",
+ "hts_kor_isnm": "NAVER",
+ "stck_prpr": "184500",
+ "prdy_vrss": "-1600",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.86",
+ "acml_vol": "338579",
+ "lstn_stcn": "162408594",
+ "stck_avls": "299644",
+ "mrkt_whol_avls_rlim": "1.09"
+ },
+ {
+ "mksc_shrn_iscd": "105560",
+ "data_rank": "13",
+ "hts_kor_isnm": "KB금융",
+ "stck_prpr": "73000",
+ "prdy_vrss": "-3200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.20",
+ "acml_vol": "999671",
+ "lstn_stcn": "403511072",
+ "stck_avls": "294563",
+ "mrkt_whol_avls_rlim": "1.07"
+ },
+ {
+ "mksc_shrn_iscd": "028260",
+ "data_rank": "14",
+ "hts_kor_isnm": "삼성물산",
+ "stck_prpr": "150900",
+ "prdy_vrss": "-3200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.08",
+ "acml_vol": "281612",
+ "lstn_stcn": "185591670",
+ "stck_avls": "280058",
+ "mrkt_whol_avls_rlim": "1.02"
+ },
+ {
+ "mksc_shrn_iscd": "247540",
+ "data_rank": "15",
+ "hts_kor_isnm": "에코프로비엠",
+ "stck_prpr": "265500",
+ "prdy_vrss": "9000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.51",
+ "acml_vol": "305799",
+ "lstn_stcn": "97801344",
+ "stck_avls": "259663",
+ "mrkt_whol_avls_rlim": "0.94"
+ },
+ {
+ "mksc_shrn_iscd": "012330",
+ "data_rank": "16",
+ "hts_kor_isnm": "현대모비스",
+ "stck_prpr": "269500",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.19",
+ "acml_vol": "78633",
+ "lstn_stcn": "93655094",
+ "stck_avls": "252400",
+ "mrkt_whol_avls_rlim": "0.92"
+ },
+ {
+ "mksc_shrn_iscd": "055550",
+ "data_rank": "17",
+ "hts_kor_isnm": "신한지주",
+ "stck_prpr": "48650",
+ "prdy_vrss": "-950",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.92",
+ "acml_vol": "910139",
+ "lstn_stcn": "512759471",
+ "stck_avls": "249457",
+ "mrkt_whol_avls_rlim": "0.91"
+ },
+ {
+ "mksc_shrn_iscd": "003670",
+ "data_rank": "18",
+ "hts_kor_isnm": "포스코퓨처엠",
+ "stck_prpr": "319500",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.95",
+ "acml_vol": "105628",
+ "lstn_stcn": "77463220",
+ "stck_avls": "247495",
+ "mrkt_whol_avls_rlim": "0.90"
+ },
+ {
+ "mksc_shrn_iscd": "035720",
+ "data_rank": "19",
+ "hts_kor_isnm": "카카오",
+ "stck_prpr": "53400",
+ "prdy_vrss": "-700",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.29",
+ "acml_vol": "370679",
+ "lstn_stcn": "445153350",
+ "stck_avls": "237712",
+ "mrkt_whol_avls_rlim": "0.86"
+ },
+ {
+ "mksc_shrn_iscd": "032830",
+ "data_rank": "20",
+ "hts_kor_isnm": "삼성생명",
+ "stck_prpr": "95900",
+ "prdy_vrss": "-3200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.23",
+ "acml_vol": "234134",
+ "lstn_stcn": "200000000",
+ "stck_avls": "191800",
+ "mrkt_whol_avls_rlim": "0.70"
+ },
+ {
+ "mksc_shrn_iscd": "086790",
+ "data_rank": "21",
+ "hts_kor_isnm": "하나금융지주",
+ "stck_prpr": "61600",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.81",
+ "acml_vol": "731438",
+ "lstn_stcn": "292356598",
+ "stck_avls": "180092",
+ "mrkt_whol_avls_rlim": "0.65"
+ },
+ {
+ "mksc_shrn_iscd": "138040",
+ "data_rank": "22",
+ "hts_kor_isnm": "메리츠금융지주",
+ "stck_prpr": "83100",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.12",
+ "acml_vol": "182179",
+ "lstn_stcn": "203372114",
+ "stck_avls": "169002",
+ "mrkt_whol_avls_rlim": "0.61"
+ },
+ {
+ "mksc_shrn_iscd": "086520",
+ "data_rank": "23",
+ "hts_kor_isnm": "에코프로",
+ "stck_prpr": "609000",
+ "prdy_vrss": "8000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.33",
+ "acml_vol": "64629",
+ "lstn_stcn": "26627668",
+ "stck_avls": "162162",
+ "mrkt_whol_avls_rlim": "0.59"
+ },
+ {
+ "mksc_shrn_iscd": "066570",
+ "data_rank": "24",
+ "hts_kor_isnm": "LG전자",
+ "stck_prpr": "97900",
+ "prdy_vrss": "-1000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.01",
+ "acml_vol": "123965",
+ "lstn_stcn": "163647814",
+ "stck_avls": "160211",
+ "mrkt_whol_avls_rlim": "0.58"
+ },
+ {
+ "mksc_shrn_iscd": "015760",
+ "data_rank": "25",
+ "hts_kor_isnm": "한국전력",
+ "stck_prpr": "24500",
+ "prdy_vrss": "-350",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.41",
+ "acml_vol": "736259",
+ "lstn_stcn": "641964077",
+ "stck_avls": "157281",
+ "mrkt_whol_avls_rlim": "0.57"
+ },
+ {
+ "mksc_shrn_iscd": "000810",
+ "data_rank": "26",
+ "hts_kor_isnm": "삼성화재",
+ "stck_prpr": "307000",
+ "prdy_vrss": "-2500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.81",
+ "acml_vol": "38909",
+ "lstn_stcn": "47374837",
+ "stck_avls": "145441",
+ "mrkt_whol_avls_rlim": "0.53"
+ },
+ {
+ "mksc_shrn_iscd": "003550",
+ "data_rank": "27",
+ "hts_kor_isnm": "LG",
+ "stck_prpr": "90100",
+ "prdy_vrss": "-4800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.06",
+ "acml_vol": "232801",
+ "lstn_stcn": "157300993",
+ "stck_avls": "141728",
+ "mrkt_whol_avls_rlim": "0.51"
+ },
+ {
+ "mksc_shrn_iscd": "034730",
+ "data_rank": "28",
+ "hts_kor_isnm": "SK",
+ "stck_prpr": "185000",
+ "prdy_vrss": "-2300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.23",
+ "acml_vol": "31241",
+ "lstn_stcn": "73198329",
+ "stck_avls": "135417",
+ "mrkt_whol_avls_rlim": "0.49"
+ },
+ {
+ "mksc_shrn_iscd": "323410",
+ "data_rank": "29",
+ "hts_kor_isnm": "카카오뱅크",
+ "stck_prpr": "28100",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.06",
+ "acml_vol": "289825",
+ "lstn_stcn": "476916137",
+ "stck_avls": "134013",
+ "mrkt_whol_avls_rlim": "0.49"
+ },
+ {
+ "mksc_shrn_iscd": "028300",
+ "data_rank": "30",
+ "hts_kor_isnm": "HLB",
+ "stck_prpr": "101900",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.49",
+ "acml_vol": "595180",
+ "lstn_stcn": "130812041",
+ "stck_avls": "133297",
+ "mrkt_whol_avls_rlim": "0.48"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/155_v1_국내주식-104_국내주식-당사매매종목-상위.md b/docs/broker/kis/rest/국내주식/순위분석/155_v1_국내주식-104_국내주식-당사매매종목-상위.md
new file mode 100644
index 0000000..c41a815
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/155_v1_국내주식-104_국내주식-당사매매종목-상위.md
@@ -0,0 +1,544 @@
+# 국내주식 당사매매종목 상위
+
+- 원본 시트명: 국내주식 당사매매종목 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-104
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01860000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/traded-by-company
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 당사매매종목 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0186] 당사매매종목 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01860000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0: 전체 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20186) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보통주, 7:우선주 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:매도상위,1:매수상위 |
+| fid_input_date_1 | 입력 날짜1 | string | Y | 10 | 기간~ |
+| fid_input_date_2 | 입력 날짜2 | string | Y | 10 | ~기간 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0: 전체 |
+| fid_aply_rang_vol | 적용 범위 거래량 | string | Y | 18 | 0: 전체, 100: 100주 이상 |
+| fid_aply_rang_prc_2 | 적용 범위 가격2 | string | Y | 18 | ~ 가격 |
+| fid_aply_rang_prc_1 | 적용 범위 가격1 | string | Y | 18 | 가격 ~ |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| seln_cnqn_smtn | 매도 체결량 합계 | string | Y | 18 | |
+| shnu_cnqn_smtn | 매수2 체결량 합계 | string | Y | 18 | |
+| ntby_cnqn | 순매수 체결량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20186",
+"fid_div_cls_code":"0",
+"fid_rank_sort_cls_code":"0",
+"fid_input_date_1":"20240314",
+"fid_input_date_2":"20240315",
+"fid_input_iscd":"0000",
+"fid_trgt_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_aply_rang_prc_1":"",
+"fid_aply_rang_prc_2":"",
+"fid_aply_rang_vol":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "data_rank": "1",
+ "mksc_shrn_iscd": "Q530036",
+ "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
+ "stck_prpr": "92",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "5800370",
+ "acml_tr_pbmn": "533513365",
+ "seln_cnqn_smtn": "8248448",
+ "shnu_cnqn_smtn": "4633200",
+ "ntby_cnqn": "-3615248"
+ },
+ {
+ "data_rank": "2",
+ "mksc_shrn_iscd": "252670",
+ "hts_kor_isnm": "KODEX 200선물인버스2X",
+ "stck_prpr": "2175",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-5",
+ "prdy_ctrt": "-0.23",
+ "acml_vol": "55781783",
+ "acml_tr_pbmn": "121550061085",
+ "seln_cnqn_smtn": "27416314",
+ "shnu_cnqn_smtn": "25991495",
+ "ntby_cnqn": "-1424819"
+ },
+ {
+ "data_rank": "3",
+ "mksc_shrn_iscd": "025320",
+ "hts_kor_isnm": "시노펙스",
+ "stck_prpr": "10860",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "830",
+ "prdy_ctrt": "8.28",
+ "acml_vol": "4687707",
+ "acml_tr_pbmn": "49125642180",
+ "seln_cnqn_smtn": "5824623",
+ "shnu_cnqn_smtn": "4909381",
+ "ntby_cnqn": "-915242"
+ },
+ {
+ "data_rank": "4",
+ "mksc_shrn_iscd": "290690",
+ "hts_kor_isnm": "소룩스",
+ "stck_prpr": "2550",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "80",
+ "prdy_ctrt": "3.24",
+ "acml_vol": "2932021",
+ "acml_tr_pbmn": "7432512210",
+ "seln_cnqn_smtn": "1297638",
+ "shnu_cnqn_smtn": "485714",
+ "ntby_cnqn": "-811924"
+ },
+ {
+ "data_rank": "5",
+ "mksc_shrn_iscd": "453850",
+ "hts_kor_isnm": "ACE 미국30년국채액티브(H)",
+ "stck_prpr": "8555",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-15",
+ "prdy_ctrt": "-0.18",
+ "acml_vol": "535802",
+ "acml_tr_pbmn": "4573586665",
+ "seln_cnqn_smtn": "1416392",
+ "shnu_cnqn_smtn": "622450",
+ "ntby_cnqn": "-793942"
+ },
+ {
+ "data_rank": "6",
+ "mksc_shrn_iscd": "217620",
+ "hts_kor_isnm": "디딤이앤에프",
+ "stck_prpr": "422",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-19",
+ "prdy_ctrt": "-4.31",
+ "acml_vol": "4011940",
+ "acml_tr_pbmn": "1603037358",
+ "seln_cnqn_smtn": "3775356",
+ "shnu_cnqn_smtn": "3104696",
+ "ntby_cnqn": "-670660"
+ },
+ {
+ "data_rank": "7",
+ "mksc_shrn_iscd": "122630",
+ "hts_kor_isnm": "KODEX 레버리지",
+ "stck_prpr": "18620",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "75",
+ "prdy_ctrt": "0.40",
+ "acml_vol": "8919461",
+ "acml_tr_pbmn": "165416410545",
+ "seln_cnqn_smtn": "4396350",
+ "shnu_cnqn_smtn": "3776614",
+ "ntby_cnqn": "-619736"
+ },
+ {
+ "data_rank": "8",
+ "mksc_shrn_iscd": "900300",
+ "hts_kor_isnm": "오가닉티코스메틱",
+ "stck_prpr": "79",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "2",
+ "prdy_ctrt": "2.60",
+ "acml_vol": "1282716",
+ "acml_tr_pbmn": "99560857",
+ "seln_cnqn_smtn": "813110",
+ "shnu_cnqn_smtn": "263052",
+ "ntby_cnqn": "-550058"
+ },
+ {
+ "data_rank": "9",
+ "mksc_shrn_iscd": "003620",
+ "hts_kor_isnm": "KG모빌리티",
+ "stck_prpr": "7850",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "10",
+ "prdy_ctrt": "0.13",
+ "acml_vol": "154906",
+ "acml_tr_pbmn": "1216385130",
+ "seln_cnqn_smtn": "463658",
+ "shnu_cnqn_smtn": "72251",
+ "ntby_cnqn": "-391407"
+ },
+ {
+ "data_rank": "10",
+ "mksc_shrn_iscd": "271050",
+ "hts_kor_isnm": "KODEX WTI원유선물인버스(H)",
+ "stck_prpr": "4185",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-15",
+ "prdy_ctrt": "-0.36",
+ "acml_vol": "133001",
+ "acml_tr_pbmn": "557302930",
+ "seln_cnqn_smtn": "479478",
+ "shnu_cnqn_smtn": "94195",
+ "ntby_cnqn": "-385283"
+ },
+ {
+ "data_rank": "11",
+ "mksc_shrn_iscd": "227950",
+ "hts_kor_isnm": "엔투텍",
+ "stck_prpr": "787",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1",
+ "prdy_ctrt": "0.13",
+ "acml_vol": "531903",
+ "acml_tr_pbmn": "421143789",
+ "seln_cnqn_smtn": "978263",
+ "shnu_cnqn_smtn": "593139",
+ "ntby_cnqn": "-385124"
+ },
+ {
+ "data_rank": "12",
+ "mksc_shrn_iscd": "003410",
+ "hts_kor_isnm": "쌍용C&E",
+ "stck_prpr": "7000",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "150020",
+ "acml_tr_pbmn": "1050492840",
+ "seln_cnqn_smtn": "605368",
+ "shnu_cnqn_smtn": "221741",
+ "ntby_cnqn": "-383627"
+ },
+ {
+ "data_rank": "13",
+ "mksc_shrn_iscd": "446770",
+ "hts_kor_isnm": "ACE 글로벌반도체TOP4 Plus SOLACTIVE",
+ "stck_prpr": "21540",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-210",
+ "prdy_ctrt": "-0.97",
+ "acml_vol": "121124",
+ "acml_tr_pbmn": "2608030145",
+ "seln_cnqn_smtn": "557891",
+ "shnu_cnqn_smtn": "202444",
+ "ntby_cnqn": "-355447"
+ },
+ {
+ "data_rank": "14",
+ "mksc_shrn_iscd": "012170",
+ "hts_kor_isnm": "아센디오",
+ "stck_prpr": "1066",
+ "prdy_vrss_sign": "3",
+ "prdy_vrss": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "2719320",
+ "acml_tr_pbmn": "2937797895",
+ "seln_cnqn_smtn": "4579213",
+ "shnu_cnqn_smtn": "4278634",
+ "ntby_cnqn": "-300579"
+ },
+ {
+ "data_rank": "15",
+ "mksc_shrn_iscd": "305720",
+ "hts_kor_isnm": "KODEX 2차전지산업",
+ "stck_prpr": "22090",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "290",
+ "prdy_ctrt": "1.33",
+ "acml_vol": "476994",
+ "acml_tr_pbmn": "10501325940",
+ "seln_cnqn_smtn": "669969",
+ "shnu_cnqn_smtn": "381247",
+ "ntby_cnqn": "-288722"
+ },
+ {
+ "data_rank": "16",
+ "mksc_shrn_iscd": "455850",
+ "hts_kor_isnm": "SOL AI반도체소부장",
+ "stck_prpr": "14950",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "180",
+ "prdy_ctrt": "1.22",
+ "acml_vol": "317328",
+ "acml_tr_pbmn": "4715313100",
+ "seln_cnqn_smtn": "513395",
+ "shnu_cnqn_smtn": "228189",
+ "ntby_cnqn": "-285206"
+ },
+ {
+ "data_rank": "17",
+ "mksc_shrn_iscd": "018000",
+ "hts_kor_isnm": "유니슨",
+ "stck_prpr": "1168",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "150",
+ "prdy_ctrt": "14.73",
+ "acml_vol": "5280049",
+ "acml_tr_pbmn": "6263011909",
+ "seln_cnqn_smtn": "407197",
+ "shnu_cnqn_smtn": "124444",
+ "ntby_cnqn": "-282753"
+ },
+ {
+ "data_rank": "18",
+ "mksc_shrn_iscd": "096350",
+ "hts_kor_isnm": "대창솔루션",
+ "stck_prpr": "498",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "4",
+ "prdy_ctrt": "0.81",
+ "acml_vol": "442715",
+ "acml_tr_pbmn": "220176716",
+ "seln_cnqn_smtn": "502574",
+ "shnu_cnqn_smtn": "246358",
+ "ntby_cnqn": "-256216"
+ },
+ {
+ "data_rank": "19",
+ "mksc_shrn_iscd": "474590",
+ "hts_kor_isnm": "WOORI 반도체밸류체인액티브",
+ "stck_prpr": "11080",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "95",
+ "prdy_ctrt": "0.86",
+ "acml_vol": "18",
+ "acml_tr_pbmn": "198175",
+ "seln_cnqn_smtn": "248406",
+ "shnu_cnqn_smtn": "3999",
+ "ntby_cnqn": "-244407"
+ },
+ {
+ "data_rank": "20",
+ "mksc_shrn_iscd": "007460",
+ "hts_kor_isnm": "에이프로젠",
+ "stck_prpr": "1084",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "12",
+ "prdy_ctrt": "1.12",
+ "acml_vol": "5282705",
+ "acml_tr_pbmn": "5806140076",
+ "seln_cnqn_smtn": "3418267",
+ "shnu_cnqn_smtn": "3192395",
+ "ntby_cnqn": "-225872"
+ },
+ {
+ "data_rank": "21",
+ "mksc_shrn_iscd": "088350",
+ "hts_kor_isnm": "한화생명",
+ "stck_prpr": "3185",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-65",
+ "prdy_ctrt": "-2.00",
+ "acml_vol": "1005843",
+ "acml_tr_pbmn": "3216904250",
+ "seln_cnqn_smtn": "795617",
+ "shnu_cnqn_smtn": "589311",
+ "ntby_cnqn": "-206306"
+ },
+ {
+ "data_rank": "22",
+ "mksc_shrn_iscd": "323230",
+ "hts_kor_isnm": "엠에프엠코리아",
+ "stck_prpr": "608",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-2",
+ "prdy_ctrt": "-0.33",
+ "acml_vol": "701312",
+ "acml_tr_pbmn": "425004195",
+ "seln_cnqn_smtn": "1357154",
+ "shnu_cnqn_smtn": "1169986",
+ "ntby_cnqn": "-187168"
+ },
+ {
+ "data_rank": "23",
+ "mksc_shrn_iscd": "053030",
+ "hts_kor_isnm": "바이넥스",
+ "stck_prpr": "18030",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1570",
+ "prdy_ctrt": "9.54",
+ "acml_vol": "7593833",
+ "acml_tr_pbmn": "133713682520",
+ "seln_cnqn_smtn": "1770115",
+ "shnu_cnqn_smtn": "1590560",
+ "ntby_cnqn": "-179555"
+ },
+ {
+ "data_rank": "24",
+ "mksc_shrn_iscd": "287410",
+ "hts_kor_isnm": "제이시스메디칼",
+ "stck_prpr": "7690",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "60",
+ "prdy_ctrt": "0.79",
+ "acml_vol": "171896",
+ "acml_tr_pbmn": "1326481640",
+ "seln_cnqn_smtn": "298796",
+ "shnu_cnqn_smtn": "128249",
+ "ntby_cnqn": "-170547"
+ },
+ {
+ "data_rank": "25",
+ "mksc_shrn_iscd": "462330",
+ "hts_kor_isnm": "KODEX 2차전지산업레버리지",
+ "stck_prpr": "4690",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "2.18",
+ "acml_vol": "1042444",
+ "acml_tr_pbmn": "4855711260",
+ "seln_cnqn_smtn": "648426",
+ "shnu_cnqn_smtn": "481012",
+ "ntby_cnqn": "-167414"
+ },
+ {
+ "data_rank": "26",
+ "mksc_shrn_iscd": "034220",
+ "hts_kor_isnm": "LG디스플레이",
+ "stck_prpr": "11060",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-120",
+ "prdy_ctrt": "-1.07",
+ "acml_vol": "208580",
+ "acml_tr_pbmn": "2314630570",
+ "seln_cnqn_smtn": "430800",
+ "shnu_cnqn_smtn": "277677",
+ "ntby_cnqn": "-153123"
+ },
+ {
+ "data_rank": "27",
+ "mksc_shrn_iscd": "316140",
+ "hts_kor_isnm": "우리금융지주",
+ "stck_prpr": "14780",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-450",
+ "prdy_ctrt": "-2.95",
+ "acml_vol": "2032465",
+ "acml_tr_pbmn": "30023382510",
+ "seln_cnqn_smtn": "898309",
+ "shnu_cnqn_smtn": "745834",
+ "ntby_cnqn": "-152475"
+ },
+ {
+ "data_rank": "28",
+ "mksc_shrn_iscd": "091170",
+ "hts_kor_isnm": "KODEX 은행",
+ "stck_prpr": "8480",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-185",
+ "prdy_ctrt": "-2.14",
+ "acml_vol": "633020",
+ "acml_tr_pbmn": "5343176250",
+ "seln_cnqn_smtn": "657061",
+ "shnu_cnqn_smtn": "506916",
+ "ntby_cnqn": "-150145"
+ },
+ {
+ "data_rank": "29",
+ "mksc_shrn_iscd": "015590",
+ "hts_kor_isnm": "KIB플러그에너지",
+ "stck_prpr": "377",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-2",
+ "prdy_ctrt": "-0.53",
+ "acml_vol": "1338633",
+ "acml_tr_pbmn": "505056784",
+ "seln_cnqn_smtn": "517713",
+ "shnu_cnqn_smtn": "370216",
+ "ntby_cnqn": "-147497"
+ },
+ {
+ "data_rank": "30",
+ "mksc_shrn_iscd": "004870",
+ "hts_kor_isnm": "티웨이홀딩스",
+ "stck_prpr": "465",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "9",
+ "prdy_ctrt": "1.97",
+ "acml_vol": "34028",
+ "acml_tr_pbmn": "15695619",
+ "seln_cnqn_smtn": "186276",
+ "shnu_cnqn_smtn": "39824",
+ "ntby_cnqn": "-146452"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/156_v1_국내주식-088_국내주식-등락률-순위.md b/docs/broker/kis/rest/국내주식/순위분석/156_v1_국내주식-088_국내주식-등락률-순위.md
new file mode 100644
index 0000000..98b9246
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/156_v1_국내주식-088_국내주식-등락률-순위.md
@@ -0,0 +1,920 @@
+# 국내주식 등락률 순위
+
+- 원본 시트명: 국내주식 등락률 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-088
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01700000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/fluctuation
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 등락률 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0170] 등락률 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01700000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_rsfl_rate2 | 등락 비율2 | string | Y | 132 | 공백 입력 시 전체 (~ 비율 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20170 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000(전체) 코스피(0001), 코스닥(1001), 코스피200(2001) |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:상승율순 1:하락율순 2:시가대비상승율 3:시가대비하락율 4:변동율 |
+| fid_input_cnt_1 | 입력 수1 | string | Y | 12 | 0:전체 , 누적일수 입력 |
+| fid_prc_cls_code | 가격 구분 코드 | string | Y | 2 | 'fid_rank_sort_cls_code :0 상승율 순일때 (0:저가대비, 1:종가대비)
fid_rank_sort_cls_code :1 하락율 순일때 (0:고가대비, 1:종가대비)
fid_rank_sort_cls_code : 기타 (0:전체)' |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 공백 입력 시 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 공백 입력 시 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 공백 입력 시 전체 (거래량 ~) |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0:전체 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0:전체 |
+| fid_rsfl_rate1 | 등락 비율1 | string | Y | 132 | 공백 입력 시 전체 (비율 ~) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| hgpr_hour | 최고가 시간 | string | Y | 6 | |
+| acml_hgpr_date | 누적 최고가 일자 | string | Y | 8 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| lwpr_hour | 최저가 시간 | string | Y | 6 | |
+| acml_lwpr_date | 누적 최저가 일자 | string | Y | 8 | |
+| lwpr_vrss_prpr_rate | 최저가 대비 현재가 비율 | string | Y | 84 | |
+| dsgt_date_clpr_vrss_prpr_rate | 지정 일자 종가 대비 현재가 비 | string | Y | 84 | |
+| cnnt_ascn_dynu | 연속 상승 일수 | string | Y | 5 | |
+| hgpr_vrss_prpr_rate | 최고가 대비 현재가 비율 | string | Y | 84 | |
+| cnnt_down_dynu | 연속 하락 일수 | string | Y | 5 | |
+| oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | string | Y | 1 | |
+| oprc_vrss_prpr | 시가2 대비 현재가 | string | Y | 10 | |
+| oprc_vrss_prpr_rate | 시가2 대비 현재가 비율 | string | Y | 84 | |
+| prd_rsfl | 기간 등락 | string | Y | 10 | |
+| prd_rsfl_rate | 기간 등락 비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20170",
+"fid_input_iscd":"0000",
+"fid_rank_sort_cls_code":"0",
+"fid_input_cnt_1":"0",
+"fid_prc_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_trgt_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_div_cls_code":"0",
+"fid_rsfl_rate1":"",
+"fid_rsfl_rate2":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "000040",
+ "data_rank": "1",
+ "hts_kor_isnm": "KR모터스",
+ "stck_prpr": "1821",
+ "prdy_vrss": "197",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "12.13",
+ "acml_vol": "2267183",
+ "stck_hgpr": "1861",
+ "hgpr_hour": "100214",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1301",
+ "lwpr_hour": "090239",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "39.97",
+ "dsgt_date_clpr_vrss_prpr_rate": "12.13",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-2.15",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "032800",
+ "data_rank": "2",
+ "hts_kor_isnm": "판타지오",
+ "stck_prpr": "406",
+ "prdy_vrss": "75",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "22.66",
+ "acml_vol": "36313396",
+ "stck_hgpr": "419",
+ "hgpr_hour": "095020",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "332",
+ "lwpr_hour": "090015",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "22.29",
+ "dsgt_date_clpr_vrss_prpr_rate": "22.66",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-3.10",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "018000",
+ "data_rank": "3",
+ "hts_kor_isnm": "유니슨",
+ "stck_prpr": "1233",
+ "prdy_vrss": "215",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "21.12",
+ "acml_vol": "2436474",
+ "stck_hgpr": "1233",
+ "hgpr_hour": "100301",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1014",
+ "lwpr_hour": "090026",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "21.60",
+ "dsgt_date_clpr_vrss_prpr_rate": "21.12",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "0.00",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "083790",
+ "data_rank": "4",
+ "hts_kor_isnm": "CG인바이츠",
+ "stck_prpr": "4025",
+ "prdy_vrss": "645",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "19.08",
+ "acml_vol": "1666447",
+ "stck_hgpr": "4075",
+ "hgpr_hour": "092027",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "3460",
+ "lwpr_hour": "090005",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "16.33",
+ "dsgt_date_clpr_vrss_prpr_rate": "19.08",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-1.23",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "237690",
+ "data_rank": "5",
+ "hts_kor_isnm": "에스티팜",
+ "stck_prpr": "93400",
+ "prdy_vrss": "15800",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "20.36",
+ "acml_vol": "1368523",
+ "stck_hgpr": "95000",
+ "hgpr_hour": "092731",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "80400",
+ "lwpr_hour": "090025",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "16.17",
+ "dsgt_date_clpr_vrss_prpr_rate": "20.36",
+ "cnnt_ascn_dynu": "3",
+ "hgpr_vrss_prpr_rate": "-1.68",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "065150",
+ "data_rank": "6",
+ "hts_kor_isnm": "대산F&B",
+ "stck_prpr": "239",
+ "prdy_vrss": "33",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "16.02",
+ "acml_vol": "5046848",
+ "stck_hgpr": "267",
+ "hgpr_hour": "094747",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "206",
+ "lwpr_hour": "090024",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "16.02",
+ "dsgt_date_clpr_vrss_prpr_rate": "16.02",
+ "cnnt_ascn_dynu": "3",
+ "hgpr_vrss_prpr_rate": "-10.49",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "008600",
+ "data_rank": "7",
+ "hts_kor_isnm": "윌비스",
+ "stck_prpr": "596",
+ "prdy_vrss": "66",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "12.45",
+ "acml_vol": "3819993",
+ "stck_hgpr": "620",
+ "hgpr_hour": "094852",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "516",
+ "lwpr_hour": "090106",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "15.50",
+ "dsgt_date_clpr_vrss_prpr_rate": "12.45",
+ "cnnt_ascn_dynu": "3",
+ "hgpr_vrss_prpr_rate": "-3.87",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "219130",
+ "data_rank": "8",
+ "hts_kor_isnm": "타이거일렉",
+ "stck_prpr": "37700",
+ "prdy_vrss": "4700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "14.24",
+ "acml_vol": "188206",
+ "stck_hgpr": "38350",
+ "hgpr_hour": "095838",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "32650",
+ "lwpr_hour": "090031",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "15.47",
+ "dsgt_date_clpr_vrss_prpr_rate": "14.24",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-1.69",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "004380",
+ "data_rank": "9",
+ "hts_kor_isnm": "삼익THK",
+ "stck_prpr": "17290",
+ "prdy_vrss": "2100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "13.82",
+ "acml_vol": "2290984",
+ "stck_hgpr": "17720",
+ "hgpr_hour": "095642",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "15050",
+ "lwpr_hour": "090319",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "14.88",
+ "dsgt_date_clpr_vrss_prpr_rate": "13.82",
+ "cnnt_ascn_dynu": "5",
+ "hgpr_vrss_prpr_rate": "-2.43",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "321370",
+ "data_rank": "10",
+ "hts_kor_isnm": "센서뷰",
+ "stck_prpr": "5020",
+ "prdy_vrss": "920",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "22.44",
+ "acml_vol": "4923442",
+ "stck_hgpr": "5300",
+ "hgpr_hour": "092639",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "4400",
+ "lwpr_hour": "090004",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "14.09",
+ "dsgt_date_clpr_vrss_prpr_rate": "22.44",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-5.28",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "010660",
+ "data_rank": "11",
+ "hts_kor_isnm": "화천기계",
+ "stck_prpr": "7470",
+ "prdy_vrss": "1210",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "19.33",
+ "acml_vol": "9426161",
+ "stck_hgpr": "7740",
+ "hgpr_hour": "091704",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "6610",
+ "lwpr_hour": "090030",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "13.01",
+ "dsgt_date_clpr_vrss_prpr_rate": "19.33",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-3.49",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "062970",
+ "data_rank": "12",
+ "hts_kor_isnm": "피피아이",
+ "stck_prpr": "1989",
+ "prdy_vrss": "232",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "13.20",
+ "acml_vol": "2246815",
+ "stck_hgpr": "2150",
+ "hgpr_hour": "093356",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1776",
+ "lwpr_hour": "090028",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.99",
+ "dsgt_date_clpr_vrss_prpr_rate": "13.20",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-7.49",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "060230",
+ "data_rank": "13",
+ "hts_kor_isnm": "소니드",
+ "stck_prpr": "2440",
+ "prdy_vrss": "345",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "16.47",
+ "acml_vol": "1266350",
+ "stck_hgpr": "2500",
+ "hgpr_hour": "090948",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "2180",
+ "lwpr_hour": "090032",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.93",
+ "dsgt_date_clpr_vrss_prpr_rate": "16.47",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-2.40",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "073570",
+ "data_rank": "14",
+ "hts_kor_isnm": "리튬포어스",
+ "stck_prpr": "6240",
+ "prdy_vrss": "840",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "15.56",
+ "acml_vol": "2650262",
+ "stck_hgpr": "6390",
+ "hgpr_hour": "094423",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "5580",
+ "lwpr_hour": "090050",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.83",
+ "dsgt_date_clpr_vrss_prpr_rate": "15.56",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-2.35",
+ "cnnt_down_dynu": "3",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "066910",
+ "data_rank": "15",
+ "hts_kor_isnm": "손오공",
+ "stck_prpr": "3745",
+ "prdy_vrss": "415",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "12.46",
+ "acml_vol": "1612034",
+ "stck_hgpr": "3850",
+ "hgpr_hour": "094324",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "3355",
+ "lwpr_hour": "090035",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.62",
+ "dsgt_date_clpr_vrss_prpr_rate": "12.46",
+ "cnnt_ascn_dynu": "5",
+ "hgpr_vrss_prpr_rate": "-2.73",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "217620",
+ "data_rank": "16",
+ "hts_kor_isnm": "디딤이앤에프",
+ "stck_prpr": "415",
+ "prdy_vrss": "-26",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.90",
+ "acml_vol": "3239066",
+ "stck_hgpr": "419",
+ "hgpr_hour": "093956",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "372",
+ "lwpr_hour": "091151",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.56",
+ "dsgt_date_clpr_vrss_prpr_rate": "-5.90",
+ "cnnt_ascn_dynu": "0",
+ "hgpr_vrss_prpr_rate": "-0.95",
+ "cnnt_down_dynu": "3",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "103590",
+ "data_rank": "17",
+ "hts_kor_isnm": "일진전기",
+ "stck_prpr": "17340",
+ "prdy_vrss": "2660",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "18.12",
+ "acml_vol": "9389511",
+ "stck_hgpr": "18500",
+ "hgpr_hour": "092900",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "15570",
+ "lwpr_hour": "090345",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.37",
+ "dsgt_date_clpr_vrss_prpr_rate": "18.12",
+ "cnnt_ascn_dynu": "4",
+ "hgpr_vrss_prpr_rate": "-6.27",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "224060",
+ "data_rank": "18",
+ "hts_kor_isnm": "더코디",
+ "stck_prpr": "6230",
+ "prdy_vrss": "760",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "13.89",
+ "acml_vol": "646297",
+ "stck_hgpr": "7110",
+ "hgpr_hour": "091332",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "5600",
+ "lwpr_hour": "090030",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.25",
+ "dsgt_date_clpr_vrss_prpr_rate": "13.89",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-12.38",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "064800",
+ "data_rank": "19",
+ "hts_kor_isnm": "젬백스링크",
+ "stck_prpr": "3275",
+ "prdy_vrss": "195",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "6.33",
+ "acml_vol": "723313",
+ "stck_hgpr": "3310",
+ "hgpr_hour": "100240",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "2945",
+ "lwpr_hour": "090021",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.21",
+ "dsgt_date_clpr_vrss_prpr_rate": "6.33",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-1.06",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "383310",
+ "data_rank": "20",
+ "hts_kor_isnm": "에코프로에이치엔",
+ "stck_prpr": "80400",
+ "prdy_vrss": "8700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "12.13",
+ "acml_vol": "629737",
+ "stck_hgpr": "82900",
+ "hgpr_hour": "094050",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "72300",
+ "lwpr_hour": "090018",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.20",
+ "dsgt_date_clpr_vrss_prpr_rate": "12.13",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-3.02",
+ "cnnt_down_dynu": "2",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "101390",
+ "data_rank": "21",
+ "hts_kor_isnm": "아이엠",
+ "stck_prpr": "8570",
+ "prdy_vrss": "-480",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-5.30",
+ "acml_vol": "389587",
+ "stck_hgpr": "9500",
+ "hgpr_hour": "090436",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "7710",
+ "lwpr_hour": "094503",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "11.15",
+ "dsgt_date_clpr_vrss_prpr_rate": "-5.30",
+ "cnnt_ascn_dynu": "3",
+ "hgpr_vrss_prpr_rate": "-9.79",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "196170",
+ "data_rank": "22",
+ "hts_kor_isnm": "알테오젠",
+ "stck_prpr": "221000",
+ "prdy_vrss": "16500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.07",
+ "acml_vol": "1045024",
+ "stck_hgpr": "224000",
+ "hgpr_hour": "093639",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "199500",
+ "lwpr_hour": "090416",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "10.78",
+ "dsgt_date_clpr_vrss_prpr_rate": "8.07",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-1.34",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "388790",
+ "data_rank": "23",
+ "hts_kor_isnm": "라이콤",
+ "stck_prpr": "2105",
+ "prdy_vrss": "200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "10.50",
+ "acml_vol": "770420",
+ "stck_hgpr": "2175",
+ "hgpr_hour": "092044",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1908",
+ "lwpr_hour": "090040",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "10.32",
+ "dsgt_date_clpr_vrss_prpr_rate": "10.50",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-3.22",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "452300",
+ "data_rank": "24",
+ "hts_kor_isnm": "캡스톤파트너스",
+ "stck_prpr": "4805",
+ "prdy_vrss": "435",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.95",
+ "acml_vol": "804742",
+ "stck_hgpr": "4990",
+ "hgpr_hour": "094904",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "4360",
+ "lwpr_hour": "090206",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "10.21",
+ "dsgt_date_clpr_vrss_prpr_rate": "9.95",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-3.71",
+ "cnnt_down_dynu": "2",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "214430",
+ "data_rank": "25",
+ "hts_kor_isnm": "아이쓰리시스템",
+ "stck_prpr": "36900",
+ "prdy_vrss": "4500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "13.89",
+ "acml_vol": "417441",
+ "stck_hgpr": "39000",
+ "hgpr_hour": "091455",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "33500",
+ "lwpr_hour": "090026",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "10.15",
+ "dsgt_date_clpr_vrss_prpr_rate": "13.89",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-5.38",
+ "cnnt_down_dynu": "4",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "276730",
+ "data_rank": "26",
+ "hts_kor_isnm": "제주맥주",
+ "stck_prpr": "1500",
+ "prdy_vrss": "156",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "11.61",
+ "acml_vol": "3075893",
+ "stck_hgpr": "1550",
+ "hgpr_hour": "090617",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1365",
+ "lwpr_hour": "090109",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "9.89",
+ "dsgt_date_clpr_vrss_prpr_rate": "11.61",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-3.23",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "009620",
+ "data_rank": "27",
+ "hts_kor_isnm": "삼보산업",
+ "stck_prpr": "1103",
+ "prdy_vrss": "102",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "10.19",
+ "acml_vol": "2834656",
+ "stck_hgpr": "1149",
+ "hgpr_hour": "091655",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1005",
+ "lwpr_hour": "090018",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "9.75",
+ "dsgt_date_clpr_vrss_prpr_rate": "10.19",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "-4.00",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "457190",
+ "data_rank": "28",
+ "hts_kor_isnm": "이수스페셜티케미컬",
+ "stck_prpr": "389000",
+ "prdy_vrss": "46500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "13.58",
+ "acml_vol": "335026",
+ "stck_hgpr": "389000",
+ "hgpr_hour": "100301",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "356000",
+ "lwpr_hour": "090551",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "9.27",
+ "dsgt_date_clpr_vrss_prpr_rate": "13.58",
+ "cnnt_ascn_dynu": "2",
+ "hgpr_vrss_prpr_rate": "0.00",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "005110",
+ "data_rank": "29",
+ "hts_kor_isnm": "한창",
+ "stck_prpr": "1270",
+ "prdy_vrss": "104",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.92",
+ "acml_vol": "1155830",
+ "stck_hgpr": "1388",
+ "hgpr_hour": "091801",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "1164",
+ "lwpr_hour": "090107",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "9.11",
+ "dsgt_date_clpr_vrss_prpr_rate": "8.92",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-8.50",
+ "cnnt_down_dynu": "1",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ },
+ {
+ "stck_shrn_iscd": "288330",
+ "data_rank": "30",
+ "hts_kor_isnm": "브릿지바이오테라퓨틱스",
+ "stck_prpr": "3455",
+ "prdy_vrss": "250",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "7.80",
+ "acml_vol": "111007",
+ "stck_hgpr": "3595",
+ "hgpr_hour": "092107",
+ "acml_hgpr_date": "20240318",
+ "stck_lwpr": "3175",
+ "lwpr_hour": "090157",
+ "acml_lwpr_date": "20240318",
+ "lwpr_vrss_prpr_rate": "8.82",
+ "dsgt_date_clpr_vrss_prpr_rate": "7.80",
+ "cnnt_ascn_dynu": "1",
+ "hgpr_vrss_prpr_rate": "-3.89",
+ "cnnt_down_dynu": "0",
+ "oprc_vrss_prpr_sign": "2",
+ "oprc_vrss_prpr": "0",
+ "oprc_vrss_prpr_rate": "0.00",
+ "prd_rsfl": "0",
+ "prd_rsfl_rate": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/157_v1_국내주식-096_국내주식-시장가치-순위.md b/docs/broker/kis/rest/국내주식/순위분석/157_v1_국내주식-096_국내주식-시장가치-순위.md
new file mode 100644
index 0000000..14581e5
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/157_v1_국내주식-096_국내주식-시장가치-순위.md
@@ -0,0 +1,794 @@
+# 국내주식 시장가치 순위
+
+- 원본 시트명: 국내주식 시장가치 순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-096
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01790000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/market-value
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시장가치 순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0179] 시장가치순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01790000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 32 | 0 : 전체 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20179 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보톧주, 7:우선주 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_input_option_1 | 입력 옵션1 | string | Y | 10 | 회계연도 입력 (ex 2023) |
+| fid_input_option_2 | 입력 옵션2 | string | Y | 10 | 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산 |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | '가치분석(23:PER, 24:PBR, 25:PCR, 26:PSR, 27: EPS, 28:EVA,
29: EBITDA, 30: EV/EBITDA, 31:EBITDA/금융비율' |
+| fid_blng_cls_code | 소속 구분 코드 | string | Y | 2 | 0 : 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 32 | 0 : 전체 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| per | PER | string | Y | 82 | |
+| pbr | PBR | string | Y | 82 | |
+| pcr | PCR | string | Y | 82 | |
+| psr | PSR | string | Y | 82 | |
+| eps | EPS | string | Y | 112 | |
+| eva | EVA | string | Y | 82 | |
+| ebitda | EBITDA | string | Y | 82 | |
+| pv_div_ebitda | PV DIV EBITDA | string | Y | 82 | |
+| ebitda_div_fnnc_expn | EBITDA DIV 금융비용 | string | Y | 82 | |
+| stac_month | 결산 월 | string | Y | 2 | |
+| stac_month_cls_code | 결산 월 구분 코드 | string | Y | 2 | |
+| iqry_csnu | 조회 건수 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20179",
+"fid_input_iscd":"0000",
+"fid_div_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_input_option_1":"2023",
+"fid_input_option_2":"3",
+"fid_rank_sort_cls_code":"23",
+"fid_blng_cls_code":"0",
+"fid_trgt_exls_cls_code":"0",
+"fid_trgt_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "data_rank": "1",
+ "hts_kor_isnm": "효성",
+ "mksc_shrn_iscd": "004800",
+ "stck_prpr": "57800",
+ "prdy_vrss": "-400",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.69",
+ "acml_vol": "7453",
+ "per": "19266.67",
+ "pbr": "0.49",
+ "pcr": "11.19",
+ "psr": "0.35",
+ "eps": "300",
+ "eva": "-812.00",
+ "ebitda": "2031.00",
+ "pv_div_ebitda": "12.98",
+ "ebitda_div_fnnc_expn": "0.02",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "2",
+ "hts_kor_isnm": "에이엘티",
+ "mksc_shrn_iscd": "172670",
+ "stck_prpr": "21450",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.23",
+ "acml_vol": "28989",
+ "per": "10725.00",
+ "pbr": "1.87",
+ "pcr": "10.63",
+ "psr": "3.68",
+ "eps": "200",
+ "eva": "0.00",
+ "ebitda": "170.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.05",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "3",
+ "hts_kor_isnm": "한싹",
+ "mksc_shrn_iscd": "430690",
+ "stck_prpr": "14450",
+ "prdy_vrss": "-170",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.16",
+ "acml_vol": "11549",
+ "per": "4816.67",
+ "pbr": "2.44",
+ "pcr": "171.76",
+ "psr": "3.74",
+ "eps": "300",
+ "eva": "0.00",
+ "ebitda": "1.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "4",
+ "hts_kor_isnm": "파버나인",
+ "mksc_shrn_iscd": "177830",
+ "stck_prpr": "3565",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "7838",
+ "per": "1188.33",
+ "pbr": "0.61",
+ "pcr": "6.37",
+ "psr": "0.40",
+ "eps": "300",
+ "eva": "0.00",
+ "ebitda": "83.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.03",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "5",
+ "hts_kor_isnm": "카카오페이",
+ "mksc_shrn_iscd": "377300",
+ "stck_prpr": "39800",
+ "prdy_vrss": "-150",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.38",
+ "acml_vol": "49767",
+ "per": "1170.59",
+ "pbr": "2.84",
+ "pcr": "102.25",
+ "psr": "8.90",
+ "eps": "3400",
+ "eva": "0.00",
+ "ebitda": "-6.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "6",
+ "hts_kor_isnm": "디케이티",
+ "mksc_shrn_iscd": "290550",
+ "stck_prpr": "9030",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "5782",
+ "per": "752.50",
+ "pbr": "1.28",
+ "pcr": "18.89",
+ "psr": "0.60",
+ "eps": "1200",
+ "eva": "0.00",
+ "ebitda": "180.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.09",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "7",
+ "hts_kor_isnm": "키움제6호스팩",
+ "mksc_shrn_iscd": "413600",
+ "stck_prpr": "2125",
+ "prdy_vrss": "-25",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.16",
+ "acml_vol": "3455",
+ "per": "708.33",
+ "pbr": "1.11",
+ "pcr": "689.94",
+ "psr": "0.00",
+ "eps": "300",
+ "eva": "0.00",
+ "ebitda": "-1.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "8",
+ "hts_kor_isnm": "네온테크",
+ "mksc_shrn_iscd": "306620",
+ "stck_prpr": "2740",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.11",
+ "acml_vol": "30166",
+ "per": "685.00",
+ "pbr": "2.33",
+ "pcr": "46.94",
+ "psr": "1.63",
+ "eps": "400",
+ "eva": "0.00",
+ "ebitda": "18.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.01",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "9",
+ "hts_kor_isnm": "한올바이오파마",
+ "mksc_shrn_iscd": "009420",
+ "stck_prpr": "36900",
+ "prdy_vrss": "900",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.50",
+ "acml_vol": "241062",
+ "per": "550.75",
+ "pbr": "9.67",
+ "pcr": "285.34",
+ "psr": "14.29",
+ "eps": "6700",
+ "eva": "-67.00",
+ "ebitda": "55.00",
+ "pv_div_ebitda": "423.99",
+ "ebitda_div_fnnc_expn": "0.87",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "10",
+ "hts_kor_isnm": "IBKS제20호스팩",
+ "mksc_shrn_iscd": "439730",
+ "stck_prpr": "2595",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "730",
+ "per": "519.00",
+ "pbr": "1.33",
+ "pcr": "571.59",
+ "psr": "0.00",
+ "eps": "500",
+ "eva": "0.00",
+ "ebitda": "0.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "11",
+ "hts_kor_isnm": "에코프로머티",
+ "mksc_shrn_iscd": "450080",
+ "stck_prpr": "151300",
+ "prdy_vrss": "1100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.73",
+ "acml_vol": "140199",
+ "per": "514.63",
+ "pbr": "27.87",
+ "pcr": "221.45",
+ "psr": "12.06",
+ "eps": "29400",
+ "eva": "266.00",
+ "ebitda": "596.00",
+ "pv_div_ebitda": "4.36",
+ "ebitda_div_fnnc_expn": "0.05",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "12",
+ "hts_kor_isnm": "씨씨에스",
+ "mksc_shrn_iscd": "066790",
+ "stck_prpr": "5460",
+ "prdy_vrss": "10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.18",
+ "acml_vol": "5892226",
+ "per": "496.36",
+ "pbr": "10.52",
+ "pcr": "74.99",
+ "psr": "15.94",
+ "eps": "1100",
+ "eva": "0.00",
+ "ebitda": "28.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.10",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "13",
+ "hts_kor_isnm": "로보스타",
+ "mksc_shrn_iscd": "090360",
+ "stck_prpr": "34800",
+ "prdy_vrss": "650",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.90",
+ "acml_vol": "131404",
+ "per": "490.14",
+ "pbr": "3.77",
+ "pcr": "151.06",
+ "psr": "3.30",
+ "eps": "7100",
+ "eva": "-39.00",
+ "ebitda": "27.00",
+ "pv_div_ebitda": "108.07",
+ "ebitda_div_fnnc_expn": "1.71",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "14",
+ "hts_kor_isnm": "두산퓨얼셀",
+ "mksc_shrn_iscd": "336260",
+ "stck_prpr": "20300",
+ "prdy_vrss": "510",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.58",
+ "acml_vol": "188218",
+ "per": "431.91",
+ "pbr": "3.17",
+ "pcr": "102.57",
+ "psr": "5.32",
+ "eps": "4700",
+ "eva": "-492.00",
+ "ebitda": "196.00",
+ "pv_div_ebitda": "118.06",
+ "ebitda_div_fnnc_expn": "0.04",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "15",
+ "hts_kor_isnm": "가온칩스",
+ "mksc_shrn_iscd": "399720",
+ "stck_prpr": "101900",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.39",
+ "acml_vol": "223999",
+ "per": "415.92",
+ "pbr": "20.38",
+ "pcr": "152.86",
+ "psr": "20.56",
+ "eps": "24500",
+ "eva": "0.00",
+ "ebitda": "49.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.23",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "16",
+ "hts_kor_isnm": "미래나노텍",
+ "mksc_shrn_iscd": "095500",
+ "stck_prpr": "20200",
+ "prdy_vrss": "1530",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.19",
+ "acml_vol": "976189",
+ "per": "412.24",
+ "pbr": "2.34",
+ "pcr": "41.51",
+ "psr": "0.94",
+ "eps": "4900",
+ "eva": "0.00",
+ "ebitda": "226.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.04",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "17",
+ "hts_kor_isnm": "디와이피엔에프",
+ "mksc_shrn_iscd": "104460",
+ "stck_prpr": "20000",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.44",
+ "acml_vol": "12543",
+ "per": "350.88",
+ "pbr": "1.90",
+ "pcr": "64.19",
+ "psr": "1.59",
+ "eps": "5700",
+ "eva": "0.00",
+ "ebitda": "43.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.03",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "18",
+ "hts_kor_isnm": "바이오니아",
+ "mksc_shrn_iscd": "064550",
+ "stck_prpr": "30150",
+ "prdy_vrss": "150",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.50",
+ "acml_vol": "79014",
+ "per": "350.58",
+ "pbr": "3.27",
+ "pcr": "65.17",
+ "psr": "2.93",
+ "eps": "8600",
+ "eva": "0.00",
+ "ebitda": "158.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.20",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "19",
+ "hts_kor_isnm": "픽셀플러스",
+ "mksc_shrn_iscd": "087600",
+ "stck_prpr": "9780",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.31",
+ "acml_vol": "31501",
+ "per": "326.00",
+ "pbr": "0.77",
+ "pcr": "45.96",
+ "psr": "1.27",
+ "eps": "3000",
+ "eva": "-20.00",
+ "ebitda": "44.00",
+ "pv_div_ebitda": "14.29",
+ "ebitda_div_fnnc_expn": "1.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "20",
+ "hts_kor_isnm": "한국제12호스팩",
+ "mksc_shrn_iscd": "458610",
+ "stck_prpr": "2195",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "9418",
+ "per": "313.57",
+ "pbr": "1.10",
+ "pcr": "302.76",
+ "psr": "0.00",
+ "eps": "700",
+ "eva": "0.00",
+ "ebitda": "0.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "0",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "21",
+ "hts_kor_isnm": "유진스팩8호",
+ "mksc_shrn_iscd": "413630",
+ "stck_prpr": "3630",
+ "prdy_vrss": "-80",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.16",
+ "acml_vol": "181731",
+ "per": "302.50",
+ "pbr": "1.95",
+ "pcr": "300.25",
+ "psr": "0.00",
+ "eps": "1200",
+ "eva": "0.00",
+ "ebitda": "-1.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "22",
+ "hts_kor_isnm": "라온텍",
+ "mksc_shrn_iscd": "418420",
+ "stck_prpr": "6310",
+ "prdy_vrss": "120",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.94",
+ "acml_vol": "39277",
+ "per": "300.48",
+ "pbr": "23.99",
+ "pcr": "229.71",
+ "psr": "16.44",
+ "eps": "2100",
+ "eva": "3.00",
+ "ebitda": "5.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.14",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "23",
+ "hts_kor_isnm": "에프엔에스테크",
+ "mksc_shrn_iscd": "083500",
+ "stck_prpr": "12240",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "60455",
+ "per": "291.43",
+ "pbr": "1.57",
+ "pcr": "28.61",
+ "psr": "2.81",
+ "eps": "4200",
+ "eva": "0.00",
+ "ebitda": "25.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.03",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "24",
+ "hts_kor_isnm": "삼아알미늄",
+ "mksc_shrn_iscd": "006110",
+ "stck_prpr": "91500",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.44",
+ "acml_vol": "17642",
+ "per": "284.16",
+ "pbr": "5.22",
+ "pcr": "76.02",
+ "psr": "4.80",
+ "eps": "32200",
+ "eva": "0.00",
+ "ebitda": "133.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.07",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "25",
+ "hts_kor_isnm": "하나기술",
+ "mksc_shrn_iscd": "299030",
+ "stck_prpr": "64900",
+ "prdy_vrss": "1400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.20",
+ "acml_vol": "56036",
+ "per": "276.17",
+ "pbr": "4.68",
+ "pcr": "85.46",
+ "psr": "4.52",
+ "eps": "23500",
+ "eva": "0.00",
+ "ebitda": "-23.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "26",
+ "hts_kor_isnm": "특수건설",
+ "mksc_shrn_iscd": "026150",
+ "stck_prpr": "7600",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.39",
+ "acml_vol": "19735",
+ "per": "271.43",
+ "pbr": "1.24",
+ "pcr": "13.64",
+ "psr": "0.58",
+ "eps": "2800",
+ "eva": "0.00",
+ "ebitda": "75.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.08",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "27",
+ "hts_kor_isnm": "경보제약",
+ "mksc_shrn_iscd": "214390",
+ "stck_prpr": "6890",
+ "prdy_vrss": "220",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.30",
+ "acml_vol": "62124",
+ "per": "265.00",
+ "pbr": "1.15",
+ "pcr": "13.13",
+ "psr": "0.84",
+ "eps": "2600",
+ "eva": "-119.00",
+ "ebitda": "133.00",
+ "pv_div_ebitda": "22.24",
+ "ebitda_div_fnnc_expn": "0.08",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "28",
+ "hts_kor_isnm": "교보11호스팩",
+ "mksc_shrn_iscd": "397880",
+ "stck_prpr": "3425",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "per": "263.46",
+ "pbr": "1.75",
+ "pcr": "253.89",
+ "psr": "0.00",
+ "eps": "1300",
+ "eva": "0.00",
+ "ebitda": "0.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "29",
+ "hts_kor_isnm": "오스테오닉",
+ "mksc_shrn_iscd": "226400",
+ "stck_prpr": "4910",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.41",
+ "acml_vol": "71736",
+ "per": "258.42",
+ "pbr": "1.98",
+ "pcr": "31.94",
+ "psr": "3.82",
+ "eps": "1900",
+ "eva": "0.00",
+ "ebitda": "45.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.07",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ },
+ {
+ "data_rank": "30",
+ "hts_kor_isnm": "유진스팩7호",
+ "mksc_shrn_iscd": "388800",
+ "stck_prpr": "2440",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "0",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "per": "244.00",
+ "pbr": "1.36",
+ "pcr": "254.17",
+ "psr": "0.00",
+ "eps": "1000",
+ "eva": "0.00",
+ "ebitda": "-1.00",
+ "pv_div_ebitda": "0.00",
+ "ebitda_div_fnnc_expn": "0.00",
+ "stac_month": "12",
+ "stac_month_cls_code": "1",
+ "iqry_csnu": "1773"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/158_v1_국내주식-102_국내주식-관심종목등록-상위.md b/docs/broker/kis/rest/국내주식/순위분석/158_v1_국내주식-102_국내주식-관심종목등록-상위.md
new file mode 100644
index 0000000..caa95f4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/158_v1_국내주식-102_국내주식-관심종목등록-상위.md
@@ -0,0 +1,573 @@
+# 국내주식 관심종목등록 상위
+
+- 원본 시트명: 국내주식 관심종목등록 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-102
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01800000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/top-interest-stock
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 관심종목등록 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0180] 관심종목등록상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01800000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd_2 | 입력 필수값2 | string | Y | 12 | 000000 : 필수입력값 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20180) |
+| fid_input_iscd | 업종 코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 2 | 0 : 전체 |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 2 | 0 : 전체 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 2 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 2 | 입력값 없을때 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 12 | 0: 전체 1: 관리종목 2: 투자주의 3: 투자경고 4: 투자위험예고 5: 투자위험 6: 보통주 7: 우선주 |
+| fid_input_cnt_1 | 순위 입력값 | string | Y | 10 | 순위검색 입력값(1: 1위부터, 10:10위부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mrkt_div_cls_name | 시장 분류 구분 명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| askp | 매도호가 | string | Y | 10 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| inter_issu_reg_csnu | 관심 종목 등록 건수 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20180",
+"fid_input_iscd":"0000",
+"fid_trgt_exls_cls_code":"0",
+"fid_trgt_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_div_cls_code":"0",
+"fid_input_iscd_2":"000000",
+"fid_input_cnt_1":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "005930",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "72700",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.55",
+ "acml_vol": "4160099",
+ "acml_tr_pbmn": "302366528800",
+ "askp": "72800",
+ "bidp": "72700",
+ "data_rank": "1",
+ "inter_issu_reg_csnu": "4316153"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "000660",
+ "hts_kor_isnm": "SK하이닉스",
+ "stck_prpr": "162900",
+ "prdy_vrss": "1700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.05",
+ "acml_vol": "990751",
+ "acml_tr_pbmn": "160519591000",
+ "askp": "162900",
+ "bidp": "162800",
+ "data_rank": "2",
+ "inter_issu_reg_csnu": "1173540"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "373220",
+ "hts_kor_isnm": "LG에너지솔루션",
+ "stck_prpr": "404500",
+ "prdy_vrss": "6000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.51",
+ "acml_vol": "46060",
+ "acml_tr_pbmn": "18601165500",
+ "askp": "404500",
+ "bidp": "404000",
+ "data_rank": "3",
+ "inter_issu_reg_csnu": "932490"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "207940",
+ "hts_kor_isnm": "삼성바이오로직스",
+ "stck_prpr": "869000",
+ "prdy_vrss": "43000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.21",
+ "acml_vol": "102027",
+ "acml_tr_pbmn": "87895574000",
+ "askp": "869000",
+ "bidp": "868000",
+ "data_rank": "4",
+ "inter_issu_reg_csnu": "587897"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "005380",
+ "hts_kor_isnm": "현대차",
+ "stck_prpr": "247000",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.44",
+ "acml_vol": "313743",
+ "acml_tr_pbmn": "76616945500",
+ "askp": "247000",
+ "bidp": "246500",
+ "data_rank": "5",
+ "inter_issu_reg_csnu": "515079"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "005935",
+ "hts_kor_isnm": "삼성전자우",
+ "stck_prpr": "62400",
+ "prdy_vrss": "400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.65",
+ "acml_vol": "222773",
+ "acml_tr_pbmn": "13898135300",
+ "askp": "62400",
+ "bidp": "62300",
+ "data_rank": "6",
+ "inter_issu_reg_csnu": "510190"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "000270",
+ "hts_kor_isnm": "기아",
+ "stck_prpr": "127600",
+ "prdy_vrss": "2600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.08",
+ "acml_vol": "601506",
+ "acml_tr_pbmn": "75893598900",
+ "askp": "127800",
+ "bidp": "127600",
+ "data_rank": "7",
+ "inter_issu_reg_csnu": "502555"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "068270",
+ "hts_kor_isnm": "셀트리온",
+ "stck_prpr": "182300",
+ "prdy_vrss": "1500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.83",
+ "acml_vol": "269213",
+ "acml_tr_pbmn": "49066824700",
+ "askp": "182300",
+ "bidp": "182200",
+ "data_rank": "8",
+ "inter_issu_reg_csnu": "394234"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "005490",
+ "hts_kor_isnm": "POSCO홀딩스",
+ "stck_prpr": "437500",
+ "prdy_vrss": "2500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.57",
+ "acml_vol": "164953",
+ "acml_tr_pbmn": "71803903500",
+ "askp": "437500",
+ "bidp": "437000",
+ "data_rank": "9",
+ "inter_issu_reg_csnu": "367885"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "105560",
+ "hts_kor_isnm": "KB금융",
+ "stck_prpr": "73300",
+ "prdy_vrss": "-2900",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.81",
+ "acml_vol": "1098724",
+ "acml_tr_pbmn": "80094554600",
+ "askp": "73300",
+ "bidp": "73200",
+ "data_rank": "10",
+ "inter_issu_reg_csnu": "307475"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "051910",
+ "hts_kor_isnm": "LG화학",
+ "stck_prpr": "439500",
+ "prdy_vrss": "8500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.97",
+ "acml_vol": "76206",
+ "acml_tr_pbmn": "33300157500",
+ "askp": "440000",
+ "bidp": "439500",
+ "data_rank": "11",
+ "inter_issu_reg_csnu": "304253"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "035420",
+ "hts_kor_isnm": "NAVER",
+ "stck_prpr": "184400",
+ "prdy_vrss": "-1700",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.91",
+ "acml_vol": "381339",
+ "acml_tr_pbmn": "70460804100",
+ "askp": "184400",
+ "bidp": "184300",
+ "data_rank": "12",
+ "inter_issu_reg_csnu": "302242"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "006400",
+ "hts_kor_isnm": "삼성SDI",
+ "stck_prpr": "435500",
+ "prdy_vrss": "10500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.47",
+ "acml_vol": "243109",
+ "acml_tr_pbmn": "105190587500",
+ "askp": "435500",
+ "bidp": "435000",
+ "data_rank": "13",
+ "inter_issu_reg_csnu": "292249"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "028260",
+ "hts_kor_isnm": "삼성물산",
+ "stck_prpr": "152000",
+ "prdy_vrss": "-2100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.36",
+ "acml_vol": "328745",
+ "acml_tr_pbmn": "49869673600",
+ "askp": "152100",
+ "bidp": "152000",
+ "data_rank": "14",
+ "inter_issu_reg_csnu": "285997"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "055550",
+ "hts_kor_isnm": "신한지주",
+ "stck_prpr": "48550",
+ "prdy_vrss": "-1050",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-2.12",
+ "acml_vol": "962127",
+ "acml_tr_pbmn": "46386742150",
+ "askp": "48600",
+ "bidp": "48550",
+ "data_rank": "15",
+ "inter_issu_reg_csnu": "254329"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "012330",
+ "hts_kor_isnm": "현대모비스",
+ "stck_prpr": "270000",
+ "prdy_vrss": "1000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.37",
+ "acml_vol": "88500",
+ "acml_tr_pbmn": "23747976000",
+ "askp": "270000",
+ "bidp": "269500",
+ "data_rank": "16",
+ "inter_issu_reg_csnu": "251932"
+ },
+ {
+ "mrkt_div_cls_name": "코스닥",
+ "mksc_shrn_iscd": "247540",
+ "hts_kor_isnm": "에코프로비엠",
+ "stck_prpr": "264000",
+ "prdy_vrss": "7500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.92",
+ "acml_vol": "338076",
+ "acml_tr_pbmn": "89005916500",
+ "askp": "264500",
+ "bidp": "264000",
+ "data_rank": "17",
+ "inter_issu_reg_csnu": "250860"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "003670",
+ "hts_kor_isnm": "포스코퓨처엠",
+ "stck_prpr": "317500",
+ "prdy_vrss": "1000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.32",
+ "acml_vol": "113774",
+ "acml_tr_pbmn": "36129162000",
+ "askp": "318000",
+ "bidp": "317500",
+ "data_rank": "18",
+ "inter_issu_reg_csnu": "245171"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "035720",
+ "hts_kor_isnm": "카카오",
+ "stck_prpr": "53100",
+ "prdy_vrss": "-1000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.85",
+ "acml_vol": "432969",
+ "acml_tr_pbmn": "23106491000",
+ "askp": "53200",
+ "bidp": "53100",
+ "data_rank": "19",
+ "inter_issu_reg_csnu": "240828"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "032830",
+ "hts_kor_isnm": "삼성생명",
+ "stck_prpr": "96100",
+ "prdy_vrss": "-3000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-3.03",
+ "acml_vol": "264230",
+ "acml_tr_pbmn": "25155009400",
+ "askp": "96100",
+ "bidp": "96000",
+ "data_rank": "20",
+ "inter_issu_reg_csnu": "198200"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "086790",
+ "hts_kor_isnm": "하나금융지주",
+ "stck_prpr": "61800",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.48",
+ "acml_vol": "819659",
+ "acml_tr_pbmn": "50061945600",
+ "askp": "61900",
+ "bidp": "61800",
+ "data_rank": "21",
+ "inter_issu_reg_csnu": "181553"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "138040",
+ "hts_kor_isnm": "메리츠금융지주",
+ "stck_prpr": "82900",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.36",
+ "acml_vol": "196602",
+ "acml_tr_pbmn": "16315808200",
+ "askp": "82900",
+ "bidp": "82800",
+ "data_rank": "22",
+ "inter_issu_reg_csnu": "169206"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "066570",
+ "hts_kor_isnm": "LG전자",
+ "stck_prpr": "97300",
+ "prdy_vrss": "-1600",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.62",
+ "acml_vol": "171039",
+ "acml_tr_pbmn": "16760736900",
+ "askp": "97300",
+ "bidp": "97200",
+ "data_rank": "23",
+ "inter_issu_reg_csnu": "161848"
+ },
+ {
+ "mrkt_div_cls_name": "코스닥",
+ "mksc_shrn_iscd": "086520",
+ "hts_kor_isnm": "에코프로",
+ "stck_prpr": "607000",
+ "prdy_vrss": "6000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.00",
+ "acml_vol": "69604",
+ "acml_tr_pbmn": "42222166000",
+ "askp": "608000",
+ "bidp": "607000",
+ "data_rank": "24",
+ "inter_issu_reg_csnu": "160032"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "015760",
+ "hts_kor_isnm": "한국전력",
+ "stck_prpr": "24400",
+ "prdy_vrss": "-450",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.81",
+ "acml_vol": "916977",
+ "acml_tr_pbmn": "22547360200",
+ "askp": "24450",
+ "bidp": "24400",
+ "data_rank": "25",
+ "inter_issu_reg_csnu": "159528"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "003550",
+ "hts_kor_isnm": "LG",
+ "stck_prpr": "90300",
+ "prdy_vrss": "-4600",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.85",
+ "acml_vol": "256392",
+ "acml_tr_pbmn": "23167295200",
+ "askp": "90400",
+ "bidp": "90300",
+ "data_rank": "26",
+ "inter_issu_reg_csnu": "149279"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "000810",
+ "hts_kor_isnm": "삼성화재",
+ "stck_prpr": "306000",
+ "prdy_vrss": "-3500",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.13",
+ "acml_vol": "42010",
+ "acml_tr_pbmn": "12806652000",
+ "askp": "306500",
+ "bidp": "306000",
+ "data_rank": "27",
+ "inter_issu_reg_csnu": "146625"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "034730",
+ "hts_kor_isnm": "SK",
+ "stck_prpr": "185100",
+ "prdy_vrss": "-2200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.17",
+ "acml_vol": "33965",
+ "acml_tr_pbmn": "6295027100",
+ "askp": "185100",
+ "bidp": "185000",
+ "data_rank": "28",
+ "inter_issu_reg_csnu": "137100"
+ },
+ {
+ "mrkt_div_cls_name": "코스피",
+ "mksc_shrn_iscd": "323410",
+ "hts_kor_isnm": "카카오뱅크",
+ "stck_prpr": "27950",
+ "prdy_vrss": "-450",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.58",
+ "acml_vol": "328422",
+ "acml_tr_pbmn": "9190884150",
+ "askp": "27950",
+ "bidp": "27900",
+ "data_rank": "29",
+ "inter_issu_reg_csnu": "135444"
+ },
+ {
+ "mrkt_div_cls_name": "코스닥",
+ "mksc_shrn_iscd": "028300",
+ "hts_kor_isnm": "HLB",
+ "stck_prpr": "102200",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.20",
+ "acml_vol": "633944",
+ "acml_tr_pbmn": "64667743200",
+ "askp": "102200",
+ "bidp": "102100",
+ "data_rank": "30",
+ "inter_issu_reg_csnu": "133952"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/159_v1_국내주식-101_국내주식-체결강도-상위.md b/docs/broker/kis/rest/국내주식/순위분석/159_v1_국내주식-101_국내주식-체결강도-상위.md
new file mode 100644
index 0000000..2a0aea4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/159_v1_국내주식-101_국내주식-체결강도-상위.md
@@ -0,0 +1,507 @@
+# 국내주식 체결강도 상위
+
+- 원본 시트명: 국내주식 체결강도 상위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: v1_국내주식-101
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01680000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/volume-power
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 체결강도 상위 API입니다.
+한국투자 HTS(eFriend Plus) > [0168] 체결강도 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
+종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
+자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01680000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_trgt_exls_cls_code | 대상 제외 구분 코드 | string | Y | 10 | 0 : 전체 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J:KRX, NX:NXT) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20168 ) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 전체, 1: 보통주 2: 우선주 |
+| fid_input_price_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| fid_input_price_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| fid_vol_cnt | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| fid_trgt_cls_code | 대상 구분 코드 | string | Y | 10 | 0 : 전체 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| tday_rltv | 당일 체결강도 | string | Y | 112 | |
+| seln_cnqn_smtn | 매도 체결량 합계 | string | Y | 18 | |
+| shnu_cnqn_smtn | 매수2 체결량 합계 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20168",
+"fid_input_iscd":"0000",
+"fid_div_cls_code":"0",
+"fid_input_price_1":"",
+"fid_input_price_2":"",
+"fid_vol_cnt":"",
+"fid_trgt_exls_cls_code":"0",
+"fid_trgt_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "422260",
+ "data_rank": "1",
+ "hts_kor_isnm": "VITA MZ소비액티브",
+ "stck_prpr": "7650",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.26",
+ "acml_vol": "26424",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "26424"
+ },
+ {
+ "stck_shrn_iscd": "452440",
+ "data_rank": "2",
+ "hts_kor_isnm": "VITA 밸류알파액티브",
+ "stck_prpr": "11440",
+ "prdy_vrss": "-45",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.39",
+ "acml_vol": "23100",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "23100"
+ },
+ {
+ "stck_shrn_iscd": "449680",
+ "data_rank": "3",
+ "hts_kor_isnm": "TIGER 한중전기차(합성)",
+ "stck_prpr": "8945",
+ "prdy_vrss": "200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.29",
+ "acml_vol": "12065",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "12063"
+ },
+ {
+ "stck_shrn_iscd": "457940",
+ "data_rank": "4",
+ "hts_kor_isnm": "에스케이증권제10호스팩",
+ "stck_prpr": "2335",
+ "prdy_vrss": "-5",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.21",
+ "acml_vol": "1011",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "1011"
+ },
+ {
+ "stck_shrn_iscd": "442580",
+ "data_rank": "5",
+ "hts_kor_isnm": "ARIRANG 글로벌D램반도체iSelect",
+ "stck_prpr": "17290",
+ "prdy_vrss": "200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.17",
+ "acml_vol": "906",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "885"
+ },
+ {
+ "stck_shrn_iscd": "458210",
+ "data_rank": "6",
+ "hts_kor_isnm": "히어로즈 CD금리액티브(합성)",
+ "stck_prpr": "102975",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "663",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "663"
+ },
+ {
+ "stck_shrn_iscd": "418210",
+ "data_rank": "7",
+ "hts_kor_isnm": "신한제10호스팩",
+ "stck_prpr": "2420",
+ "prdy_vrss": "40",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.68",
+ "acml_vol": "618",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "618"
+ },
+ {
+ "stck_shrn_iscd": "469790",
+ "data_rank": "8",
+ "hts_kor_isnm": "KOSEF K-테크TOP10",
+ "stck_prpr": "11025",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.09",
+ "acml_vol": "612",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "612"
+ },
+ {
+ "stck_shrn_iscd": "449580",
+ "data_rank": "9",
+ "hts_kor_isnm": "KBSTAR 미국빅데이터Top3채권혼합iSelect",
+ "stck_prpr": "12170",
+ "prdy_vrss": "45",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.37",
+ "acml_vol": "463",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "463"
+ },
+ {
+ "stck_shrn_iscd": "424140",
+ "data_rank": "10",
+ "hts_kor_isnm": "케이비제21호스팩",
+ "stck_prpr": "2090",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "924",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "419"
+ },
+ {
+ "stck_shrn_iscd": "Q570055",
+ "data_rank": "11",
+ "hts_kor_isnm": "한투 금 선물 ETN",
+ "stck_prpr": "13530",
+ "prdy_vrss": "-20",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.15",
+ "acml_vol": "401",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "401"
+ },
+ {
+ "stck_shrn_iscd": "433980",
+ "data_rank": "12",
+ "hts_kor_isnm": "KODEX TDF2040액티브",
+ "stck_prpr": "12145",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.04",
+ "acml_vol": "391",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "377"
+ },
+ {
+ "stck_shrn_iscd": "474390",
+ "data_rank": "13",
+ "hts_kor_isnm": "SOL 국고채30년액티브",
+ "stck_prpr": "49100",
+ "prdy_vrss": "-135",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.27",
+ "acml_vol": "307",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "307"
+ },
+ {
+ "stck_shrn_iscd": "Q700009",
+ "data_rank": "14",
+ "hts_kor_isnm": "하나 레버리지 구리 선물 ETN(H)",
+ "stck_prpr": "15195",
+ "prdy_vrss": "50",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.33",
+ "acml_vol": "302",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "302"
+ },
+ {
+ "stck_shrn_iscd": "331910",
+ "data_rank": "15",
+ "hts_kor_isnm": "KOSEF Fn중소형",
+ "stck_prpr": "21010",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.62",
+ "acml_vol": "178",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "178"
+ },
+ {
+ "stck_shrn_iscd": "334700",
+ "data_rank": "16",
+ "hts_kor_isnm": "KBSTAR 팔라듐선물인버스(H)",
+ "stck_prpr": "5795",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "155",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "155"
+ },
+ {
+ "stck_shrn_iscd": "453660",
+ "data_rank": "17",
+ "hts_kor_isnm": "KODEX 미국S&P500경기소비재",
+ "stck_prpr": "12875",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.39",
+ "acml_vol": "102",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "101"
+ },
+ {
+ "stck_shrn_iscd": "Q610054",
+ "data_rank": "18",
+ "hts_kor_isnm": "메리츠 블룸버그 -2X 천연가스 선물 ETN(H)",
+ "stck_prpr": "93505",
+ "prdy_vrss": "-505",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.54",
+ "acml_vol": "100",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "100"
+ },
+ {
+ "stck_shrn_iscd": "322150",
+ "data_rank": "19",
+ "hts_kor_isnm": "ACE 스마트하이베타",
+ "stck_prpr": "13240",
+ "prdy_vrss": "-70",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.53",
+ "acml_vol": "91",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "91"
+ },
+ {
+ "stck_shrn_iscd": "Q580057",
+ "data_rank": "20",
+ "hts_kor_isnm": "KB 일본 컨슈머 TOP 10 ETN",
+ "stck_prpr": "11080",
+ "prdy_vrss": "70",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.64",
+ "acml_vol": "90",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "90"
+ },
+ {
+ "stck_shrn_iscd": "Q580034",
+ "data_rank": "21",
+ "hts_kor_isnm": "KB 레버리지 FANG 플러스 ETN(H)",
+ "stck_prpr": "37185",
+ "prdy_vrss": "-420",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.12",
+ "acml_vol": "76",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "76"
+ },
+ {
+ "stck_shrn_iscd": "449780",
+ "data_rank": "22",
+ "hts_kor_isnm": "KOSEF 미국S&P500(H)",
+ "stck_prpr": "13080",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.38",
+ "acml_vol": "106",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "65"
+ },
+ {
+ "stck_shrn_iscd": "122260",
+ "data_rank": "23",
+ "hts_kor_isnm": "KOSEF 통안채1년",
+ "stck_prpr": "103225",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "61",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "61"
+ },
+ {
+ "stck_shrn_iscd": "Q700014",
+ "data_rank": "24",
+ "hts_kor_isnm": "하나 인버스 2X 콩 선물 ETN(H)",
+ "stck_prpr": "10850",
+ "prdy_vrss": "-85",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.78",
+ "acml_vol": "55",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "55"
+ },
+ {
+ "stck_shrn_iscd": "433220",
+ "data_rank": "25",
+ "hts_kor_isnm": "에셋플러스 글로벌대장장이액티브",
+ "stck_prpr": "13855",
+ "prdy_vrss": "5",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.04",
+ "acml_vol": "54",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "54"
+ },
+ {
+ "stck_shrn_iscd": "Q530014",
+ "data_rank": "26",
+ "hts_kor_isnm": "삼성 China A50 선물 ETN(H)",
+ "stck_prpr": "14910",
+ "prdy_vrss": "55",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.37",
+ "acml_vol": "51",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "51"
+ },
+ {
+ "stck_shrn_iscd": "411540",
+ "data_rank": "27",
+ "hts_kor_isnm": "SOL 200 Top10",
+ "stck_prpr": "9005",
+ "prdy_vrss": "130",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.46",
+ "acml_vol": "48",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "46"
+ },
+ {
+ "stck_shrn_iscd": "227830",
+ "data_rank": "28",
+ "hts_kor_isnm": "ARIRANG 코스피",
+ "stck_prpr": "28060",
+ "prdy_vrss": "90",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.32",
+ "acml_vol": "41",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "41"
+ },
+ {
+ "stck_shrn_iscd": "375760",
+ "data_rank": "29",
+ "hts_kor_isnm": "HANARO 탄소효율그린뉴딜",
+ "stck_prpr": "9070",
+ "prdy_vrss": "45",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.50",
+ "acml_vol": "37",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "37"
+ },
+ {
+ "stck_shrn_iscd": "395750",
+ "data_rank": "30",
+ "hts_kor_isnm": "ARIRANG ESG가치주액티브",
+ "stck_prpr": "8445",
+ "prdy_vrss": "35",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.42",
+ "acml_vol": "36",
+ "tday_rltv": "999.99",
+ "seln_cnqn_smtn": "0",
+ "shnu_cnqn_smtn": "36"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/순위분석/160_국내주식-138_국내주식-시간외등락율순위.md b/docs/broker/kis/rest/국내주식/순위분석/160_국내주식-138_국내주식-시간외등락율순위.md
new file mode 100644
index 0000000..95a4b0f
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/순위분석/160_국내주식-138_국내주식-시간외등락율순위.md
@@ -0,0 +1,683 @@
+# 국내주식 시간외등락율순위
+
+- 원본 시트명: 국내주식 시간외등락율순위
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 순위분석
+- API ID: 국내주식-138
+- HTTP Method: GET
+- 실전 TR_ID: FHPST02340000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/overtime-fluctuation
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외등락율순위 API입니다.
+한국투자 HTS(eFriend Plus) > [0234] 시간외 등락률순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST02340000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J: 주식) |
+| FID_MRKT_CLS_CODE | 시장 구분 코드 | string | Y | 2 | 공백 입력 |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20234) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000(전체), 0001(코스피), 1001(코스닥) |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 1(상한가), 2(상승률), 3(보합),4(하한가),5(하락률) |
+| FID_INPUT_PRICE_1 | 입력 가격1 | string | Y | 12 | 입력값 없을때 전체 (가격 ~) |
+| FID_INPUT_PRICE_2 | 입력 가격2 | string | Y | 12 | 입력값 없을때 전체 (~ 가격) |
+| FID_VOL_CNT | 거래량 수 | string | Y | 12 | 입력값 없을때 전체 (거래량 ~) |
+| FID_TRGT_CLS_CODE | 대상 구분 코드 | string | Y | 32 | 공백 입력 |
+| FID_TRGT_EXLS_CLS_CODE | 대상 제외 구분 코드 | string | Y | 32 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ovtm_untp_uplm_issu_cnt | 시간외 단일가 상한 종목 수 | string | Y | 7 | |
+| ovtm_untp_ascn_issu_cnt | 시간외 단일가 상승 종목 수 | string | Y | 7 | |
+| ovtm_untp_stnr_issu_cnt | 시간외 단일가 보합 종목 수 | string | Y | 7 | |
+| ovtm_untp_lslm_issu_cnt | 시간외 단일가 하한 종목 수 | string | Y | 7 | |
+| ovtm_untp_down_issu_cnt | 시간외 단일가 하락 종목 수 | string | Y | 7 | |
+| ovtm_untp_acml_vol | 시간외 단일가 누적 거래량 | string | Y | 19 | |
+| ovtm_untp_acml_tr_pbmn | 시간외 단일가 누적 거래대금 | string | Y | 19 | |
+| ovtm_untp_exch_vol | 시간외 단일가 거래소 거래량 | string | Y | 18 | |
+| ovtm_untp_exch_tr_pbmn | 시간외 단일가 거래소 거래대금 | string | Y | 18 | |
+| ovtm_untp_kosdaq_vol | 시간외 단일가 KOSDAQ 거래량 | string | Y | 18 | |
+| ovtm_untp_kosdaq_tr_pbmn | 시간외 단일가 KOSDAQ 거래대금 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| ovtm_untp_prpr | 시간외 단일가 현재가 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | Y | 10 | |
+| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | Y | 1 | |
+| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | Y | 82 | |
+| ovtm_untp_askp1 | 시간외 단일가 매도호가1 | string | Y | 10 | |
+| ovtm_untp_seln_rsqn | 시간외 단일가 매도 잔량 | string | Y | 12 | |
+| ovtm_untp_bidp1 | 시간외 단일가 매수호가1 | string | Y | 10 | |
+| ovtm_untp_shnu_rsqn | 시간외 단일가 매수 잔량 | string | Y | 12 | |
+| ovtm_untp_vol | 시간외 단일가 거래량 | string | Y | 18 | |
+| ovtm_vrss_acml_vol_rlim | 시간외 대비 누적 거래량 비중 | string | Y | 52 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| bidp | 매수호가 | string | Y | 10 | |
+| askp | 매도호가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:J
+fid_mrkt_cls_code:
+fid_cond_scr_div_code:20234
+fid_input_iscd:0000
+fid_div_cls_code:2
+fid_input_price_1:
+fid_input_price_2:
+fid_vol_cnt:
+fid_trgt_cls_code:
+fid_trgt_exls_cls_code:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ovtm_untp_uplm_issu_cnt": "2",
+ "ovtm_untp_ascn_issu_cnt": "923",
+ "ovtm_untp_stnr_issu_cnt": "634",
+ "ovtm_untp_lslm_issu_cnt": "1",
+ "ovtm_untp_down_issu_cnt": "731",
+ "ovtm_untp_acml_vol": "30215421",
+ "ovtm_untp_acml_tr_pbmn": "232960766966",
+ "ovtm_untp_exch_vol": "15196593",
+ "ovtm_untp_exch_tr_pbmn": "119450793021",
+ "ovtm_untp_kosdaq_vol": "15018828",
+ "ovtm_untp_kosdaq_tr_pbmn": "113509973945"
+ },
+ "output2": [
+ {
+ "mksc_shrn_iscd": "36328K",
+ "hts_kor_isnm": "티와이홀딩스우",
+ "ovtm_untp_prpr": "5880",
+ "ovtm_untp_prdy_vrss": "530",
+ "ovtm_untp_prdy_vrss_sign": "1",
+ "ovtm_untp_prdy_ctrt": "9.91",
+ "ovtm_untp_askp1": "0",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_bidp1": "5880",
+ "ovtm_untp_shnu_rsqn": "13465",
+ "ovtm_untp_vol": "19288",
+ "ovtm_vrss_acml_vol_rlim": "12.06",
+ "stck_prpr": "5480",
+ "acml_vol": "159997",
+ "bidp": "5470",
+ "askp": "5480"
+ },
+ {
+ "mksc_shrn_iscd": "025950",
+ "hts_kor_isnm": "동신건설",
+ "ovtm_untp_prpr": "21000",
+ "ovtm_untp_prdy_vrss": "1890",
+ "ovtm_untp_prdy_vrss_sign": "1",
+ "ovtm_untp_prdy_ctrt": "9.89",
+ "ovtm_untp_askp1": "0",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_bidp1": "21000",
+ "ovtm_untp_shnu_rsqn": "27744",
+ "ovtm_untp_vol": "46834",
+ "ovtm_vrss_acml_vol_rlim": "12.37",
+ "stck_prpr": "21250",
+ "acml_vol": "378572",
+ "bidp": "21150",
+ "askp": "21250"
+ },
+ {
+ "mksc_shrn_iscd": "465610",
+ "hts_kor_isnm": "ACE 미국빅테크TOP7 Plus레버리지(합성)",
+ "ovtm_untp_prpr": "16595",
+ "ovtm_untp_prdy_vrss": "1465",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.68",
+ "ovtm_untp_askp1": "16595",
+ "ovtm_untp_seln_rsqn": "22",
+ "ovtm_untp_bidp1": "15140",
+ "ovtm_untp_shnu_rsqn": "623",
+ "ovtm_untp_vol": "2",
+ "ovtm_vrss_acml_vol_rlim": "0.01",
+ "stck_prpr": "14430",
+ "acml_vol": "26559",
+ "bidp": "14430",
+ "askp": "14450"
+ },
+ {
+ "mksc_shrn_iscd": "201490",
+ "hts_kor_isnm": "미투온",
+ "ovtm_untp_prpr": "2785",
+ "ovtm_untp_prdy_vrss": "245",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.65",
+ "ovtm_untp_askp1": "2785",
+ "ovtm_untp_seln_rsqn": "6957",
+ "ovtm_untp_bidp1": "2540",
+ "ovtm_untp_shnu_rsqn": "3182",
+ "ovtm_untp_vol": "43772",
+ "ovtm_vrss_acml_vol_rlim": "0.98",
+ "stck_prpr": "2870",
+ "acml_vol": "4444613",
+ "bidp": "2870",
+ "askp": "2880"
+ },
+ {
+ "mksc_shrn_iscd": "448540",
+ "hts_kor_isnm": "ACE 엔비디아채권혼합블룸버그",
+ "ovtm_untp_prpr": "19690",
+ "ovtm_untp_prdy_vrss": "1725",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.60",
+ "ovtm_untp_askp1": "18945",
+ "ovtm_untp_seln_rsqn": "47",
+ "ovtm_untp_bidp1": "17980",
+ "ovtm_untp_shnu_rsqn": "210",
+ "ovtm_untp_vol": "21",
+ "ovtm_vrss_acml_vol_rlim": "0.02",
+ "stck_prpr": "17600",
+ "acml_vol": "84622",
+ "bidp": "17600",
+ "askp": "17620"
+ },
+ {
+ "mksc_shrn_iscd": "00499K",
+ "hts_kor_isnm": "롯데지주우",
+ "ovtm_untp_prpr": "38000",
+ "ovtm_untp_prdy_vrss": "3300",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.51",
+ "ovtm_untp_askp1": "38000",
+ "ovtm_untp_seln_rsqn": "176",
+ "ovtm_untp_bidp1": "34750",
+ "ovtm_untp_shnu_rsqn": "60",
+ "ovtm_untp_vol": "9",
+ "ovtm_vrss_acml_vol_rlim": "64.29",
+ "stck_prpr": "35150",
+ "acml_vol": "14",
+ "bidp": "34750",
+ "askp": "35150"
+ },
+ {
+ "mksc_shrn_iscd": "069140",
+ "hts_kor_isnm": "누리플랜",
+ "ovtm_untp_prpr": "1568",
+ "ovtm_untp_prdy_vrss": "133",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.27",
+ "ovtm_untp_askp1": "1552",
+ "ovtm_untp_seln_rsqn": "4024",
+ "ovtm_untp_bidp1": "1436",
+ "ovtm_untp_shnu_rsqn": "2049",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "1438",
+ "acml_vol": "31055",
+ "bidp": "1435",
+ "askp": "1438"
+ },
+ {
+ "mksc_shrn_iscd": "007530",
+ "hts_kor_isnm": "와이엠",
+ "ovtm_untp_prpr": "2900",
+ "ovtm_untp_prdy_vrss": "240",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "9.02",
+ "ovtm_untp_askp1": "2900",
+ "ovtm_untp_seln_rsqn": "4398",
+ "ovtm_untp_bidp1": "2660",
+ "ovtm_untp_shnu_rsqn": "1065",
+ "ovtm_untp_vol": "11",
+ "ovtm_vrss_acml_vol_rlim": "0.57",
+ "stck_prpr": "2710",
+ "acml_vol": "1918",
+ "bidp": "2680",
+ "askp": "2710"
+ },
+ {
+ "mksc_shrn_iscd": "310870",
+ "hts_kor_isnm": "디와이씨",
+ "ovtm_untp_prpr": "1517",
+ "ovtm_untp_prdy_vrss": "124",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "8.90",
+ "ovtm_untp_askp1": "1516",
+ "ovtm_untp_seln_rsqn": "20512",
+ "ovtm_untp_bidp1": "1393",
+ "ovtm_untp_shnu_rsqn": "1233",
+ "ovtm_untp_vol": "5",
+ "ovtm_vrss_acml_vol_rlim": "0.02",
+ "stck_prpr": "1406",
+ "acml_vol": "27844",
+ "bidp": "1399",
+ "askp": "1406"
+ },
+ {
+ "mksc_shrn_iscd": "019490",
+ "hts_kor_isnm": "하이트론",
+ "ovtm_untp_prpr": "1350",
+ "ovtm_untp_prdy_vrss": "110",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "8.87",
+ "ovtm_untp_askp1": "1350",
+ "ovtm_untp_seln_rsqn": "15196",
+ "ovtm_untp_bidp1": "1240",
+ "ovtm_untp_shnu_rsqn": "937",
+ "ovtm_untp_vol": "22",
+ "ovtm_vrss_acml_vol_rlim": "0.07",
+ "stck_prpr": "1224",
+ "acml_vol": "33488",
+ "bidp": "1224",
+ "askp": "1230"
+ },
+ {
+ "mksc_shrn_iscd": "115570",
+ "hts_kor_isnm": "스타플렉스",
+ "ovtm_untp_prpr": "2995",
+ "ovtm_untp_prdy_vrss": "225",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "8.12",
+ "ovtm_untp_askp1": "2985",
+ "ovtm_untp_seln_rsqn": "448",
+ "ovtm_untp_bidp1": "2540",
+ "ovtm_untp_shnu_rsqn": "428",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.03",
+ "stck_prpr": "2720",
+ "acml_vol": "3138",
+ "bidp": "2710",
+ "askp": "2720"
+ },
+ {
+ "mksc_shrn_iscd": "045660",
+ "hts_kor_isnm": "에이텍",
+ "ovtm_untp_prpr": "15810",
+ "ovtm_untp_prdy_vrss": "1130",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "7.70",
+ "ovtm_untp_askp1": "15810",
+ "ovtm_untp_seln_rsqn": "6365",
+ "ovtm_untp_bidp1": "15800",
+ "ovtm_untp_shnu_rsqn": "1930",
+ "ovtm_untp_vol": "93555",
+ "ovtm_vrss_acml_vol_rlim": "18.30",
+ "stck_prpr": "15430",
+ "acml_vol": "511314",
+ "bidp": "15430",
+ "askp": "15470"
+ },
+ {
+ "mksc_shrn_iscd": "215380",
+ "hts_kor_isnm": "우정바이오",
+ "ovtm_untp_prpr": "1783",
+ "ovtm_untp_prdy_vrss": "127",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "7.67",
+ "ovtm_untp_askp1": "1787",
+ "ovtm_untp_seln_rsqn": "5766",
+ "ovtm_untp_bidp1": "1600",
+ "ovtm_untp_shnu_rsqn": "500",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "1630",
+ "acml_vol": "28468",
+ "bidp": "1625",
+ "askp": "1629"
+ },
+ {
+ "mksc_shrn_iscd": "001130",
+ "hts_kor_isnm": "대한제분",
+ "ovtm_untp_prpr": "139000",
+ "ovtm_untp_prdy_vrss": "9500",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "7.34",
+ "ovtm_untp_askp1": "138900",
+ "ovtm_untp_seln_rsqn": "6",
+ "ovtm_untp_bidp1": "129700",
+ "ovtm_untp_shnu_rsqn": "8",
+ "ovtm_untp_vol": "7",
+ "ovtm_vrss_acml_vol_rlim": "0.94",
+ "stck_prpr": "131200",
+ "acml_vol": "741",
+ "bidp": "130000",
+ "askp": "131000"
+ },
+ {
+ "mksc_shrn_iscd": "003780",
+ "hts_kor_isnm": "진양산업",
+ "ovtm_untp_prpr": "6880",
+ "ovtm_untp_prdy_vrss": "460",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "7.17",
+ "ovtm_untp_askp1": "6900",
+ "ovtm_untp_seln_rsqn": "1544",
+ "ovtm_untp_bidp1": "6310",
+ "ovtm_untp_shnu_rsqn": "1396",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "6580",
+ "acml_vol": "20468",
+ "bidp": "6560",
+ "askp": "6580"
+ },
+ {
+ "mksc_shrn_iscd": "456490",
+ "hts_kor_isnm": "교보14호스팩",
+ "ovtm_untp_prpr": "2390",
+ "ovtm_untp_prdy_vrss": "155",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.94",
+ "ovtm_untp_askp1": "2390",
+ "ovtm_untp_seln_rsqn": "7226",
+ "ovtm_untp_bidp1": "2040",
+ "ovtm_untp_shnu_rsqn": "6697",
+ "ovtm_untp_vol": "9",
+ "ovtm_vrss_acml_vol_rlim": "3.15",
+ "stck_prpr": "2255",
+ "acml_vol": "286",
+ "bidp": "2240",
+ "askp": "2255"
+ },
+ {
+ "mksc_shrn_iscd": "051630",
+ "hts_kor_isnm": "진양화학",
+ "ovtm_untp_prpr": "3800",
+ "ovtm_untp_prdy_vrss": "235",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.59",
+ "ovtm_untp_askp1": "3695",
+ "ovtm_untp_seln_rsqn": "7469",
+ "ovtm_untp_bidp1": "3570",
+ "ovtm_untp_shnu_rsqn": "1053",
+ "ovtm_untp_vol": "36",
+ "ovtm_vrss_acml_vol_rlim": "0.37",
+ "stck_prpr": "3590",
+ "acml_vol": "9742",
+ "bidp": "3570",
+ "askp": "3590"
+ },
+ {
+ "mksc_shrn_iscd": "049120",
+ "hts_kor_isnm": "파인디앤씨",
+ "ovtm_untp_prpr": "1420",
+ "ovtm_untp_prdy_vrss": "87",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.53",
+ "ovtm_untp_askp1": "1418",
+ "ovtm_untp_seln_rsqn": "387",
+ "ovtm_untp_bidp1": "1325",
+ "ovtm_untp_shnu_rsqn": "31266",
+ "ovtm_untp_vol": "10",
+ "ovtm_vrss_acml_vol_rlim": "1.10",
+ "stck_prpr": "1368",
+ "acml_vol": "906",
+ "bidp": "1356",
+ "askp": "1368"
+ },
+ {
+ "mksc_shrn_iscd": "083470",
+ "hts_kor_isnm": "이엠앤아이",
+ "ovtm_untp_prpr": "2060",
+ "ovtm_untp_prdy_vrss": "125",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.46",
+ "ovtm_untp_askp1": "2055",
+ "ovtm_untp_seln_rsqn": "972",
+ "ovtm_untp_bidp1": "1841",
+ "ovtm_untp_shnu_rsqn": "777",
+ "ovtm_untp_vol": "26",
+ "ovtm_vrss_acml_vol_rlim": "0.10",
+ "stck_prpr": "1896",
+ "acml_vol": "26871",
+ "bidp": "1884",
+ "askp": "1896"
+ },
+ {
+ "mksc_shrn_iscd": "388420",
+ "hts_kor_isnm": "KBSTAR 비메모리반도체액티브",
+ "ovtm_untp_prpr": "14750",
+ "ovtm_untp_prdy_vrss": "885",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.38",
+ "ovtm_untp_askp1": "13870",
+ "ovtm_untp_seln_rsqn": "1434",
+ "ovtm_untp_bidp1": "12685",
+ "ovtm_untp_shnu_rsqn": "220",
+ "ovtm_untp_vol": "70",
+ "ovtm_vrss_acml_vol_rlim": "0.02",
+ "stck_prpr": "13415",
+ "acml_vol": "377764",
+ "bidp": "13400",
+ "askp": "13415"
+ },
+ {
+ "mksc_shrn_iscd": "133820",
+ "hts_kor_isnm": "화인베스틸",
+ "ovtm_untp_prpr": "1365",
+ "ovtm_untp_prdy_vrss": "81",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.31",
+ "ovtm_untp_askp1": "1365",
+ "ovtm_untp_seln_rsqn": "8677",
+ "ovtm_untp_bidp1": "1284",
+ "ovtm_untp_shnu_rsqn": "242",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "1285",
+ "acml_vol": "20397",
+ "bidp": "1285",
+ "askp": "1293"
+ },
+ {
+ "mksc_shrn_iscd": "049800",
+ "hts_kor_isnm": "우진플라임",
+ "ovtm_untp_prpr": "2870",
+ "ovtm_untp_prdy_vrss": "170",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.30",
+ "ovtm_untp_askp1": "2875",
+ "ovtm_untp_seln_rsqn": "2633",
+ "ovtm_untp_bidp1": "2680",
+ "ovtm_untp_shnu_rsqn": "1305",
+ "ovtm_untp_vol": "798",
+ "ovtm_vrss_acml_vol_rlim": "9.24",
+ "stck_prpr": "2695",
+ "acml_vol": "8638",
+ "bidp": "2685",
+ "askp": "2690"
+ },
+ {
+ "mksc_shrn_iscd": "045340",
+ "hts_kor_isnm": "토탈소프트",
+ "ovtm_untp_prpr": "5140",
+ "ovtm_untp_prdy_vrss": "300",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.20",
+ "ovtm_untp_askp1": "5150",
+ "ovtm_untp_seln_rsqn": "4025",
+ "ovtm_untp_bidp1": "5140",
+ "ovtm_untp_shnu_rsqn": "8098",
+ "ovtm_untp_vol": "5565",
+ "ovtm_vrss_acml_vol_rlim": "4.73",
+ "stck_prpr": "5030",
+ "acml_vol": "117599",
+ "bidp": "5000",
+ "askp": "5030"
+ },
+ {
+ "mksc_shrn_iscd": "300080",
+ "hts_kor_isnm": "플리토",
+ "ovtm_untp_prpr": "27550",
+ "ovtm_untp_prdy_vrss": "1600",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "6.17",
+ "ovtm_untp_askp1": "27550",
+ "ovtm_untp_seln_rsqn": "5049",
+ "ovtm_untp_bidp1": "27250",
+ "ovtm_untp_shnu_rsqn": "712",
+ "ovtm_untp_vol": "446",
+ "ovtm_vrss_acml_vol_rlim": "1.30",
+ "stck_prpr": "27000",
+ "acml_vol": "34396",
+ "bidp": "26950",
+ "askp": "27000"
+ },
+ {
+ "mksc_shrn_iscd": "359090",
+ "hts_kor_isnm": "씨엔알리서치",
+ "ovtm_untp_prpr": "2130",
+ "ovtm_untp_prdy_vrss": "120",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "5.97",
+ "ovtm_untp_askp1": "2130",
+ "ovtm_untp_seln_rsqn": "495757",
+ "ovtm_untp_bidp1": "2125",
+ "ovtm_untp_shnu_rsqn": "129722",
+ "ovtm_untp_vol": "1822458",
+ "ovtm_vrss_acml_vol_rlim": "7.89",
+ "stck_prpr": "2265",
+ "acml_vol": "23096436",
+ "bidp": "2265",
+ "askp": "2270"
+ },
+ {
+ "mksc_shrn_iscd": "442580",
+ "hts_kor_isnm": "ARIRANG 글로벌D램반도체iSelect",
+ "ovtm_untp_prpr": "19810",
+ "ovtm_untp_prdy_vrss": "1080",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "5.77",
+ "ovtm_untp_askp1": "0",
+ "ovtm_untp_seln_rsqn": "0",
+ "ovtm_untp_bidp1": "0",
+ "ovtm_untp_shnu_rsqn": "0",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.02",
+ "stck_prpr": "18365",
+ "acml_vol": "4438",
+ "bidp": "18300",
+ "askp": "18365"
+ },
+ {
+ "mksc_shrn_iscd": "368970",
+ "hts_kor_isnm": "오에스피",
+ "ovtm_untp_prpr": "4665",
+ "ovtm_untp_prdy_vrss": "225",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "5.07",
+ "ovtm_untp_askp1": "4565",
+ "ovtm_untp_seln_rsqn": "1134",
+ "ovtm_untp_bidp1": "4360",
+ "ovtm_untp_shnu_rsqn": "1418",
+ "ovtm_untp_vol": "21",
+ "ovtm_vrss_acml_vol_rlim": "0.32",
+ "stck_prpr": "4420",
+ "acml_vol": "6585",
+ "bidp": "4410",
+ "askp": "4420"
+ },
+ {
+ "mksc_shrn_iscd": "079950",
+ "hts_kor_isnm": "인베니아",
+ "ovtm_untp_prpr": "1150",
+ "ovtm_untp_prdy_vrss": "55",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "5.02",
+ "ovtm_untp_askp1": "1150",
+ "ovtm_untp_seln_rsqn": "8268",
+ "ovtm_untp_bidp1": "1095",
+ "ovtm_untp_shnu_rsqn": "2322",
+ "ovtm_untp_vol": "109",
+ "ovtm_vrss_acml_vol_rlim": "0.77",
+ "stck_prpr": "1084",
+ "acml_vol": "14193",
+ "bidp": "1084",
+ "askp": "1090"
+ },
+ {
+ "mksc_shrn_iscd": "214260",
+ "hts_kor_isnm": "라파스",
+ "ovtm_untp_prpr": "13970",
+ "ovtm_untp_prdy_vrss": "650",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "4.88",
+ "ovtm_untp_askp1": "13960",
+ "ovtm_untp_seln_rsqn": "618",
+ "ovtm_untp_bidp1": "13330",
+ "ovtm_untp_shnu_rsqn": "468",
+ "ovtm_untp_vol": "2",
+ "ovtm_vrss_acml_vol_rlim": "0.05",
+ "stck_prpr": "13460",
+ "acml_vol": "4348",
+ "bidp": "13350",
+ "askp": "13450"
+ },
+ {
+ "mksc_shrn_iscd": "126640",
+ "hts_kor_isnm": "화신정공",
+ "ovtm_untp_prpr": "1502",
+ "ovtm_untp_prdy_vrss": "69",
+ "ovtm_untp_prdy_vrss_sign": "2",
+ "ovtm_untp_prdy_ctrt": "4.82",
+ "ovtm_untp_askp1": "1499",
+ "ovtm_untp_seln_rsqn": "2789",
+ "ovtm_untp_bidp1": "1435",
+ "ovtm_untp_shnu_rsqn": "5500",
+ "ovtm_untp_vol": "1",
+ "ovtm_vrss_acml_vol_rlim": "0.00",
+ "stck_prpr": "1445",
+ "acml_vol": "32541",
+ "bidp": "1445",
+ "askp": "1450"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/110_국내주식-114_프로그램매매-종합현황시간.md b/docs/broker/kis/rest/국내주식/시세분석/110_국내주식-114_프로그램매매-종합현황시간.md
new file mode 100644
index 0000000..6a08fa1
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/110_국내주식-114_프로그램매매-종합현황시간.md
@@ -0,0 +1,624 @@
+# 프로그램매매 종합현황(시간)
+
+- 원본 시트명: 프로그램매매 종합현황(시간)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-114
+- HTTP Method: GET
+- 실전 TR_ID: FHPPG04600101
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/comp-program-trade-today
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+프로그램매매 종합현황(시간) API입니다.
+한국투자 HTS(eFriend Plus) > [0460] 프로그램매매 종합현황 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 장시간(09:00~15:30) 동안의 최근 30분간의 데이터 확인이 가능하며, 다음조회가 불가합니다.
+※ 장시간(09:00~15:30) 이후에는 bsop_hour 에 153000 ~ 170000 까지의 시간데이터가 출력되지만 데이터는 모두 동일한 장마감 데이터인 점 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)FHPPG04600100 → (신)FHPPG04600101' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 시장 분류 코드 | string | Y | 2 | KRX : J , NXT : NX, 통합 : UN |
+| FID_MRKT_CLS_CODE | 시장 구분 코드 | string | Y | 2 | K:코스피, Q:코스닥 |
+| FID_SCTN_CLS_CODE | 구간 구분 코드 | string | Y | 2 | 공백 입력 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 공백 입력 |
+| FID_COND_MRKT_DIV_CODE1 | 시장 분류코드1 | string | Y | 2 | 공백 입력 |
+| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업 시간 | string | Y | 6 | |
+| arbt_smtn_seln_tr_pbmn | 차익 합계 매도 거래 대금 | string | Y | 18 | |
+| arbt_smtm_seln_tr_pbmn_rate | 차익 합계 매도 거래대금 비율 | string | Y | 72 | |
+| arbt_smtn_shnu_tr_pbmn | 차익 합계 매수2 거래 대금 | string | Y | 18 | |
+| arbt_smtm_shun_tr_pbmn_rate | 차익합계매수거래대금비율 | string | Y | 72 | |
+| nabt_smtn_seln_tr_pbmn | 비차익 합계 매도 거래 대금 | string | Y | 18 | |
+| nabt_smtm_seln_tr_pbmn_rate | 비차익 합계 매도 거래대금 비율 | string | Y | 72 | |
+| nabt_smtn_shnu_tr_pbmn | 비차익 합계 매수2 거래 대금 | string | Y | 18 | |
+| nabt_smtm_shun_tr_pbmn_rate | 비차익합계매수거래대금비율 | string | Y | 72 | |
+| arbt_smtn_ntby_tr_pbmn | 차익 합계 순매수 거래 대금 | string | Y | 18 | |
+| arbt_smtm_ntby_tr_pbmn_rate | 차익 합계 순매수 거래대금 비율 | string | Y | 72 | |
+| nabt_smtn_ntby_tr_pbmn | 비차익 합계 순매수 거래 대금 | string | Y | 18 | |
+| nabt_smtm_ntby_tr_pbmn_rate | 비차익 합계 순매수 거래대금 비 | string | Y | 72 | |
+| whol_smtn_ntby_tr_pbmn | 전체 합계 순매수 거래 대금 | string | Y | 18 | |
+| whol_ntby_tr_pbmn_rate | 전체 순매수 거래대금 비율 | string | Y | 72 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_MRKT_CLS_CODE:Q
+FID_SCTN_CLS_CODE:1
+FID_INPUT_ISCD:
+FID_COND_MRKT_DIV_CODE1:
+FID_INPUT_HOUR_1:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_hour": "170000",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981823",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859384",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136289",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165900",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165800",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165700",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165600",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165500",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165400",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165300",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165200",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165100",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "165000",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981818",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859379",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136284",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164900",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164800",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164700",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164600",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164500",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164400",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164300",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164200",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164100",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "164000",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122439",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981808",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859370",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136274",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163900",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163800",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163700",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163600",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163500",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163400",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163300",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163200",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ },
+ {
+ "bsop_hour": "163100",
+ "arbt_smtn_seln_tr_pbmn": "63370",
+ "arbt_smtm_seln_tr_pbmn_rate": "0.58",
+ "arbt_smtn_shnu_tr_pbmn": "340275",
+ "arbt_smtm_shun_tr_pbmn_rate": "3.11",
+ "nabt_smtn_seln_tr_pbmn": "2122437",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.40",
+ "nabt_smtn_shnu_tr_pbmn": "2981781",
+ "nabt_smtm_shun_tr_pbmn_rate": "27.25",
+ "arbt_smtn_ntby_tr_pbmn": "276905",
+ "arbt_smtm_ntby_tr_pbmn_rate": "2.53",
+ "nabt_smtn_ntby_tr_pbmn": "859343",
+ "nabt_smtm_ntby_tr_pbmn_rate": "7.85",
+ "whol_smtn_ntby_tr_pbmn": "1136248",
+ "whol_ntby_tr_pbmn_rate": "10.39"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/111_국내주식-110_국내주식-신용잔고-일별추이.md b/docs/broker/kis/rest/국내주식/시세분석/111_국내주식-110_국내주식-신용잔고-일별추이.md
new file mode 100644
index 0000000..ca2362a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/111_국내주식-110_국내주식-신용잔고-일별추이.md
@@ -0,0 +1,960 @@
+# 국내주식 신용잔고 일별추이
+
+- 원본 시트명: 국내주식 신용잔고 일별추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-110
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04760000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/daily-credit-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 신용잔고 일별추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0476] 국내주식 신용잔고 일별추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+한 번의 호출에 최대 30건 확인 가능하며, fid_input_date_1 을 입력하여 다음 조회가 가능합니다.
+
+※ 상환수량은 "매도상환수량+현금상환수량"의 합계 수치입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04760000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_cond_mrkt_div_code | 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| fid_cond_scr_div_code | 화면 분류 코드 | string | Y | 5 | Unique key(20476) |
+| fid_input_iscd | 종목코드 | string | Y | 12 | 종목코드 (ex 005930) |
+| fid_input_date_1 | 결제일자 | string | Y | 10 | 결제일자 (ex 20240313) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| deal_date | 매매 일자 | string | Y | 8 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| stlm_date | 결제 일자 | string | Y | 8 | |
+| whol_loan_new_stcn | 전체 융자 신규 주수 | string | Y | 18 | 단위: 주 |
+| whol_loan_rdmp_stcn | 전체 융자 상환 주수 | string | Y | 18 | 단위: 주 |
+| whol_loan_rmnd_stcn | 전체 융자 잔고 주수 | string | Y | 18 | 단위: 주 |
+| whol_loan_new_amt | 전체 융자 신규 금액 | string | Y | 18 | 단위: 만원 |
+| whol_loan_rdmp_amt | 전체 융자 상환 금액 | string | Y | 18 | 단위: 만원 |
+| whol_loan_rmnd_amt | 전체 융자 잔고 금액 | string | Y | 18 | 단위: 만원 |
+| whol_loan_rmnd_rate | 전체 융자 잔고 비율 | string | Y | 84 | |
+| whol_loan_gvrt | 전체 융자 공여율 | string | Y | 82 | |
+| whol_stln_new_stcn | 전체 대주 신규 주수 | string | Y | 18 | 단위: 주 |
+| whol_stln_rdmp_stcn | 전체 대주 상환 주수 | string | Y | 18 | 단위: 주 |
+| whol_stln_rmnd_stcn | 전체 대주 잔고 주수 | string | Y | 18 | 단위: 주 |
+| whol_stln_new_amt | 전체 대주 신규 금액 | string | Y | 18 | 단위: 만원 |
+| whol_stln_rdmp_amt | 전체 대주 상환 금액 | string | Y | 18 | 단위: 만원 |
+| whol_stln_rmnd_amt | 전체 대주 잔고 금액 | string | Y | 18 | 단위: 만원 |
+| whol_stln_rmnd_rate | 전체 대주 잔고 비율 | string | Y | 84 | |
+| whol_stln_gvrt | 전체 대주 공여율 | string | Y | 82 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20476",
+"fid_input_iscd":"005930",
+"fid_input_date_1":"20240315"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "deal_date": "20240313",
+ "stck_prpr": "74100",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "800",
+ "prdy_ctrt": "1.09",
+ "acml_vol": "15243134",
+ "stlm_date": "20240315",
+ "whol_loan_new_stcn": "253817",
+ "whol_loan_rdmp_stcn": "603451",
+ "whol_loan_rmnd_stcn": "7155720",
+ "whol_loan_new_amt": "1678904",
+ "whol_loan_rdmp_amt": "3982732",
+ "whol_loan_rmnd_amt": "47321639",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "1.65",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6861",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43104",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73700",
+ "stck_hgpr": "74100",
+ "stck_lwpr": "73500"
+ },
+ {
+ "deal_date": "20240312",
+ "stck_prpr": "73300",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "900",
+ "prdy_ctrt": "1.24",
+ "acml_vol": "13011654",
+ "stlm_date": "20240314",
+ "whol_loan_new_stcn": "357971",
+ "whol_loan_rdmp_stcn": "429002",
+ "whol_loan_rmnd_stcn": "7507526",
+ "whol_loan_new_amt": "2370294",
+ "whol_loan_rdmp_amt": "2871401",
+ "whol_loan_rmnd_amt": "49639923",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "2.74",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6861",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43104",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72600",
+ "stck_hgpr": "73500",
+ "stck_lwpr": "72100"
+ },
+ {
+ "deal_date": "20240311",
+ "stck_prpr": "72400",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-900",
+ "prdy_ctrt": "-1.23",
+ "acml_vol": "9740504",
+ "stlm_date": "20240313",
+ "whol_loan_new_stcn": "395234",
+ "whol_loan_rdmp_stcn": "242330",
+ "whol_loan_rmnd_stcn": "7586197",
+ "whol_loan_new_amt": "2579480",
+ "whol_loan_rdmp_amt": "1479272",
+ "whol_loan_rmnd_amt": "50194590",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "4.05",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6861",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43104",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72900",
+ "stck_hgpr": "73100",
+ "stck_lwpr": "72300"
+ },
+ {
+ "deal_date": "20240308",
+ "stck_prpr": "73300",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1100",
+ "prdy_ctrt": "1.52",
+ "acml_vol": "19271349",
+ "stlm_date": "20240312",
+ "whol_loan_new_stcn": "350421",
+ "whol_loan_rdmp_stcn": "580071",
+ "whol_loan_rmnd_stcn": "7433714",
+ "whol_loan_new_amt": "2212537",
+ "whol_loan_rdmp_amt": "3786566",
+ "whol_loan_rmnd_amt": "49096831",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "1.81",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6861",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43104",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72800",
+ "stck_hgpr": "73400",
+ "stck_lwpr": "72600"
+ },
+ {
+ "deal_date": "20240307",
+ "stck_prpr": "72200",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-700",
+ "prdy_ctrt": "-0.96",
+ "acml_vol": "14516963",
+ "stlm_date": "20240311",
+ "whol_loan_new_stcn": "497407",
+ "whol_loan_rdmp_stcn": "252707",
+ "whol_loan_rmnd_stcn": "7666721",
+ "whol_loan_new_amt": "3207234",
+ "whol_loan_rdmp_amt": "1692347",
+ "whol_loan_rmnd_amt": "50691156",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "3.42",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "1",
+ "whol_stln_rmnd_stcn": "6861",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "7",
+ "whol_stln_rmnd_amt": "43104",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73100",
+ "stck_hgpr": "73300",
+ "stck_lwpr": "72200"
+ },
+ {
+ "deal_date": "20240306",
+ "stck_prpr": "72900",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-800",
+ "prdy_ctrt": "-1.09",
+ "acml_vol": "21547905",
+ "stlm_date": "20240308",
+ "whol_loan_new_stcn": "619036",
+ "whol_loan_rdmp_stcn": "176578",
+ "whol_loan_rmnd_stcn": "7424246",
+ "whol_loan_new_amt": "4069217",
+ "whol_loan_rdmp_amt": "1148738",
+ "whol_loan_rmnd_amt": "49189736",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "2.87",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6862",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43111",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73200",
+ "stck_hgpr": "73500",
+ "stck_lwpr": "72700"
+ },
+ {
+ "deal_date": "20240305",
+ "stck_prpr": "73700",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-1200",
+ "prdy_ctrt": "-1.60",
+ "acml_vol": "19505125",
+ "stlm_date": "20240307",
+ "whol_loan_new_stcn": "422627",
+ "whol_loan_rdmp_stcn": "301232",
+ "whol_loan_rmnd_stcn": "6981765",
+ "whol_loan_new_amt": "2822363",
+ "whol_loan_rdmp_amt": "1986157",
+ "whol_loan_rmnd_amt": "46269511",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "2.15",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "20",
+ "whol_stln_rmnd_stcn": "6862",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "139",
+ "whol_stln_rmnd_amt": "43111",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74600",
+ "stck_hgpr": "74800",
+ "stck_lwpr": "73700"
+ },
+ {
+ "deal_date": "20240304",
+ "stck_prpr": "74900",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1500",
+ "prdy_ctrt": "2.04",
+ "acml_vol": "23210474",
+ "stlm_date": "20240306",
+ "whol_loan_new_stcn": "838785",
+ "whol_loan_rdmp_stcn": "1450926",
+ "whol_loan_rmnd_stcn": "6862995",
+ "whol_loan_new_amt": "5536867",
+ "whol_loan_rdmp_amt": "9135415",
+ "whol_loan_rmnd_amt": "45449103",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "3.61",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74300",
+ "stck_hgpr": "75000",
+ "stck_lwpr": "74000"
+ },
+ {
+ "deal_date": "20240229",
+ "stck_prpr": "73400",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "200",
+ "prdy_ctrt": "0.27",
+ "acml_vol": "21176403",
+ "stlm_date": "20240305",
+ "whol_loan_new_stcn": "563158",
+ "whol_loan_rdmp_stcn": "330265",
+ "whol_loan_rmnd_stcn": "7477578",
+ "whol_loan_new_amt": "3366177",
+ "whol_loan_rdmp_amt": "2109787",
+ "whol_loan_rmnd_amt": "49063520",
+ "whol_loan_rmnd_rate": "0.12",
+ "whol_loan_gvrt": "2.65",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72600",
+ "stck_hgpr": "73400",
+ "stck_lwpr": "72000"
+ },
+ {
+ "deal_date": "20240228",
+ "stck_prpr": "73200",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "11795859",
+ "stlm_date": "20240304",
+ "whol_loan_new_stcn": "506896",
+ "whol_loan_rdmp_stcn": "458211",
+ "whol_loan_rmnd_stcn": "7245825",
+ "whol_loan_new_amt": "3059090",
+ "whol_loan_rdmp_amt": "2956451",
+ "whol_loan_rmnd_amt": "47813948",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "4.29",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72900",
+ "stck_hgpr": "73900",
+ "stck_lwpr": "72800"
+ },
+ {
+ "deal_date": "20240227",
+ "stck_prpr": "72900",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "13201981",
+ "stlm_date": "20240229",
+ "whol_loan_new_stcn": "319365",
+ "whol_loan_rdmp_stcn": "291088",
+ "whol_loan_rmnd_stcn": "7199469",
+ "whol_loan_new_amt": "2086955",
+ "whol_loan_rdmp_amt": "1907718",
+ "whol_loan_rmnd_amt": "47725597",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "2.41",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73100",
+ "stck_hgpr": "73400",
+ "stck_lwpr": "72700"
+ },
+ {
+ "deal_date": "20240226",
+ "stck_prpr": "72800",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-100",
+ "prdy_ctrt": "-0.14",
+ "acml_vol": "14669352",
+ "stlm_date": "20240228",
+ "whol_loan_new_stcn": "282018",
+ "whol_loan_rdmp_stcn": "261288",
+ "whol_loan_rmnd_stcn": "7171604",
+ "whol_loan_new_amt": "1838364",
+ "whol_loan_rdmp_amt": "1639156",
+ "whol_loan_rmnd_amt": "47549260",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "1.91",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72300",
+ "stck_hgpr": "73200",
+ "stck_lwpr": "72200"
+ },
+ {
+ "deal_date": "20240223",
+ "stck_prpr": "72900",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-200",
+ "prdy_ctrt": "-0.27",
+ "acml_vol": "16225166",
+ "stlm_date": "20240227",
+ "whol_loan_new_stcn": "526563",
+ "whol_loan_rdmp_stcn": "473526",
+ "whol_loan_rmnd_stcn": "7151330",
+ "whol_loan_new_amt": "3397702",
+ "whol_loan_rdmp_amt": "3122338",
+ "whol_loan_rmnd_amt": "47353285",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "3.23",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73600",
+ "stck_hgpr": "74200",
+ "stck_lwpr": "72900"
+ },
+ {
+ "deal_date": "20240222",
+ "stck_prpr": "73100",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "15208934",
+ "stlm_date": "20240226",
+ "whol_loan_new_stcn": "617034",
+ "whol_loan_rdmp_stcn": "362458",
+ "whol_loan_rmnd_stcn": "7098784",
+ "whol_loan_new_amt": "4055099",
+ "whol_loan_rdmp_amt": "2420852",
+ "whol_loan_rmnd_amt": "47080801",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "4.05",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73800",
+ "stck_hgpr": "73900",
+ "stck_lwpr": "72700"
+ },
+ {
+ "deal_date": "20240221",
+ "stck_prpr": "73000",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-300",
+ "prdy_ctrt": "-0.41",
+ "acml_vol": "11503495",
+ "stlm_date": "20240223",
+ "whol_loan_new_stcn": "181753",
+ "whol_loan_rdmp_stcn": "159505",
+ "whol_loan_rmnd_stcn": "6849915",
+ "whol_loan_new_amt": "1154019",
+ "whol_loan_rdmp_amt": "997307",
+ "whol_loan_rmnd_amt": "45485001",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "1.57",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73400",
+ "stck_hgpr": "73700",
+ "stck_lwpr": "72900"
+ },
+ {
+ "deal_date": "20240220",
+ "stck_prpr": "73300",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-500",
+ "prdy_ctrt": "-0.68",
+ "acml_vol": "14681477",
+ "stlm_date": "20240222",
+ "whol_loan_new_stcn": "245659",
+ "whol_loan_rdmp_stcn": "162302",
+ "whol_loan_rmnd_stcn": "6827253",
+ "whol_loan_new_amt": "1650740",
+ "whol_loan_rdmp_amt": "1053242",
+ "whol_loan_rmnd_amt": "45325256",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "1.66",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "100",
+ "whol_stln_rmnd_stcn": "6882",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "699",
+ "whol_stln_rmnd_amt": "43251",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73700",
+ "stck_hgpr": "73700",
+ "stck_lwpr": "72800"
+ },
+ {
+ "deal_date": "20240219",
+ "stck_prpr": "73800",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1000",
+ "prdy_ctrt": "1.37",
+ "acml_vol": "12726404",
+ "stlm_date": "20240221",
+ "whol_loan_new_stcn": "196561",
+ "whol_loan_rdmp_stcn": "395332",
+ "whol_loan_rmnd_stcn": "6746234",
+ "whol_loan_new_amt": "1233245",
+ "whol_loan_rdmp_amt": "2617252",
+ "whol_loan_rmnd_amt": "44744474",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "1.53",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "15",
+ "whol_stln_rmnd_stcn": "6982",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "105",
+ "whol_stln_rmnd_amt": "43950",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "72800",
+ "stck_hgpr": "73900",
+ "stck_lwpr": "72800"
+ },
+ {
+ "deal_date": "20240216",
+ "stck_prpr": "72800",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-200",
+ "prdy_ctrt": "-0.27",
+ "acml_vol": "13444781",
+ "stlm_date": "20240220",
+ "whol_loan_new_stcn": "353711",
+ "whol_loan_rdmp_stcn": "258304",
+ "whol_loan_rmnd_stcn": "6946822",
+ "whol_loan_new_amt": "2336237",
+ "whol_loan_rdmp_amt": "1746554",
+ "whol_loan_rmnd_amt": "46141630",
+ "whol_loan_rmnd_rate": "0.11",
+ "whol_loan_gvrt": "2.63",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6997",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "44055",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73300",
+ "stck_hgpr": "73400",
+ "stck_lwpr": "72500"
+ },
+ {
+ "deal_date": "20240215",
+ "stck_prpr": "73000",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-1000",
+ "prdy_ctrt": "-1.35",
+ "acml_vol": "14120600",
+ "stlm_date": "20240219",
+ "whol_loan_new_stcn": "668521",
+ "whol_loan_rdmp_stcn": "244617",
+ "whol_loan_rmnd_stcn": "6851613",
+ "whol_loan_new_amt": "4541397",
+ "whol_loan_rdmp_amt": "1581331",
+ "whol_loan_rmnd_amt": "45553486",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "4.72",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6997",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "44055",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74200",
+ "stck_hgpr": "74400",
+ "stck_lwpr": "73000"
+ },
+ {
+ "deal_date": "20240214",
+ "stck_prpr": "74000",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-1200",
+ "prdy_ctrt": "-1.60",
+ "acml_vol": "12434945",
+ "stlm_date": "20240216",
+ "whol_loan_new_stcn": "607994",
+ "whol_loan_rdmp_stcn": "168766",
+ "whol_loan_rmnd_stcn": "6428256",
+ "whol_loan_new_amt": "4042856",
+ "whol_loan_rdmp_amt": "1140083",
+ "whol_loan_rmnd_amt": "42597320",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "4.88",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "6997",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "44055",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73700",
+ "stck_hgpr": "74300",
+ "stck_lwpr": "73700"
+ },
+ {
+ "deal_date": "20240213",
+ "stck_prpr": "75200",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1100",
+ "prdy_ctrt": "1.48",
+ "acml_vol": "21966745",
+ "stlm_date": "20240215",
+ "whol_loan_new_stcn": "510482",
+ "whol_loan_rdmp_stcn": "766361",
+ "whol_loan_rmnd_stcn": "5989340",
+ "whol_loan_new_amt": "2751983",
+ "whol_loan_rdmp_amt": "4536820",
+ "whol_loan_rmnd_amt": "39696538",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "2.32",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "139",
+ "whol_stln_rmnd_stcn": "6997",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "996",
+ "whol_stln_rmnd_amt": "44055",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74800",
+ "stck_hgpr": "75200",
+ "stck_lwpr": "74400"
+ },
+ {
+ "deal_date": "20240208",
+ "stck_prpr": "74100",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-900",
+ "prdy_ctrt": "-1.20",
+ "acml_vol": "20810708",
+ "stlm_date": "20240214",
+ "whol_loan_new_stcn": "943012",
+ "whol_loan_rdmp_stcn": "549849",
+ "whol_loan_rmnd_stcn": "6247522",
+ "whol_loan_new_amt": "5594562",
+ "whol_loan_rdmp_amt": "2907687",
+ "whol_loan_rmnd_amt": "41495520",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "4.52",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "1",
+ "whol_stln_rmnd_stcn": "7136",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "6",
+ "whol_stln_rmnd_amt": "45052",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "75000",
+ "stck_hgpr": "75200",
+ "stck_lwpr": "73600"
+ },
+ {
+ "deal_date": "20240207",
+ "stck_prpr": "75000",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "600",
+ "prdy_ctrt": "0.81",
+ "acml_vol": "16566445",
+ "stlm_date": "20240213",
+ "whol_loan_new_stcn": "252078",
+ "whol_loan_rdmp_stcn": "439983",
+ "whol_loan_rmnd_stcn": "5856240",
+ "whol_loan_new_amt": "1614166",
+ "whol_loan_rdmp_amt": "2860455",
+ "whol_loan_rmnd_amt": "38821115",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "1.51",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "7137",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "45059",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74600",
+ "stck_hgpr": "75500",
+ "stck_lwpr": "74300"
+ },
+ {
+ "deal_date": "20240206",
+ "stck_prpr": "74400",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "100",
+ "prdy_ctrt": "0.13",
+ "acml_vol": "14559254",
+ "stlm_date": "20240208",
+ "whol_loan_new_stcn": "295323",
+ "whol_loan_rdmp_stcn": "281735",
+ "whol_loan_rmnd_stcn": "6045644",
+ "whol_loan_new_amt": "1941262",
+ "whol_loan_rdmp_amt": "1889253",
+ "whol_loan_rmnd_amt": "40074751",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "2.02",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "0",
+ "whol_stln_rmnd_stcn": "7137",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "0",
+ "whol_stln_rmnd_amt": "45059",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74300",
+ "stck_hgpr": "74700",
+ "stck_lwpr": "73300"
+ },
+ {
+ "deal_date": "20240205",
+ "stck_prpr": "74300",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-900",
+ "prdy_ctrt": "-1.20",
+ "acml_vol": "19026021",
+ "stlm_date": "20240207",
+ "whol_loan_new_stcn": "580976",
+ "whol_loan_rdmp_stcn": "315236",
+ "whol_loan_rmnd_stcn": "6035531",
+ "whol_loan_new_amt": "3882685",
+ "whol_loan_rdmp_amt": "2127798",
+ "whol_loan_rmnd_amt": "40047278",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "3.04",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "728",
+ "whol_stln_rmnd_stcn": "7137",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "5099",
+ "whol_stln_rmnd_amt": "45059",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74200",
+ "stck_hgpr": "74800",
+ "stck_lwpr": "73500"
+ },
+ {
+ "deal_date": "20240202",
+ "stck_prpr": "75200",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1600",
+ "prdy_ctrt": "2.17",
+ "acml_vol": "14955881",
+ "stlm_date": "20240206",
+ "whol_loan_new_stcn": "227532",
+ "whol_loan_rdmp_stcn": "559999",
+ "whol_loan_rmnd_stcn": "5770153",
+ "whol_loan_new_amt": "1423587",
+ "whol_loan_rdmp_amt": "3552220",
+ "whol_loan_rmnd_amt": "38294939",
+ "whol_loan_rmnd_rate": "0.08",
+ "whol_loan_gvrt": "1.52",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "8",
+ "whol_stln_rmnd_stcn": "7865",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "55",
+ "whol_stln_rmnd_amt": "50158",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "74000",
+ "stck_hgpr": "75200",
+ "stck_lwpr": "73700"
+ },
+ {
+ "deal_date": "20240201",
+ "stck_prpr": "73600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "900",
+ "prdy_ctrt": "1.24",
+ "acml_vol": "19881033",
+ "stlm_date": "20240205",
+ "whol_loan_new_stcn": "340408",
+ "whol_loan_rdmp_stcn": "432474",
+ "whol_loan_rmnd_stcn": "6103384",
+ "whol_loan_new_amt": "2222626",
+ "whol_loan_rdmp_amt": "2835418",
+ "whol_loan_rmnd_amt": "40428694",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "1.70",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "347",
+ "whol_stln_rmnd_stcn": "7873",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "2376",
+ "whol_stln_rmnd_amt": "50214",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73000",
+ "stck_hgpr": "74200",
+ "stck_lwpr": "72900"
+ },
+ {
+ "deal_date": "20240131",
+ "stck_prpr": "72700",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-1600",
+ "prdy_ctrt": "-2.15",
+ "acml_vol": "15703560",
+ "stlm_date": "20240202",
+ "whol_loan_new_stcn": "401245",
+ "whol_loan_rdmp_stcn": "234735",
+ "whol_loan_rmnd_stcn": "6207574",
+ "whol_loan_new_amt": "2627294",
+ "whol_loan_rdmp_amt": "1541985",
+ "whol_loan_rmnd_amt": "41122407",
+ "whol_loan_rmnd_rate": "0.10",
+ "whol_loan_gvrt": "2.55",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "30",
+ "whol_stln_rmnd_stcn": "8220",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "204",
+ "whol_stln_rmnd_amt": "52590",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73400",
+ "stck_hgpr": "74000",
+ "stck_lwpr": "72500"
+ },
+ {
+ "deal_date": "20240130",
+ "stck_prpr": "74300",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-100",
+ "prdy_ctrt": "-0.13",
+ "acml_vol": "12244418",
+ "stlm_date": "20240201",
+ "whol_loan_new_stcn": "308957",
+ "whol_loan_rdmp_stcn": "165640",
+ "whol_loan_rmnd_stcn": "6042179",
+ "whol_loan_new_amt": "1980096",
+ "whol_loan_rdmp_amt": "1089607",
+ "whol_loan_rmnd_amt": "40044649",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "2.51",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "894",
+ "whol_stln_rmnd_stcn": "8250",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "5983",
+ "whol_stln_rmnd_amt": "52795",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "75000",
+ "stck_hgpr": "75300",
+ "stck_lwpr": "73700"
+ },
+ {
+ "deal_date": "20240129",
+ "stck_prpr": "74400",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1000",
+ "prdy_ctrt": "1.36",
+ "acml_vol": "13976521",
+ "stlm_date": "20240131",
+ "whol_loan_new_stcn": "207309",
+ "whol_loan_rdmp_stcn": "415351",
+ "whol_loan_rmnd_stcn": "5901536",
+ "whol_loan_new_amt": "1397554",
+ "whol_loan_rdmp_amt": "2745405",
+ "whol_loan_rmnd_amt": "39169933",
+ "whol_loan_rmnd_rate": "0.09",
+ "whol_loan_gvrt": "1.47",
+ "whol_stln_new_stcn": "0",
+ "whol_stln_rdmp_stcn": "39",
+ "whol_stln_rmnd_stcn": "9144",
+ "whol_stln_new_amt": "0",
+ "whol_stln_rdmp_amt": "261",
+ "whol_stln_rmnd_amt": "58779",
+ "whol_stln_rmnd_rate": "0.00",
+ "whol_stln_gvrt": "0.00",
+ "stck_oprc": "73800",
+ "stck_hgpr": "75200",
+ "stck_lwpr": "73500"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/112_국내주식-075_시장별-투자자매매동향일별.md b/docs/broker/kis/rest/국내주식/시세분석/112_국내주식-075_시장별-투자자매매동향일별.md
new file mode 100644
index 0000000..49cea3c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/112_국내주식-075_시장별-투자자매매동향일별.md
@@ -0,0 +1,212 @@
+# 시장별 투자자매매동향(일별)
+
+- 원본 시트명: 시장별 투자자매매동향(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-075
+- HTTP Method: GET
+- 실전 TR_ID: FHPTJ04040000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-investor-daily-by-market
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+시장별 투자자매매동향(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0404] 시장별 일별동향 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPTJ04040000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 코스피, 코스닥 : 업종분류코드 (종목정보파일 - 업종코드 참조) |
+| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 10 | ex. 20240517 |
+| FID_INPUT_ISCD_1 | 입력 종목코드 | string | Y | 12 | 코스피(KSP), 코스닥(KSQ) |
+| FID_INPUT_DATE_2 | 입력 날짜2 | string | Y | 10 | 입력 날짜1과 동일날짜 입력 |
+| FID_INPUT_ISCD_2 | 하위 분류코드 | string | Y | 10 | 코스피, 코스닥 : 업종분류코드 (종목정보파일 - 업종코드 참조) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| frgn_reg_ntby_qty | 외국인 등록 순매수 수량 | string | Y | 18 | |
+| frgn_nreg_ntby_qty | 외국인 비등록 순매수 수량 | string | Y | 18 | |
+| prsn_ntby_qty | 개인 순매수 수량 | string | Y | 12 | |
+| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
+| scrt_ntby_qty | 증권 순매수 수량 | string | Y | 12 | |
+| ivtr_ntby_qty | 투자신탁 순매수 수량 | string | Y | 12 | |
+| pe_fund_ntby_vol | 사모 펀드 순매수 거래량 | string | Y | 18 | |
+| bank_ntby_qty | 은행 순매수 수량 | string | Y | 12 | |
+| insu_ntby_qty | 보험 순매수 수량 | string | Y | 12 | |
+| mrbn_ntby_qty | 종금 순매수 수량 | string | Y | 12 | |
+| fund_ntby_qty | 기금 순매수 수량 | string | Y | 12 | |
+| etc_ntby_qty | 기타 순매수 수량 | string | Y | 12 | |
+| etc_orgt_ntby_vol | 기타 단체 순매수 거래량 | string | Y | 18 | |
+| etc_corp_ntby_vol | 기타 법인 순매수 거래량 | string | Y | 18 | |
+| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | |
+| frgn_reg_ntby_pbmn | 외국인 등록 순매수 대금 | string | Y | 18 | |
+| frgn_nreg_ntby_pbmn | 외국인 비등록 순매수 대금 | string | Y | 18 | |
+| prsn_ntby_tr_pbmn | 개인 순매수 거래 대금 | string | Y | 18 | |
+| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
+| scrt_ntby_tr_pbmn | 증권 순매수 거래 대금 | string | Y | 18 | |
+| ivtr_ntby_tr_pbmn | 투자신탁 순매수 거래 대금 | string | Y | 18 | |
+| pe_fund_ntby_tr_pbmn | 사모 펀드 순매수 거래 대금 | string | Y | 18 | |
+| bank_ntby_tr_pbmn | 은행 순매수 거래 대금 | string | Y | 18 | |
+| insu_ntby_tr_pbmn | 보험 순매수 거래 대금 | string | Y | 18 | |
+| mrbn_ntby_tr_pbmn | 종금 순매수 거래 대금 | string | Y | 18 | |
+| fund_ntby_tr_pbmn | 기금 순매수 거래 대금 | string | Y | 18 | |
+| etc_ntby_tr_pbmn | 기타 순매수 거래 대금 | string | Y | 18 | |
+| etc_orgt_ntby_tr_pbmn | 기타 단체 순매수 거래 대금 | string | Y | 18 | |
+| etc_corp_ntby_tr_pbmn | 기타 법인 순매수 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:U
+FID_INPUT_ISCD:0001
+FID_INPUT_DATE_1:20240517
+FID_INPUT_ISCD_1:KSP
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240517",
+ "bstp_nmix_prpr": "2724.62",
+ "bstp_nmix_prdy_vrss": "-28.38",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-1.03",
+ "bstp_nmix_oprc": "2751.47",
+ "bstp_nmix_hgpr": "2752.17",
+ "bstp_nmix_lwpr": "2724.62",
+ "stck_prdy_clpr": "2753.00",
+ "frgn_ntby_qty": "-18565",
+ "frgn_reg_ntby_qty": "-18009",
+ "frgn_nreg_ntby_qty": "-557",
+ "prsn_ntby_qty": "22524",
+ "orgn_ntby_qty": "-4738",
+ "scrt_ntby_qty": "-1148",
+ "ivtr_ntby_qty": "-609",
+ "pe_fund_ntby_vol": "-431",
+ "bank_ntby_qty": "103",
+ "insu_ntby_qty": "-156",
+ "mrbn_ntby_qty": "-175",
+ "fund_ntby_qty": "-2322",
+ "etc_ntby_qty": "779",
+ "etc_orgt_ntby_vol": "0",
+ "etc_corp_ntby_vol": "779",
+ "frgn_ntby_tr_pbmn": "-597490",
+ "frgn_reg_ntby_pbmn": "-597676",
+ "frgn_nreg_ntby_pbmn": "186",
+ "prsn_ntby_tr_pbmn": "720787",
+ "orgn_ntby_tr_pbmn": "-150685",
+ "scrt_ntby_tr_pbmn": "-18893",
+ "ivtr_ntby_tr_pbmn": "-7246",
+ "pe_fund_ntby_tr_pbmn": "-25668",
+ "bank_ntby_tr_pbmn": "3326",
+ "insu_ntby_tr_pbmn": "-13791",
+ "mrbn_ntby_tr_pbmn": "-2742",
+ "fund_ntby_tr_pbmn": "-85671",
+ "etc_ntby_tr_pbmn": "27388",
+ "etc_orgt_ntby_tr_pbmn": "0",
+ "etc_corp_ntby_tr_pbmn": "27388"
+ },
+ {
+ "stck_bsop_date": "20240516",
+ "bstp_nmix_prpr": "2753.00",
+ "bstp_nmix_prdy_vrss": "22.66",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.83",
+ "bstp_nmix_oprc": "2770.27",
+ "bstp_nmix_hgpr": "2773.46",
+ "bstp_nmix_lwpr": "2748.22",
+ "stck_prdy_clpr": "2730.34",
+ "frgn_ntby_qty": "5326",
+ "frgn_reg_ntby_qty": "5287",
+ "frgn_nreg_ntby_qty": "38",
+ "prsn_ntby_qty": "-14059",
+ "orgn_ntby_qty": "8886",
+ "scrt_ntby_qty": "11036",
+ "ivtr_ntby_qty": "359",
+ "pe_fund_ntby_vol": "850",
+ "bank_ntby_qty": "41",
+ "insu_ntby_qty": "-989",
+ "mrbn_ntby_qty": "-341",
+ "fund_ntby_qty": "-2070",
+ "etc_ntby_qty": "-153",
+ "etc_orgt_ntby_vol": "0",
+ "etc_corp_ntby_vol": "-153",
+ "frgn_ntby_tr_pbmn": "425869",
+ "frgn_reg_ntby_pbmn": "425686",
+ "frgn_nreg_ntby_pbmn": "183",
+ "prsn_ntby_tr_pbmn": "-964779",
+ "orgn_ntby_tr_pbmn": "593789",
+ "scrt_ntby_tr_pbmn": "680881",
+ "ivtr_ntby_tr_pbmn": "20139",
+ "pe_fund_ntby_tr_pbmn": "11277",
+ "bank_ntby_tr_pbmn": "-589",
+ "insu_ntby_tr_pbmn": "-29395",
+ "mrbn_ntby_tr_pbmn": "-19913",
+ "fund_ntby_tr_pbmn": "-68611",
+ "etc_ntby_tr_pbmn": "-54879",
+ "etc_orgt_ntby_tr_pbmn": "0",
+ "etc_corp_ntby_tr_pbmn": "-54879"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/113_국내주식-134_국내주식-공매도-일별추이.md b/docs/broker/kis/rest/국내주식/시세분석/113_국내주식-134_국내주식-공매도-일별추이.md
new file mode 100644
index 0000000..23b8cf3
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/113_국내주식-134_국내주식-공매도-일별추이.md
@@ -0,0 +1,98 @@
+# 국내주식 공매도 일별추이
+
+- 원본 시트명: 국내주식 공매도 일별추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-134
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04830000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지
+- URL 명: /uapi/domestic-stock/v1/quotations/daily-short-sale
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04830000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_DATE_2 | 입력 날짜2 | string | Y | 10 | ~ 누적 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 10 | 공백시 전체 (기간 ~) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| stnd_vol_smtn | 기준 거래량 합계 | string | Y | 18 | |
+| ssts_cntg_qty | 공매도 체결 수량 | string | Y | 12 | |
+| ssts_vol_rlim | 공매도 거래량 비중 | string | Y | 62 | |
+| acml_ssts_cntg_qty | 누적 공매도 체결 수량 | string | Y | 13 | |
+| acml_ssts_cntg_qty_rlim | 누적 공매도 체결 수량 비중 | string | Y | 72 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| stnd_tr_pbmn_smtn | 기준 거래대금 합계 | string | Y | 18 | |
+| ssts_tr_pbmn | 공매도 거래 대금 | string | Y | 18 | |
+| ssts_tr_pbmn_rlim | 공매도 거래대금 비중 | string | Y | 62 | |
+| acml_ssts_tr_pbmn | 누적 공매도 거래 대금 | string | Y | 19 | |
+| acml_ssts_tr_pbmn_rlim | 누적 공매도 거래 대금 비중 | string | Y | 72 | |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| avrg_prc | 평균가격 | string | Y | 11 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/시세분석/114_종목별-투자자매매동향일별_종목별-투자자매매동향일별.md b/docs/broker/kis/rest/국내주식/시세분석/114_종목별-투자자매매동향일별_종목별-투자자매매동향일별.md
new file mode 100644
index 0000000..b349360
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/114_종목별-투자자매매동향일별_종목별-투자자매매동향일별.md
@@ -0,0 +1,318 @@
+# 종목별 투자자매매동향(일별)
+
+- 원본 시트명: 종목별 투자자매매동향(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 종목별 투자자매매동향(일별)
+- HTTP Method: GET
+- 실전 TR_ID: FHPTJ04160001
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/investor-trade-by-stock-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목별 투자자매매동향(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0416] 종목별 일별동향 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 단위 : 금액(백만원) 수량(주)
+
+당일 데이터는 15:40이후에 데이터가 가집계 및 산출되어 15:40부터 조회가능하며,
+데이터 산출의 경우 산출 시간대는 일정하지 않을 수 있음을 참고 부탁드립니다.
+추가로 API를 통한 00:00 ~ 15:40 이외의 시간은 당일 조회가 제한되는 점 이용에 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPTJ04160001 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (6자리) |
+| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 10 | 입력 날짜(20250812) (해당일 조회는 장 종료 후 정상 조회 가능) |
+| FID_ORG_ADJ_PRC | 수정주가 원주가 가격 | string | Y | 2 | 공란 입력 |
+| FID_ETC_CLS_CODE | 기타 구분 코드 | string | Y | 2 | "1" 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | 단위 : 주 |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | 단위 : 백만원 |
+| stck_oprc | 주식 시가2 | string | Y | 10 | |
+| stck_hgpr | 주식 최고가 | string | Y | 10 | |
+| stck_lwpr | 주식 최저가 | string | Y | 10 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | 단위 : 주 |
+| frgn_reg_ntby_qty | 외국인 등록 순매수 수량 | string | Y | 18 | |
+| frgn_nreg_ntby_qty | 외국인 비등록 순매수 수량 | string | Y | 18 | |
+| prsn_ntby_qty | 개인 순매수 수량 | string | Y | 12 | |
+| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
+| scrt_ntby_qty | 증권 순매수 수량 | string | Y | 12 | |
+| ivtr_ntby_qty | 투자신탁 순매수 수량 | string | Y | 12 | |
+| pe_fund_ntby_vol | 사모 펀드 순매수 거래량 | string | Y | 18 | |
+| bank_ntby_qty | 은행 순매수 수량 | string | Y | 12 | |
+| insu_ntby_qty | 보험 순매수 수량 | string | Y | 12 | |
+| mrbn_ntby_qty | 종금 순매수 수량 | string | Y | 12 | |
+| fund_ntby_qty | 기금 순매수 수량 | string | Y | 12 | |
+| etc_ntby_qty | 기타 순매수 수량 | string | Y | 12 | |
+| etc_corp_ntby_vol | 기타 법인 순매수 거래량 | string | Y | 18 | |
+| etc_orgt_ntby_vol | 기타 단체 순매수 거래량 | string | Y | 18 | |
+| frgn_reg_ntby_pbmn | 외국인 등록 순매수 대금 | string | Y | 18 | 단위 : 백만원 |
+| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | |
+| frgn_nreg_ntby_pbmn | 외국인 비등록 순매수 대금 | string | Y | 18 | |
+| prsn_ntby_tr_pbmn | 개인 순매수 거래 대금 | string | Y | 18 | |
+| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
+| scrt_ntby_tr_pbmn | 증권 순매수 거래 대금 | string | Y | 18 | |
+| pe_fund_ntby_tr_pbmn | 사모 펀드 순매수 거래 대금 | string | Y | 18 | |
+| ivtr_ntby_tr_pbmn | 투자신탁 순매수 거래 대금 | string | Y | 18 | |
+| bank_ntby_tr_pbmn | 은행 순매수 거래 대금 | string | Y | 18 | |
+| insu_ntby_tr_pbmn | 보험 순매수 거래 대금 | string | Y | 18 | |
+| mrbn_ntby_tr_pbmn | 종금 순매수 거래 대금 | string | Y | 18 | |
+| fund_ntby_tr_pbmn | 기금 순매수 거래 대금 | string | Y | 18 | |
+| etc_ntby_tr_pbmn | 기타 순매수 거래 대금 | string | Y | 18 | |
+| etc_corp_ntby_tr_pbmn | 기타 법인 순매수 거래 대금 | string | Y | 18 | |
+| etc_orgt_ntby_tr_pbmn | 기타 단체 순매수 거래 대금 | string | Y | 18 | |
+| frgn_seln_vol | 외국인 매도 거래량 | string | Y | 18 | |
+| frgn_shnu_vol | 외국인 매수2 거래량 | string | Y | 18 | |
+| frgn_seln_tr_pbmn | 외국인 매도 거래 대금 | string | Y | 18 | |
+| frgn_shnu_tr_pbmn | 외국인 매수2 거래 대금 | string | Y | 18 | |
+| frgn_reg_askp_qty | 외국인 등록 매도 수량 | string | Y | 18 | |
+| frgn_reg_bidp_qty | 외국인 등록 매수 수량 | string | Y | 18 | |
+| frgn_reg_askp_pbmn | 외국인 등록 매도 대금 | string | Y | 18 | |
+| frgn_reg_bidp_pbmn | 외국인 등록 매수 대금 | string | Y | 18 | |
+| frgn_nreg_askp_qty | 외국인 비등록 매도 수량 | string | Y | 18 | |
+| frgn_nreg_bidp_qty | 외국인 비등록 매수 수량 | string | Y | 18 | |
+| frgn_nreg_askp_pbmn | 외국인 비등록 매도 대금 | string | Y | 18 | |
+| frgn_nreg_bidp_pbmn | 외국인 비등록 매수 대금 | string | Y | 18 | |
+| prsn_seln_vol | 개인 매도 거래량 | string | Y | 18 | |
+| prsn_shnu_vol | 개인 매수2 거래량 | string | Y | 18 | |
+| prsn_seln_tr_pbmn | 개인 매도 거래 대금 | string | Y | 18 | |
+| prsn_shnu_tr_pbmn | 개인 매수2 거래 대금 | string | Y | 18 | |
+| orgn_seln_vol | 기관계 매도 거래량 | string | Y | 18 | |
+| orgn_shnu_vol | 기관계 매수2 거래량 | string | Y | 18 | |
+| orgn_seln_tr_pbmn | 기관계 매도 거래 대금 | string | Y | 18 | |
+| orgn_shnu_tr_pbmn | 기관계 매수2 거래 대금 | string | Y | 18 | |
+| scrt_seln_vol | 증권 매도 거래량 | string | Y | 18 | |
+| scrt_shnu_vol | 증권 매수2 거래량 | string | Y | 18 | |
+| scrt_seln_tr_pbmn | 증권 매도 거래 대금 | string | Y | 18 | |
+| scrt_shnu_tr_pbmn | 증권 매수2 거래 대금 | string | Y | 18 | |
+| ivtr_seln_vol | 투자신탁 매도 거래량 | string | Y | 18 | |
+| ivtr_shnu_vol | 투자신탁 매수2 거래량 | string | Y | 18 | |
+| ivtr_seln_tr_pbmn | 투자신탁 매도 거래 대금 | string | Y | 18 | |
+| ivtr_shnu_tr_pbmn | 투자신탁 매수2 거래 대금 | string | Y | 18 | |
+| pe_fund_seln_tr_pbmn | 사모 펀드 매도 거래 대금 | string | Y | 18 | |
+| pe_fund_seln_vol | 사모 펀드 매도 거래량 | string | Y | 18 | |
+| pe_fund_shnu_tr_pbmn | 사모 펀드 매수2 거래 대금 | string | Y | 18 | |
+| pe_fund_shnu_vol | 사모 펀드 매수2 거래량 | string | Y | 18 | |
+| bank_seln_vol | 은행 매도 거래량 | string | Y | 18 | |
+| bank_shnu_vol | 은행 매수2 거래량 | string | Y | 18 | |
+| bank_seln_tr_pbmn | 은행 매도 거래 대금 | string | Y | 18 | |
+| bank_shnu_tr_pbmn | 은행 매수2 거래 대금 | string | Y | 18 | |
+| insu_seln_vol | 보험 매도 거래량 | string | Y | 18 | |
+| insu_shnu_vol | 보험 매수2 거래량 | string | Y | 18 | |
+| insu_seln_tr_pbmn | 보험 매도 거래 대금 | string | Y | 18 | |
+| insu_shnu_tr_pbmn | 보험 매수2 거래 대금 | string | Y | 18 | |
+| mrbn_seln_vol | 종금 매도 거래량 | string | Y | 18 | |
+| mrbn_shnu_vol | 종금 매수2 거래량 | string | Y | 18 | |
+| mrbn_seln_tr_pbmn | 종금 매도 거래 대금 | string | Y | 18 | |
+| mrbn_shnu_tr_pbmn | 종금 매수2 거래 대금 | string | Y | 18 | |
+| fund_seln_vol | 기금 매도 거래량 | string | Y | 18 | |
+| fund_shnu_vol | 기금 매수2 거래량 | string | Y | 18 | |
+| fund_seln_tr_pbmn | 기금 매도 거래 대금 | string | Y | 18 | |
+| fund_shnu_tr_pbmn | 기금 매수2 거래 대금 | string | Y | 18 | |
+| etc_seln_vol | 기타 매도 거래량 | string | Y | 18 | |
+| etc_shnu_vol | 기타 매수2 거래량 | string | Y | 18 | |
+| etc_seln_tr_pbmn | 기타 매도 거래 대금 | string | Y | 18 | |
+| etc_shnu_tr_pbmn | 기타 매수2 거래 대금 | string | Y | 18 | |
+| etc_orgt_seln_vol | 기타 단체 매도 거래량 | string | Y | 18 | |
+| etc_orgt_shnu_vol | 기타 단체 매수2 거래량 | string | Y | 18 | |
+| etc_orgt_seln_tr_pbmn | 기타 단체 매도 거래 대금 | string | Y | 18 | |
+| etc_orgt_shnu_tr_pbmn | 기타 단체 매수2 거래 대금 | string | Y | 18 | |
+| etc_corp_seln_vol | 기타 법인 매도 거래량 | string | Y | 18 | |
+| etc_corp_shnu_vol | 기타 법인 매수2 거래량 | string | Y | 18 | |
+| etc_corp_seln_tr_pbmn | 기타 법인 매도 거래 대금 | string | Y | 18 | |
+| etc_corp_shnu_tr_pbmn | 기타 법인 매수2 거래 대금 | string | Y | 18 | |
+| bold_yn | BOLD 여부 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_INPUT_ISCD:005930
+FID_INPUT_DATE_1:20250811
+FID_ORG_ADJ_PRC:
+FID_ETC_CLS_CODE:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "stck_prpr": "71100",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.14",
+ "acml_vol": "15797656",
+ "prdy_vol": "11354253",
+ "rprs_mrkt_kor_name": "KOSPI200"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20250811",
+ "stck_clpr": "71000",
+ "prdy_vrss": "-800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.11",
+ "acml_vol": "11354253",
+ "acml_tr_pbmn": "808470078650",
+ "stck_oprc": "72000",
+ "stck_hgpr": "72100",
+ "stck_lwpr": "70800",
+ "frgn_ntby_qty": "-2029800",
+ "frgn_reg_ntby_qty": "-2031350",
+ "frgn_nreg_ntby_qty": "1550",
+ "prsn_ntby_qty": "1686273",
+ "orgn_ntby_qty": "-571822",
+ "scrt_ntby_qty": "-44264",
+ "ivtr_ntby_qty": "-205974",
+ "pe_fund_ntby_vol": "-125032",
+ "bank_ntby_qty": "2930",
+ "insu_ntby_qty": "-85309",
+ "mrbn_ntby_qty": "-737",
+ "fund_ntby_qty": "-113436",
+ "etc_ntby_qty": "915349",
+ "etc_corp_ntby_vol": "915349",
+ "etc_orgt_ntby_vol": "0",
+ "frgn_reg_ntby_pbmn": "-144473",
+ "frgn_ntby_tr_pbmn": "-144363",
+ "frgn_nreg_ntby_pbmn": "110",
+ "prsn_ntby_tr_pbmn": "120110",
+ "orgn_ntby_tr_pbmn": "-40903",
+ "scrt_ntby_tr_pbmn": "-3169",
+ "pe_fund_ntby_tr_pbmn": "-8887",
+ "ivtr_ntby_tr_pbmn": "-14641",
+ "bank_ntby_tr_pbmn": "209",
+ "insu_ntby_tr_pbmn": "-6061",
+ "mrbn_ntby_tr_pbmn": "-52",
+ "fund_ntby_tr_pbmn": "-8301",
+ "etc_ntby_tr_pbmn": "65156",
+ "etc_corp_ntby_tr_pbmn": "65156",
+ "etc_orgt_ntby_tr_pbmn": "0",
+ "frgn_seln_vol": "4557311",
+ "frgn_shnu_vol": "2527511",
+ "frgn_seln_tr_pbmn": "324535",
+ "frgn_shnu_tr_pbmn": "180172",
+ "frgn_reg_askp_qty": "4550828",
+ "frgn_reg_bidp_qty": "2519478",
+ "frgn_reg_askp_pbmn": "324074",
+ "frgn_reg_bidp_pbmn": "179600",
+ "frgn_nreg_askp_qty": "6483",
+ "frgn_nreg_bidp_qty": "8033",
+ "frgn_nreg_askp_pbmn": "461",
+ "frgn_nreg_bidp_pbmn": "572",
+ "prsn_seln_vol": "2003849",
+ "prsn_shnu_vol": "3690122",
+ "prsn_seln_tr_pbmn": "142680",
+ "prsn_shnu_tr_pbmn": "262790",
+ "orgn_seln_vol": "4694042",
+ "orgn_shnu_vol": "4122220",
+ "orgn_seln_tr_pbmn": "334201",
+ "orgn_shnu_tr_pbmn": "293298",
+ "scrt_seln_vol": "444582",
+ "scrt_shnu_vol": "400318",
+ "scrt_seln_tr_pbmn": "31639",
+ "scrt_shnu_tr_pbmn": "28470",
+ "ivtr_seln_vol": "282816",
+ "ivtr_shnu_vol": "76842",
+ "ivtr_seln_tr_pbmn": "20111",
+ "ivtr_shnu_tr_pbmn": "5470",
+ "pe_fund_seln_tr_pbmn": "13670",
+ "pe_fund_seln_vol": "192157",
+ "pe_fund_shnu_tr_pbmn": "4783",
+ "pe_fund_shnu_vol": "67125",
+ "bank_seln_vol": "6",
+ "bank_shnu_vol": "2936",
+ "bank_seln_tr_pbmn": "0",
+ "bank_shnu_tr_pbmn": "209",
+ "insu_seln_vol": "108700",
+ "insu_shnu_vol": "23391",
+ "insu_seln_tr_pbmn": "7728",
+ "insu_shnu_tr_pbmn": "1666",
+ "mrbn_seln_vol": "760",
+ "mrbn_shnu_vol": "23",
+ "mrbn_seln_tr_pbmn": "54",
+ "mrbn_shnu_tr_pbmn": "2",
+ "fund_seln_vol": "3665021",
+ "fund_shnu_vol": "3551585",
+ "fund_seln_tr_pbmn": "261000",
+ "fund_shnu_tr_pbmn": "252699",
+ "etc_seln_vol": "99051",
+ "etc_shnu_vol": "1014400",
+ "etc_seln_tr_pbmn": "7054",
+ "etc_shnu_tr_pbmn": "72209",
+ "etc_orgt_seln_vol": "0",
+ "etc_orgt_shnu_vol": "0",
+ "etc_orgt_seln_tr_pbmn": "0",
+ "etc_orgt_shnu_tr_pbmn": "0",
+ "etc_corp_seln_vol": "99051",
+ "etc_corp_shnu_vol": "1014400",
+ "etc_corp_seln_tr_pbmn": "7054",
+ "etc_corp_shnu_tr_pbmn": "72209",
+ "bold_yn": "N"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/115_국내주식-038_종목조건검색-목록조회.md b/docs/broker/kis/rest/국내주식/시세분석/115_국내주식-038_종목조건검색-목록조회.md
new file mode 100644
index 0000000..24c6e35
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/115_국내주식-038_종목조건검색-목록조회.md
@@ -0,0 +1,150 @@
+# 종목조건검색 목록조회
+
+- 원본 시트명: 종목조건검색 목록조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-038
+- HTTP Method: GET
+- 실전 TR_ID: HHKST03900300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/psearch-title
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API입니다.
+종목조건검색 목록조회 API(/uapi/domestic-stock/v1/quotations/psearch-title)의 output인 'seq'을 종목조건검색조회 API(/uapi/domestic-stock/v1/quotations/psearch-result)의 input으로 사용하시면 됩니다.
+
+※ 시스템 안정성을 위해 API로 제공되는 조건검색 결과의 경우 조건당 100건으로 제한을 둔 점 양해 부탁드립니다.
+
+※ [0110] 화면의 '대상변경' 설정사항은 HTS [0110] 사용자 조건검색 화면에만 적용됨에 유의 부탁드립니다.
+
+※ '조회가 계속 됩니다. (다음을 누르십시오.)' 오류 발생 시 해결방법
+→ HTS(efriend Plus) [0110] 조건검색 화면에서 조건을 등록하신 후, 왼쪽 하단의 "사용자조건 서버저장" 클릭하셔서 등록한 조건들을 서버로 보낸 후 다시 API 호출 시도 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKST03900300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| user_id | 사용자 HTS ID | string | Y | 40 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | Array |
+| user_id | HTS ID | string | Y | 40 | |
+| seq | 조건키값 | string | Y | 10 | 해당 값을 종목조건검색조회 API의 input으로 사용
(0번부터 시작) |
+| grp_nm | 그룹명 | string | Y | 40 | HTS(eFriend Plus) [0110] "사용자조건검색"화면을 통해
등록한 사용자조건 그룹 |
+| condition_nm | 조건명 | string | Y | 40 | 등록한 사용자 조건명 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "user_id":"abcd9876"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "user_id": "abcd9876",
+ "seq": "0",
+ "grp_nm": "임시그룹",
+ "condition_nm": "RSI전략1_14_9_PER_부채비율"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "1",
+ "grp_nm": "임시그룹",
+ "condition_nm": "모멘텀전략1_5_3_PER_부채비율"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "2",
+ "grp_nm": "임시그룹",
+ "condition_nm": "외국계거래량_10000이상_PER_부채비율"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "3",
+ "grp_nm": "임시그룹",
+ "condition_nm": "이평전략1_5_20_PER_부채비율"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "4",
+ "grp_nm": "임시그룹",
+ "condition_nm": "이평전략2_5_20_PER_부채비율"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "5",
+ "grp_nm": "임시그룹",
+ "condition_nm": "테스트3"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "6",
+ "grp_nm": "임시그룹",
+ "condition_nm": "테트스"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "7",
+ "grp_nm": "임시그룹",
+ "condition_nm": "테트스2"
+ },
+ {
+ "user_id": "abcd9876",
+ "seq": "8",
+ "grp_nm": "임시그룹",
+ "condition_nm": "투자경고제외"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/116_국내주식-190_국내주식-상하한가-포착.md b/docs/broker/kis/rest/국내주식/시세분석/116_국내주식-190_국내주식-상하한가-포착.md
new file mode 100644
index 0000000..46e4801
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/116_국내주식-190_국내주식-상하한가-포착.md
@@ -0,0 +1,156 @@
+# 국내주식 상하한가 포착
+
+- 원본 시트명: 국내주식 상하한가 포착
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-190
+- HTTP Method: GET
+- 실전 TR_ID: FHKST130000C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/capture-uplowprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 상하한가 포착 API입니다.
+한국투자 HTS(eFriend Plus) > [0917] 실시간 상하한가 포착 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST130000C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분(J) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 11300(Unique key) |
+| FID_PRC_CLS_CODE | 상하한가 구분코드 | string | Y | 2 | 0(상한가),1(하한가) |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | '0(상하한가종목),6(8%상하한가 근접), 5(10%상하한가 근접), 1(15%상하한가 근접),2(20%상하한가 근접),
3(25%상하한가 근접)' |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 전체(0000), 코스피(0001),코스닥(1001) |
+| FID_TRGT_CLS_CODE | 대상구분코드 | string | Y | 32 | 공백 입력 |
+| FID_TRGT_EXLS_CLS_CODE | 대상제외구분코드 | string | Y | 32 | 공백 입력 |
+| FID_INPUT_PRICE_1 | 입력가격1 | string | Y | 12 | 공백 입력 |
+| FID_INPUT_PRICE_2 | 입력가격2 | string | Y | 12 | 공백 입력 |
+| FID_VOL_CNT | 거래량수 | string | Y | 12 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| mksc_shrn_iscd | 유가증권단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| total_askp_rsqn | 총매도호가잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총매수호가잔량 | string | Y | 12 | |
+| askp_rsqn1 | 매도호가잔량1 | string | Y | 12 | |
+| bidp_rsqn1 | 매수호가잔량1 | string | Y | 12 | |
+| prdy_vol | 전일거래량 | string | Y | 18 | |
+| seln_cnqn | 매도체결량 | string | Y | 18 | |
+| shnu_cnqn | 매수2체결량 | string | Y | 18 | |
+| stck_llam | 주식하한가 | string | Y | 10 | |
+| stck_mxpr | 주식상한가 | string | Y | 10 | |
+| prdy_vrss_vol_rate | 전일대비거래량비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:11300
+FID_PRC_CLS_CODE:0
+FID_DIV_CLS_CODE:0
+FID_INPUT_ISCD:0000
+FID_TRGT_CLS_CODE:
+FID_TRGT_EXLS_CLS_CODE:
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_VOL_CNT:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "mksc_shrn_iscd": "012800",
+ "hts_kor_isnm": "대창",
+ "stck_prpr": "2080",
+ "prdy_vrss_sign": "1",
+ "prdy_vrss": "478",
+ "prdy_ctrt": "29.84",
+ "acml_vol": "39937550",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "2648946",
+ "askp_rsqn1": "0",
+ "bidp_rsqn1": "2299811",
+ "prdy_vol": "4003121",
+ "seln_cnqn": "2",
+ "shnu_cnqn": "0",
+ "stck_llam": "1122",
+ "stck_mxpr": "2080",
+ "prdy_vrss_vol_rate": "997.66"
+ },
+ {
+ "mksc_shrn_iscd": "215100",
+ "hts_kor_isnm": "로보로보",
+ "stck_prpr": "5680",
+ "prdy_vrss_sign": "1",
+ "prdy_vrss": "1310",
+ "prdy_ctrt": "29.98",
+ "acml_vol": "10240653",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "622698",
+ "askp_rsqn1": "0",
+ "bidp_rsqn1": "553376",
+ "prdy_vol": "34944",
+ "seln_cnqn": "40",
+ "shnu_cnqn": "0",
+ "stck_llam": "3060",
+ "stck_mxpr": "5680",
+ "prdy_vrss_vol_rate": "29305.90"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/117_국내주식-115_프로그램매매-종합현황일별.md b/docs/broker/kis/rest/국내주식/시세분석/117_국내주식-115_프로그램매매-종합현황일별.md
new file mode 100644
index 0000000..02f711e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/117_국내주식-115_프로그램매매-종합현황일별.md
@@ -0,0 +1,533 @@
+# 프로그램매매 종합현황(일별)
+
+- 원본 시트명: 프로그램매매 종합현황(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-115
+- HTTP Method: GET
+- 실전 TR_ID: FHPPG04600001
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/comp-program-trade-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+프로그램매매 종합현황(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0460] 프로그램매매 종합현황 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+* 8개월 이상 과거 조회는 불가하며 에러메시지가 발생합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)FHPPG04600000 → (신)FHPPG04600001' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 시장 분류 코드 | string | Y | 2 | J : KRX, NX : NXT, UN : 통합 |
+| FID_MRKT_CLS_CODE | 시장 구분 코드 | string | Y | 2 | K:코스피, Q:코스닥 |
+| FID_INPUT_DATE_1 | 검색시작일 | string | Y | 10 | 공백 입력, 입력 시 ~ 입력일자까지 조회됨
* 8개월 이상 과거 조회 불가 |
+| FID_INPUT_DATE_2 | 검색종료일 | string | Y | 10 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| nabt_entm_seln_tr_pbmn | 비차익 위탁 매도 거래 대금 | string | Y | 18 | |
+| nabt_onsl_seln_vol | 비차익 자기 매도 거래량 | string | Y | 18 | |
+| whol_onsl_seln_tr_pbmn | 전체 자기 매도 거래 대금 | string | Y | 18 | |
+| arbt_smtn_shnu_vol | 차익 합계 매수2 거래량 | string | Y | 18 | |
+| nabt_smtn_shnu_tr_pbmn | 비차익 합계 매수2 거래 대금 | string | Y | 18 | |
+| arbt_entm_ntby_qty | 차익 위탁 순매수 수량 | string | Y | 18 | |
+| nabt_entm_ntby_tr_pbmn | 비차익 위탁 순매수 거래 대금 | string | Y | 18 | |
+| arbt_entm_seln_vol | 차익 위탁 매도 거래량 | string | Y | 18 | |
+| nabt_entm_seln_vol_rate | 비차익 위탁 매도 거래량 비율 | string | Y | 82 | |
+| nabt_onsl_seln_vol_rate | 비차익 자기 매도 거래량 비율 | string | Y | 82 | |
+| whol_onsl_seln_tr_pbmn_rate | 전체 자기 매도 거래 대금 비율 | string | Y | 82 | |
+| arbt_smtm_shun_vol_rate | 차익 합계 매수 거래량 비율 | string | Y | 72 | |
+| nabt_smtm_shun_tr_pbmn_rate | 비차익 합계 매수 거래대금 비율 | string | Y | 72 | |
+| arbt_entm_ntby_qty_rate | 차익 위탁 순매수 수량 비율 | string | Y | 82 | |
+| nabt_entm_ntby_tr_pbmn_rate | 비차익 위탁 순매수 거래 대금 | string | Y | 82 | |
+| arbt_entm_seln_vol_rate | 차익 위탁 매도 거래량 비율 | string | Y | 82 | |
+| nabt_entm_seln_tr_pbmn_rate | 비차익 위탁 매도 거래 대금 비 | string | Y | 82 | |
+| nabt_onsl_seln_tr_pbmn | 비차익 자기 매도 거래 대금 | string | Y | 18 | |
+| whol_smtn_seln_vol | 전체 합계 매도 거래량 | string | Y | 18 | |
+| arbt_smtn_shnu_tr_pbmn | 차익 합계 매수2 거래 대금 | string | Y | 18 | |
+| whol_entm_shnu_vol | 전체 위탁 매수2 거래량 | string | Y | 18 | |
+| arbt_entm_ntby_tr_pbmn | 차익 위탁 순매수 거래 대금 | string | Y | 18 | |
+| nabt_onsl_ntby_qty | 비차익 자기 순매수 수량 | string | Y | 18 | |
+| arbt_entm_seln_tr_pbmn | 차익 위탁 매도 거래 대금 | string | Y | 18 | |
+| nabt_onsl_seln_tr_pbmn_rate | 비차익 자기 매도 거래 대금 비 | string | Y | 82 | |
+| whol_seln_vol_rate | 전체 매도 거래량 비율 | string | Y | 72 | |
+| arbt_smtm_shun_tr_pbmn_rate | 차익 합계 매수 거래대금 비율 | string | Y | 72 | |
+| whol_entm_shnu_vol_rate | 전체 위탁 매수 거래량 비율 | string | Y | 82 | |
+| arbt_entm_ntby_tr_pbmn_rate | 차익 위탁 순매수 거래 대금 비 | string | Y | 82 | |
+| nabt_onsl_ntby_qty_rate | 비차익 자기 순매수 수량 비율 | string | Y | 82 | |
+| arbt_entm_seln_tr_pbmn_rate | 차익 위탁 매도 거래 대금 비율 | string | Y | 82 | |
+| nabt_smtn_seln_vol | 비차익 합계 매도 거래량 | string | Y | 18 | |
+| whol_smtn_seln_tr_pbmn | 전체 합계 매도 거래 대금 | string | Y | 18 | |
+| nabt_entm_shnu_vol | 비차익 위탁 매수2 거래량 | string | Y | 18 | |
+| whol_entm_shnu_tr_pbmn | 전체 위탁 매수2 거래 대금 | string | Y | 18 | |
+| arbt_onsl_ntby_qty | 차익 자기 순매수 수량 | string | Y | 18 | |
+| nabt_onsl_ntby_tr_pbmn | 비차익 자기 순매수 거래 대금 | string | Y | 18 | |
+| arbt_onsl_seln_tr_pbmn | 차익 자기 매도 거래 대금 | string | Y | 18 | |
+| nabt_smtm_seln_vol_rate | 비차익 합계 매도 거래량 비율 | string | Y | 72 | |
+| whol_seln_tr_pbmn_rate | 전체 매도 거래대금 비율 | string | Y | 72 | |
+| nabt_entm_shnu_vol_rate | 비차익 위탁 매수 거래량 비율 | string | Y | 82 | |
+| whol_entm_shnu_tr_pbmn_rate | 전체 위탁 매수 거래 대금 비율 | string | Y | 82 | |
+| arbt_onsl_ntby_qty_rate | 차익 자기 순매수 수량 비율 | string | Y | 82 | |
+| nabt_onsl_ntby_tr_pbmn_rate | 비차익 자기 순매수 거래 대금 | string | Y | 82 | |
+| arbt_onsl_seln_tr_pbmn_rate | 차익 자기 매도 거래 대금 비율 | string | Y | 82 | |
+| nabt_smtn_seln_tr_pbmn | 비차익 합계 매도 거래 대금 | string | Y | 18 | |
+| arbt_entm_shnu_vol | 차익 위탁 매수2 거래량 | string | Y | 18 | |
+| nabt_entm_shnu_tr_pbmn | 비차익 위탁 매수2 거래 대금 | string | Y | 18 | |
+| whol_onsl_shnu_vol | 전체 자기 매수2 거래량 | string | Y | 18 | |
+| arbt_onsl_ntby_tr_pbmn | 차익 자기 순매수 거래 대금 | string | Y | 18 | |
+| nabt_smtn_ntby_qty | 비차익 합계 순매수 수량 | string | Y | 18 | |
+| arbt_onsl_seln_vol | 차익 자기 매도 거래량 | string | Y | 18 | |
+| nabt_smtm_seln_tr_pbmn_rate | 비차익 합계 매도 거래대금 비율 | string | Y | 72 | |
+| arbt_entm_shnu_vol_rate | 차익 위탁 매수 거래량 비율 | string | Y | 82 | |
+| nabt_entm_shnu_tr_pbmn_rate | 비차익 위탁 매수 거래 대금 비 | string | Y | 82 | |
+| whol_onsl_shnu_tr_pbmn | 전체 자기 매수2 거래 대금 | string | Y | 18 | |
+| arbt_onsl_ntby_tr_pbmn_rate | 차익 자기 순매수 거래 대금 비 | string | Y | 82 | |
+| nabt_smtm_ntby_qty_rate | 비차익 합계 순매수 수량 비율 | string | Y | 72 | |
+| arbt_onsl_seln_vol_rate | 차익 자기 매도 거래량 비율 | string | Y | 82 | |
+| whol_entm_seln_vol | 전체 위탁 매도 거래량 | string | Y | 18 | |
+| arbt_entm_shnu_tr_pbmn | 차익 위탁 매수2 거래 대금 | string | Y | 18 | |
+| nabt_onsl_shnu_vol | 비차익 자기 매수2 거래량 | string | Y | 18 | |
+| whol_onsl_shnu_tr_pbmn_rate | 전체 자기 매수 거래 대금 비율 | string | Y | 82 | |
+| arbt_smtn_ntby_qty | 차익 합계 순매수 수량 | string | Y | 18 | |
+| nabt_smtn_ntby_tr_pbmn | 비차익 합계 순매수 거래 대금 | string | Y | 18 | |
+| arbt_smtn_seln_vol | 차익 합계 매도 거래량 | string | Y | 18 | |
+| whol_entm_seln_tr_pbmn | 전체 위탁 매도 거래 대금 | string | Y | 18 | |
+| arbt_entm_shnu_tr_pbmn_rate | 차익 위탁 매수 거래 대금 비율 | string | Y | 82 | |
+| nabt_onsl_shnu_vol_rate | 비차익 자기 매수 거래량 비율 | string | Y | 82 | |
+| whol_onsl_shnu_vol_rate | 전체 자기 매수 거래량 비율 | string | Y | 82 | |
+| arbt_smtm_ntby_qty_rate | 차익 합계 순매수 수량 비율 | string | Y | 72 | |
+| nabt_smtm_ntby_tr_pbmn_rate | 비차익 합계 순매수 거래대금 비 | string | Y | 72 | |
+| arbt_smtm_seln_vol_rate | 차익 합계 매도 거래량 비율 | string | Y | 72 | |
+| whol_entm_seln_vol_rate | 전체 위탁 매도 거래량 비율 | string | Y | 82 | |
+| arbt_onsl_shnu_vol | 차익 자기 매수2 거래량 | string | Y | 18 | |
+| nabt_onsl_shnu_tr_pbmn | 비차익 자기 매수2 거래 대금 | string | Y | 18 | |
+| whol_smtn_shnu_vol | 전체 합계 매수2 거래량 | string | Y | 18 | |
+| arbt_smtn_ntby_tr_pbmn | 차익 합계 순매수 거래 대금 | string | Y | 18 | |
+| whol_entm_ntby_qty | 전체 위탁 순매수 수량 | string | Y | 18 | |
+| arbt_smtn_seln_tr_pbmn | 차익 합계 매도 거래 대금 | string | Y | 18 | |
+| whol_entm_seln_tr_pbmn_rate | 전체 위탁 매도 거래 대금 비율 | string | Y | 82 | |
+| arbt_onsl_shnu_vol_rate | 차익 자기 매수 거래량 비율 | string | Y | 82 | |
+| nabt_onsl_shnu_tr_pbmn_rate | 비차익 자기 매수 거래 대금 비 | string | Y | 82 | |
+| whol_shun_vol_rate | 전체 매수 거래량 비율 | string | Y | 72 | |
+| arbt_smtm_ntby_tr_pbmn_rate | 차익 합계 순매수 거래대금 비율 | string | Y | 72 | |
+| whol_entm_ntby_qty_rate | 전체 위탁 순매수 수량 비율 | string | Y | 82 | |
+| arbt_smtm_seln_tr_pbmn_rate | 차익 합계 매도 거래대금 비율 | string | Y | 72 | |
+| whol_onsl_seln_vol | 전체 자기 매도 거래량 | string | Y | 18 | |
+| arbt_onsl_shnu_tr_pbmn | 차익 자기 매수2 거래 대금 | string | Y | 18 | |
+| nabt_smtn_shnu_vol | 비차익 합계 매수2 거래량 | string | Y | 18 | |
+| whol_smtn_shnu_tr_pbmn | 전체 합계 매수2 거래 대금 | string | Y | 18 | |
+| nabt_entm_ntby_qty | 비차익 위탁 순매수 수량 | string | Y | 18 | |
+| whol_entm_ntby_tr_pbmn | 전체 위탁 순매수 거래 대금 | string | Y | 18 | |
+| nabt_entm_seln_vol | 비차익 위탁 매도 거래량 | string | Y | 18 | |
+| whol_onsl_seln_vol_rate | 전체 자기 매도 거래량 비율 | string | Y | 82 | |
+| arbt_onsl_shnu_tr_pbmn_rate | 차익 자기 매수 거래 대금 비율 | string | Y | 82 | |
+| nabt_smtm_shun_vol_rate | 비차익 합계 매수 거래량 비율 | string | Y | 72 | |
+| whol_shun_tr_pbmn_rate | 전체 매수 거래대금 비율 | string | Y | 72 | |
+| nabt_entm_ntby_qty_rate | 비차익 위탁 순매수 수량 비율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:UN
+FID_MRKT_CLS_CODE:K
+FID_INPUT_DATE_1:
+FID_INPUT_DATE_2:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240404",
+ "arbt_entm_seln_vol": "945",
+ "arbt_entm_seln_vol_rate": "0.20",
+ "arbt_entm_seln_tr_pbmn": "60184",
+ "arbt_entm_seln_tr_pbmn_rate": "0.50",
+ "arbt_onsl_seln_tr_pbmn": "116742",
+ "arbt_onsl_seln_tr_pbmn_rate": "0.97",
+ "arbt_onsl_seln_vol": "1893",
+ "arbt_onsl_seln_vol_rate": "0.40",
+ "arbt_smtn_seln_vol": "2839",
+ "arbt_smtm_seln_vol_rate": "0.59",
+ "arbt_smtn_seln_tr_pbmn": "176926",
+ "arbt_smtm_seln_tr_pbmn_rate": "1.48",
+ "nabt_entm_seln_vol": "72995",
+ "nabt_entm_seln_tr_pbmn": "2335987",
+ "nabt_entm_seln_vol_rate": "15.27",
+ "nabt_entm_seln_tr_pbmn_rate": "19.50",
+ "nabt_onsl_seln_vol": "335",
+ "nabt_onsl_seln_vol_rate": "0.07",
+ "nabt_onsl_seln_tr_pbmn": "18428",
+ "nabt_onsl_seln_tr_pbmn_rate": "0.15",
+ "nabt_smtn_seln_vol": "73331",
+ "nabt_smtm_seln_vol_rate": "15.34",
+ "nabt_smtn_seln_tr_pbmn": "2354415",
+ "nabt_smtm_seln_tr_pbmn_rate": "19.66",
+ "whol_entm_seln_vol": "73940",
+ "whol_entm_seln_tr_pbmn": "2396171",
+ "whol_entm_seln_vol_rate": "15.47",
+ "whol_entm_seln_tr_pbmn_rate": "20.00",
+ "whol_onsl_seln_vol": "2229",
+ "whol_onsl_seln_vol_rate": "0.47",
+ "whol_onsl_seln_tr_pbmn": "135170",
+ "whol_onsl_seln_tr_pbmn_rate": "1.13",
+ "whol_smtn_seln_vol": "76169",
+ "whol_seln_vol_rate": "15.94",
+ "whol_smtn_seln_tr_pbmn": "2531340",
+ "whol_seln_tr_pbmn_rate": "21.13",
+ "arbt_entm_shnu_vol": "798",
+ "arbt_entm_shnu_vol_rate": "0.17",
+ "arbt_entm_shnu_tr_pbmn": "50818",
+ "arbt_entm_shnu_tr_pbmn_rate": "0.42",
+ "arbt_onsl_shnu_vol": "247",
+ "arbt_onsl_shnu_vol_rate": "0.05",
+ "arbt_onsl_shnu_tr_pbmn": "15309",
+ "arbt_onsl_shnu_tr_pbmn_rate": "0.13",
+ "arbt_smtn_shnu_vol": "1045",
+ "arbt_smtm_shun_vol_rate": "0.22",
+ "arbt_smtn_shnu_tr_pbmn": "66127",
+ "arbt_smtm_shun_tr_pbmn_rate": "0.55",
+ "nabt_entm_shnu_vol": "73441",
+ "nabt_entm_shnu_vol_rate": "15.37",
+ "nabt_entm_shnu_tr_pbmn": "2581806",
+ "nabt_entm_shnu_tr_pbmn_rate": "21.55",
+ "nabt_onsl_shnu_vol": "250",
+ "nabt_onsl_shnu_vol_rate": "0.05",
+ "nabt_onsl_shnu_tr_pbmn": "11652",
+ "nabt_onsl_shnu_tr_pbmn_rate": "0.10",
+ "nabt_smtn_shnu_vol": "73691",
+ "nabt_smtm_shun_vol_rate": "15.42",
+ "nabt_smtn_shnu_tr_pbmn": "2593458",
+ "nabt_smtm_shun_tr_pbmn_rate": "21.65",
+ "whol_entm_shnu_vol": "74239",
+ "whol_entm_shnu_vol_rate": "15.53",
+ "whol_entm_shnu_tr_pbmn": "2632624",
+ "whol_entm_shnu_tr_pbmn_rate": "21.98",
+ "whol_onsl_shnu_vol": "497",
+ "whol_onsl_shnu_tr_pbmn": "26961",
+ "whol_onsl_shnu_tr_pbmn_rate": "0.23",
+ "whol_onsl_shnu_vol_rate": "0.10",
+ "whol_smtn_shnu_vol": "74736",
+ "whol_shun_vol_rate": "15.64",
+ "whol_smtn_shnu_tr_pbmn": "2659585",
+ "whol_shun_tr_pbmn_rate": "22.20",
+ "arbt_entm_ntby_qty": "-147",
+ "arbt_entm_ntby_qty_rate": "-0.03",
+ "arbt_entm_ntby_tr_pbmn": "-9366",
+ "arbt_entm_ntby_tr_pbmn_rate": "-0.08",
+ "arbt_onsl_ntby_qty": "-1646",
+ "arbt_onsl_ntby_qty_rate": "-0.34",
+ "arbt_onsl_ntby_tr_pbmn": "-101433",
+ "arbt_onsl_ntby_tr_pbmn_rate": "-0.85",
+ "arbt_smtn_ntby_qty": "-1793",
+ "arbt_smtm_ntby_qty_rate": "-0.38",
+ "arbt_smtn_ntby_tr_pbmn": "-110799",
+ "arbt_smtm_ntby_tr_pbmn_rate": "-0.93",
+ "nabt_entm_ntby_qty": "446",
+ "nabt_entm_ntby_qty_rate": "0.09",
+ "nabt_entm_ntby_tr_pbmn": "245819",
+ "nabt_entm_ntby_tr_pbmn_rate": "2.05",
+ "nabt_onsl_ntby_qty": "-85",
+ "nabt_onsl_ntby_qty_rate": "-0.02",
+ "nabt_onsl_ntby_tr_pbmn": "-6776",
+ "nabt_onsl_ntby_tr_pbmn_rate": "-0.06",
+ "nabt_smtn_ntby_qty": "361",
+ "nabt_smtm_ntby_qty_rate": "0.08",
+ "nabt_smtn_ntby_tr_pbmn": "239043",
+ "nabt_smtm_ntby_tr_pbmn_rate": "2.00",
+ "whol_entm_ntby_qty": "299",
+ "whol_entm_ntby_qty_rate": "0.06",
+ "whol_entm_ntby_tr_pbmn": "236453",
+ "whol_entm_ntby_tr_pbmn_rate": "1.97",
+ "whol_onsl_ntby_qty": "-1732",
+ "whol_onsl_ntby_qty_rate": "-0.36",
+ "whol_onsl_ntby_tr_pbmn": "-108209",
+ "whol_onsl_ntby_tr_pbmn_rate": "-0.90",
+ "whol_smtn_ntby_qty": "-1433",
+ "whol_ntby_qty_rate": "-0.30",
+ "whol_smtn_ntby_tr_pbmn": "128245",
+ "whol_ntby_tr_pbmn_rate": "1.07",
+ "bstp_nmix_prpr": "",
+ "bstp_nmix_prdy_vrss": "",
+ "prdy_vrss_sign": ""
+ },
+ {
+ "stck_bsop_date": "20240403",
+ "arbt_entm_seln_vol": "769",
+ "arbt_entm_seln_vol_rate": "0.12",
+ "arbt_entm_seln_tr_pbmn": "48480",
+ "arbt_entm_seln_tr_pbmn_rate": "0.37",
+ "arbt_onsl_seln_tr_pbmn": "192333",
+ "arbt_onsl_seln_tr_pbmn_rate": "1.45",
+ "arbt_onsl_seln_vol": "3118",
+ "arbt_onsl_seln_vol_rate": "0.49",
+ "arbt_smtn_seln_vol": "3887",
+ "arbt_smtm_seln_vol_rate": "0.61",
+ "arbt_smtn_seln_tr_pbmn": "240813",
+ "arbt_smtm_seln_tr_pbmn_rate": "1.82",
+ "nabt_entm_seln_vol": "94356",
+ "nabt_entm_seln_tr_pbmn": "3076931",
+ "nabt_entm_seln_vol_rate": "14.72",
+ "nabt_entm_seln_tr_pbmn_rate": "23.21",
+ "nabt_onsl_seln_vol": "3323",
+ "nabt_onsl_seln_vol_rate": "0.52",
+ "nabt_onsl_seln_tr_pbmn": "207163",
+ "nabt_onsl_seln_tr_pbmn_rate": "1.56",
+ "nabt_smtn_seln_vol": "97679",
+ "nabt_smtm_seln_vol_rate": "15.24",
+ "nabt_smtn_seln_tr_pbmn": "3284094",
+ "nabt_smtm_seln_tr_pbmn_rate": "24.77",
+ "whol_entm_seln_vol": "95125",
+ "whol_entm_seln_tr_pbmn": "3125411",
+ "whol_entm_seln_vol_rate": "14.84",
+ "whol_entm_seln_tr_pbmn_rate": "23.58",
+ "whol_onsl_seln_vol": "6440",
+ "whol_onsl_seln_vol_rate": "1.01",
+ "whol_onsl_seln_tr_pbmn": "399496",
+ "whol_onsl_seln_tr_pbmn_rate": "3.01",
+ "whol_smtn_seln_vol": "101566",
+ "whol_seln_vol_rate": "15.85",
+ "whol_smtn_seln_tr_pbmn": "3524908",
+ "whol_seln_tr_pbmn_rate": "26.59",
+ "arbt_entm_shnu_vol": "916",
+ "arbt_entm_shnu_vol_rate": "0.14",
+ "arbt_entm_shnu_tr_pbmn": "57765",
+ "arbt_entm_shnu_tr_pbmn_rate": "0.44",
+ "arbt_onsl_shnu_vol": "151",
+ "arbt_onsl_shnu_vol_rate": "0.02",
+ "arbt_onsl_shnu_tr_pbmn": "9682",
+ "arbt_onsl_shnu_tr_pbmn_rate": "0.07",
+ "arbt_smtn_shnu_vol": "1067",
+ "arbt_smtm_shun_vol_rate": "0.17",
+ "arbt_smtn_shnu_tr_pbmn": "67446",
+ "arbt_smtm_shun_tr_pbmn_rate": "0.51",
+ "nabt_entm_shnu_vol": "88098",
+ "nabt_entm_shnu_vol_rate": "13.75",
+ "nabt_entm_shnu_tr_pbmn": "2576437",
+ "nabt_entm_shnu_tr_pbmn_rate": "19.43",
+ "nabt_onsl_shnu_vol": "206",
+ "nabt_onsl_shnu_vol_rate": "0.03",
+ "nabt_onsl_shnu_tr_pbmn": "8168",
+ "nabt_onsl_shnu_tr_pbmn_rate": "0.06",
+ "nabt_smtn_shnu_vol": "88304",
+ "nabt_smtm_shun_vol_rate": "13.78",
+ "nabt_smtn_shnu_tr_pbmn": "2584605",
+ "nabt_smtm_shun_tr_pbmn_rate": "19.50",
+ "whol_entm_shnu_vol": "89014",
+ "whol_entm_shnu_vol_rate": "13.89",
+ "whol_entm_shnu_tr_pbmn": "2634202",
+ "whol_entm_shnu_tr_pbmn_rate": "19.87",
+ "whol_onsl_shnu_vol": "357",
+ "whol_onsl_shnu_tr_pbmn": "17849",
+ "whol_onsl_shnu_tr_pbmn_rate": "0.13",
+ "whol_onsl_shnu_vol_rate": "0.06",
+ "whol_smtn_shnu_vol": "89371",
+ "whol_shun_vol_rate": "13.95",
+ "whol_smtn_shnu_tr_pbmn": "2652051",
+ "whol_shun_tr_pbmn_rate": "20.00",
+ "arbt_entm_ntby_qty": "147",
+ "arbt_entm_ntby_qty_rate": "0.02",
+ "arbt_entm_ntby_tr_pbmn": "9284",
+ "arbt_entm_ntby_tr_pbmn_rate": "0.07",
+ "arbt_onsl_ntby_qty": "-2967",
+ "arbt_onsl_ntby_qty_rate": "-0.46",
+ "arbt_onsl_ntby_tr_pbmn": "-182651",
+ "arbt_onsl_ntby_tr_pbmn_rate": "-1.38",
+ "arbt_smtn_ntby_qty": "-2819",
+ "arbt_smtm_ntby_qty_rate": "-0.44",
+ "arbt_smtn_ntby_tr_pbmn": "-173367",
+ "arbt_smtm_ntby_tr_pbmn_rate": "-1.31",
+ "nabt_entm_ntby_qty": "-6259",
+ "nabt_entm_ntby_qty_rate": "-0.98",
+ "nabt_entm_ntby_tr_pbmn": "-500494",
+ "nabt_entm_ntby_tr_pbmn_rate": "-3.78",
+ "nabt_onsl_ntby_qty": "-3116",
+ "nabt_onsl_ntby_qty_rate": "-0.49",
+ "nabt_onsl_ntby_tr_pbmn": "-198996",
+ "nabt_onsl_ntby_tr_pbmn_rate": "-1.50",
+ "nabt_smtn_ntby_qty": "-9375",
+ "nabt_smtm_ntby_qty_rate": "-1.46",
+ "nabt_smtn_ntby_tr_pbmn": "-699489",
+ "nabt_smtm_ntby_tr_pbmn_rate": "-5.28",
+ "whol_entm_ntby_qty": "-6112",
+ "whol_entm_ntby_qty_rate": "-0.95",
+ "whol_entm_ntby_tr_pbmn": "-491210",
+ "whol_entm_ntby_tr_pbmn_rate": "-3.71",
+ "whol_onsl_ntby_qty": "-6083",
+ "whol_onsl_ntby_qty_rate": "-0.95",
+ "whol_onsl_ntby_tr_pbmn": "-381647",
+ "whol_onsl_ntby_tr_pbmn_rate": "-2.88",
+ "whol_smtn_ntby_qty": "-12195",
+ "whol_ntby_qty_rate": "-1.90",
+ "whol_smtn_ntby_tr_pbmn": "-872856",
+ "whol_ntby_tr_pbmn_rate": "-6.58",
+ "bstp_nmix_prpr": "",
+ "bstp_nmix_prdy_vrss": "",
+ "prdy_vrss_sign": ""
+ },
+ {
+ "stck_bsop_date": "20240402",
+ "arbt_entm_seln_vol": "857",
+ "arbt_entm_seln_vol_rate": "0.14",
+ "arbt_entm_seln_tr_pbmn": "54673",
+ "arbt_entm_seln_tr_pbmn_rate": "0.42",
+ "arbt_onsl_seln_tr_pbmn": "78907",
+ "arbt_onsl_seln_tr_pbmn_rate": "0.60",
+ "arbt_onsl_seln_vol": "1282",
+ "arbt_onsl_seln_vol_rate": "0.20",
+ "arbt_smtn_seln_vol": "2138",
+ "arbt_smtm_seln_vol_rate": "0.34",
+ "arbt_smtn_seln_tr_pbmn": "133579",
+ "arbt_smtm_seln_tr_pbmn_rate": "1.02",
+ "nabt_entm_seln_vol": "78391",
+ "nabt_entm_seln_tr_pbmn": "2385531",
+ "nabt_entm_seln_vol_rate": "12.44",
+ "nabt_entm_seln_tr_pbmn_rate": "18.19",
+ "nabt_onsl_seln_vol": "893",
+ "nabt_onsl_seln_vol_rate": "0.14",
+ "nabt_onsl_seln_tr_pbmn": "54722",
+ "nabt_onsl_seln_tr_pbmn_rate": "0.42",
+ "nabt_smtn_seln_vol": "79284",
+ "nabt_smtm_seln_vol_rate": "12.58",
+ "nabt_smtn_seln_tr_pbmn": "2440253",
+ "nabt_smtm_seln_tr_pbmn_rate": "18.60",
+ "whol_entm_seln_vol": "79247",
+ "whol_entm_seln_tr_pbmn": "2440203",
+ "whol_entm_seln_vol_rate": "12.57",
+ "whol_entm_seln_tr_pbmn_rate": "18.60",
+ "whol_onsl_seln_vol": "2175",
+ "whol_onsl_seln_vol_rate": "0.35",
+ "whol_onsl_seln_tr_pbmn": "133628",
+ "whol_onsl_seln_tr_pbmn_rate": "1.02",
+ "whol_smtn_seln_vol": "81422",
+ "whol_seln_vol_rate": "12.92",
+ "whol_smtn_seln_tr_pbmn": "2573832",
+ "whol_seln_tr_pbmn_rate": "19.62",
+ "arbt_entm_shnu_vol": "760",
+ "arbt_entm_shnu_vol_rate": "0.12",
+ "arbt_entm_shnu_tr_pbmn": "48775",
+ "arbt_entm_shnu_tr_pbmn_rate": "0.37",
+ "arbt_onsl_shnu_vol": "3",
+ "arbt_onsl_shnu_vol_rate": "0.00",
+ "arbt_onsl_shnu_tr_pbmn": "657",
+ "arbt_onsl_shnu_tr_pbmn_rate": "0.01",
+ "arbt_smtn_shnu_vol": "762",
+ "arbt_smtm_shun_vol_rate": "0.12",
+ "arbt_smtn_shnu_tr_pbmn": "49432",
+ "arbt_smtm_shun_tr_pbmn_rate": "0.38",
+ "nabt_entm_shnu_vol": "74157",
+ "nabt_entm_shnu_vol_rate": "11.76",
+ "nabt_entm_shnu_tr_pbmn": "3086213",
+ "nabt_entm_shnu_tr_pbmn_rate": "23.53",
+ "nabt_onsl_shnu_vol": "187",
+ "nabt_onsl_shnu_vol_rate": "0.03",
+ "nabt_onsl_shnu_tr_pbmn": "8119",
+ "nabt_onsl_shnu_tr_pbmn_rate": "0.06",
+ "nabt_smtn_shnu_vol": "74344",
+ "nabt_smtm_shun_vol_rate": "11.79",
+ "nabt_smtn_shnu_tr_pbmn": "3094332",
+ "nabt_smtm_shun_tr_pbmn_rate": "23.59",
+ "whol_entm_shnu_vol": "74916",
+ "whol_entm_shnu_vol_rate": "11.88",
+ "whol_entm_shnu_tr_pbmn": "3134988",
+ "whol_entm_shnu_tr_pbmn_rate": "23.90",
+ "whol_onsl_shnu_vol": "190",
+ "whol_onsl_shnu_tr_pbmn": "8775",
+ "whol_onsl_shnu_tr_pbmn_rate": "0.07",
+ "whol_onsl_shnu_vol_rate": "0.03",
+ "whol_smtn_shnu_vol": "75107",
+ "whol_shun_vol_rate": "11.91",
+ "whol_smtn_shnu_tr_pbmn": "3143764",
+ "whol_shun_tr_pbmn_rate": "23.97",
+ "arbt_entm_ntby_qty": "-97",
+ "arbt_entm_ntby_qty_rate": "-0.02",
+ "arbt_entm_ntby_tr_pbmn": "-5897",
+ "arbt_entm_ntby_tr_pbmn_rate": "-0.04",
+ "arbt_onsl_ntby_qty": "-1279",
+ "arbt_onsl_ntby_qty_rate": "-0.20",
+ "arbt_onsl_ntby_tr_pbmn": "-78250",
+ "arbt_onsl_ntby_tr_pbmn_rate": "-0.60",
+ "arbt_smtn_ntby_qty": "-1376",
+ "arbt_smtm_ntby_qty_rate": "-0.22",
+ "arbt_smtn_ntby_tr_pbmn": "-84147",
+ "arbt_smtm_ntby_tr_pbmn_rate": "-0.64",
+ "nabt_entm_ntby_qty": "-4234",
+ "nabt_entm_ntby_qty_rate": "-0.67",
+ "nabt_entm_ntby_tr_pbmn": "700682",
+ "nabt_entm_ntby_tr_pbmn_rate": "5.34",
+ "nabt_onsl_ntby_qty": "-706",
+ "nabt_onsl_ntby_qty_rate": "-0.11",
+ "nabt_onsl_ntby_tr_pbmn": "-46603",
+ "nabt_onsl_ntby_tr_pbmn_rate": "-0.36",
+ "nabt_smtn_ntby_qty": "-4940",
+ "nabt_smtm_ntby_qty_rate": "-0.78",
+ "nabt_smtn_ntby_tr_pbmn": "654079",
+ "nabt_smtm_ntby_tr_pbmn_rate": "4.99",
+ "whol_entm_ntby_qty": "-4331",
+ "whol_entm_ntby_qty_rate": "-0.69",
+ "whol_entm_ntby_tr_pbmn": "694785",
+ "whol_entm_ntby_tr_pbmn_rate": "5.30",
+ "whol_onsl_ntby_qty": "-1985",
+ "whol_onsl_ntby_qty_rate": "-0.31",
+ "whol_onsl_ntby_tr_pbmn": "-124853",
+ "whol_onsl_ntby_tr_pbmn_rate": "-0.95",
+ "whol_smtn_ntby_qty": "-6316",
+ "whol_ntby_qty_rate": "-1.00",
+ "whol_smtn_ntby_tr_pbmn": "569932",
+ "whol_ntby_tr_pbmn_rate": "4.35",
+ "bstp_nmix_prpr": "",
+ "bstp_nmix_prdy_vrss": "",
+ "prdy_vrss_sign": ""
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/118_국내주식-135_종목별-일별-대차거래추이.md b/docs/broker/kis/rest/국내주식/시세분석/118_국내주식-135_종목별-일별-대차거래추이.md
new file mode 100644
index 0000000..a420bdf
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/118_국내주식-135_종목별-일별-대차거래추이.md
@@ -0,0 +1,375 @@
+# 종목별 일별 대차거래추이
+
+- 원본 시트명: 종목별 일별 대차거래추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-135
+- HTTP Method: GET
+- 실전 TR_ID: HHPST074500C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/daily-loan-trans
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+종목별 일별 대차거래추이 API입니다.
+한 번의 조회에 최대 100건까지 조회 가능하며, start_date, end_date 를 수정하여 다음 조회가 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHPST074500C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MRKT_DIV_CLS_CODE | 조회구분 | string | Y | 1 | 1(코스피), 2(코스닥), 3(종목) |
+| MKSC_SHRN_ISCD | 종목코드 | string | Y | 9 | 종목코드 |
+| START_DATE | 조회시작일시 | string | Y | 8 | 조회기간 ~ |
+| END_DATE | 조회종료일시 | string | Y | 8 | ~ 조회기간 |
+| CTS | 이전조회KEY | string | Y | 8 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| bsop_date | 일자 | string | Y | 8 | |
+| stck_prpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 8 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| new_stcn | 당일 증가 주수 (체결) | string | Y | 16 | |
+| rdmp_stcn | 당일 감소 주수 (상환) | string | Y | 16 | |
+| prdy_rmnd_vrss | 대차거래 증감 | string | Y | 16 | |
+| rmnd_stcn | 당일 잔고 주수 | string | Y | 16 | |
+| rmnd_amt | 당일 잔고 금액 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+mrkt_div_cls_code:1
+mksc_shrn_iscd:005930
+start_date:20240401
+end_date:20240430
+cts:
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "bsop_date": "20240430",
+ "stck_prpr": "2692.06",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "4.62",
+ "prdy_ctrt": "0.17",
+ "acml_vol": "460083500",
+ "new_stcn": "14379227",
+ "rdmp_stcn": "13993603",
+ "prdy_rmnd_vrss": "385624",
+ "rmnd_stcn": "947521840",
+ "rmnd_amt": "47504735"
+ },
+ {
+ "bsop_date": "20240429",
+ "stck_prpr": "2687.44",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "31.11",
+ "prdy_ctrt": "1.17",
+ "acml_vol": "470546000",
+ "new_stcn": "6028334",
+ "rdmp_stcn": "13437664",
+ "prdy_rmnd_vrss": "-7409330",
+ "rmnd_stcn": "947136216",
+ "rmnd_amt": "47367356"
+ },
+ {
+ "bsop_date": "20240426",
+ "stck_prpr": "2656.33",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "27.71",
+ "prdy_ctrt": "1.05",
+ "acml_vol": "450520700",
+ "new_stcn": "14406990",
+ "rdmp_stcn": "12079739",
+ "prdy_rmnd_vrss": "2327251",
+ "rmnd_stcn": "954545546",
+ "rmnd_amt": "46874865"
+ },
+ {
+ "bsop_date": "20240425",
+ "stck_prpr": "2628.62",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-47.13",
+ "prdy_ctrt": "-1.76",
+ "acml_vol": "334062400",
+ "new_stcn": "4765719",
+ "rdmp_stcn": "13112635",
+ "prdy_rmnd_vrss": "-8346916",
+ "rmnd_stcn": "952231269",
+ "rmnd_amt": "46089010"
+ },
+ {
+ "bsop_date": "20240424",
+ "stck_prpr": "2675.75",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "52.73",
+ "prdy_ctrt": "2.01",
+ "acml_vol": "325739600",
+ "new_stcn": "19649840",
+ "rdmp_stcn": "8993910",
+ "prdy_rmnd_vrss": "10655930",
+ "rmnd_stcn": "960577194",
+ "rmnd_amt": "47488544"
+ },
+ {
+ "bsop_date": "20240423",
+ "stck_prpr": "2623.02",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-6.42",
+ "prdy_ctrt": "-0.24",
+ "acml_vol": "430275800",
+ "new_stcn": "7802761",
+ "rdmp_stcn": "7414164",
+ "prdy_rmnd_vrss": "388597",
+ "rmnd_stcn": "949921264",
+ "rmnd_amt": "46108475"
+ },
+ {
+ "bsop_date": "20240422",
+ "stck_prpr": "2629.44",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "37.58",
+ "prdy_ctrt": "1.45",
+ "acml_vol": "401892200",
+ "new_stcn": "10841550",
+ "rdmp_stcn": "18150018",
+ "prdy_rmnd_vrss": "-7308468",
+ "rmnd_stcn": "949532667",
+ "rmnd_amt": "46211861"
+ },
+ {
+ "bsop_date": "20240419",
+ "stck_prpr": "2591.86",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-42.84",
+ "prdy_ctrt": "-1.63",
+ "acml_vol": "809473400",
+ "new_stcn": "8657583",
+ "rdmp_stcn": "12304586",
+ "prdy_rmnd_vrss": "-3647003",
+ "rmnd_stcn": "956841135",
+ "rmnd_amt": "45225405"
+ },
+ {
+ "bsop_date": "20240418",
+ "stck_prpr": "2634.70",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "50.52",
+ "prdy_ctrt": "1.95",
+ "acml_vol": "478786200",
+ "new_stcn": "13218317",
+ "rdmp_stcn": "16631496",
+ "prdy_rmnd_vrss": "-3413179",
+ "rmnd_stcn": "960488138",
+ "rmnd_amt": "46007513"
+ },
+ {
+ "bsop_date": "20240417",
+ "stck_prpr": "2584.18",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-25.45",
+ "prdy_ctrt": "-0.98",
+ "acml_vol": "414348100",
+ "new_stcn": "13838612",
+ "rdmp_stcn": "9001120",
+ "prdy_rmnd_vrss": "4837492",
+ "rmnd_stcn": "963901317",
+ "rmnd_amt": "45199389"
+ },
+ {
+ "bsop_date": "20240416",
+ "stck_prpr": "2609.63",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-60.80",
+ "prdy_ctrt": "-2.28",
+ "acml_vol": "570212100",
+ "new_stcn": "8029982",
+ "rdmp_stcn": "9662633",
+ "prdy_rmnd_vrss": "-1632651",
+ "rmnd_stcn": "959063825",
+ "rmnd_amt": "45461648"
+ },
+ {
+ "bsop_date": "20240415",
+ "stck_prpr": "2670.43",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-11.39",
+ "prdy_ctrt": "-0.42",
+ "acml_vol": "561950000",
+ "new_stcn": "13418896",
+ "rdmp_stcn": "9863897",
+ "prdy_rmnd_vrss": "3554999",
+ "rmnd_stcn": "960696476",
+ "rmnd_amt": "46397052"
+ },
+ {
+ "bsop_date": "20240412",
+ "stck_prpr": "2681.82",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-25.14",
+ "prdy_ctrt": "-0.93",
+ "acml_vol": "514575300",
+ "new_stcn": "16291814",
+ "rdmp_stcn": "6220088",
+ "prdy_rmnd_vrss": "10071726",
+ "rmnd_stcn": "957141477",
+ "rmnd_amt": "46559127"
+ },
+ {
+ "bsop_date": "20240411",
+ "stck_prpr": "2706.96",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1.80",
+ "prdy_ctrt": "0.07",
+ "acml_vol": "561333400",
+ "new_stcn": "14878420",
+ "rdmp_stcn": "10305585",
+ "prdy_rmnd_vrss": "4572835",
+ "rmnd_stcn": "947069751",
+ "rmnd_amt": "46395176"
+ },
+ {
+ "bsop_date": "20240409",
+ "stck_prpr": "2705.16",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-12.49",
+ "prdy_ctrt": "-0.46",
+ "acml_vol": "470183700",
+ "new_stcn": "10784436",
+ "rdmp_stcn": "6933242",
+ "prdy_rmnd_vrss": "3851194",
+ "rmnd_stcn": "942496916",
+ "rmnd_amt": "46082940"
+ },
+ {
+ "bsop_date": "20240408",
+ "stck_prpr": "2717.65",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "3.44",
+ "prdy_ctrt": "0.13",
+ "acml_vol": "620652500",
+ "new_stcn": "16939713",
+ "rdmp_stcn": "12571632",
+ "prdy_rmnd_vrss": "4368081",
+ "rmnd_stcn": "938645722",
+ "rmnd_amt": "46069590"
+ },
+ {
+ "bsop_date": "20240405",
+ "stck_prpr": "2714.21",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-27.79",
+ "prdy_ctrt": "-1.01",
+ "acml_vol": "621030600",
+ "new_stcn": "5614441",
+ "rdmp_stcn": "11701229",
+ "prdy_rmnd_vrss": "-6086788",
+ "rmnd_stcn": "934277641",
+ "rmnd_amt": "45207497"
+ },
+ {
+ "bsop_date": "20240404",
+ "stck_prpr": "2742.00",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "35.03",
+ "prdy_ctrt": "1.29",
+ "acml_vol": "477952800",
+ "new_stcn": "12221690",
+ "rdmp_stcn": "5093795",
+ "prdy_rmnd_vrss": "7127895",
+ "rmnd_stcn": "940364429",
+ "rmnd_amt": "45926211"
+ },
+ {
+ "bsop_date": "20240403",
+ "stck_prpr": "2706.97",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-46.19",
+ "prdy_ctrt": "-1.68",
+ "acml_vol": "640806300",
+ "new_stcn": "14817975",
+ "rdmp_stcn": "15348355",
+ "prdy_rmnd_vrss": "-530380",
+ "rmnd_stcn": "933236534",
+ "rmnd_amt": "44837956"
+ },
+ {
+ "bsop_date": "20240402",
+ "stck_prpr": "2753.16",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "5.30",
+ "prdy_ctrt": "0.19",
+ "acml_vol": "630392900",
+ "new_stcn": "12689747",
+ "rdmp_stcn": "9723610",
+ "prdy_rmnd_vrss": "2966137",
+ "rmnd_stcn": "933766914",
+ "rmnd_amt": "45180305"
+ },
+ {
+ "bsop_date": "20240401",
+ "stck_prpr": "2747.86",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "1.23",
+ "prdy_ctrt": "0.04",
+ "acml_vol": "397600500",
+ "new_stcn": "8654205",
+ "rdmp_stcn": "9951822",
+ "prdy_rmnd_vrss": "-1297617",
+ "rmnd_stcn": "930800777",
+ "rmnd_amt": "45158153"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/119_국내주식-039_종목조건검색조회.md b/docs/broker/kis/rest/국내주식/시세분석/119_국내주식-039_종목조건검색조회.md
new file mode 100644
index 0000000..719acef
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/119_국내주식-039_종목조건검색조회.md
@@ -0,0 +1,901 @@
+# 종목조건검색조회
+
+- 원본 시트명: 종목조건검색조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-039
+- HTTP Method: GET
+- 실전 TR_ID: HHKST03900400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/psearch-result
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API입니다.
+종목조건검색 목록조회 API(/uapi/domestic-stock/v1/quotations/psearch-title)의 output인 'seq'을 종목조건검색조회 API(/uapi/domestic-stock/v1/quotations/psearch-result)의 input으로 사용하시면 됩니다.
+
+※ 시스템 안정성을 위해 API로 제공되는 조건검색 결과의 경우 조건당 100건으로 제한을 둔 점 양해 부탁드립니다.
+
+※ [0110] 화면의 '대상변경' 설정사항은 HTS [0110] 사용자 조건검색 화면에만 적용됨에 유의 부탁드립니다.
+
+※ '조회가 계속 됩니다. (다음을 누르십시오.)' 오류 발생 시 해결방법
+→ HTS(efriend Plus) [0110] 조건검색 화면에서 조건을 등록하신 후, 왼쪽 하단의 "사용자조건 서버저장" 클릭하셔서 등록한 조건들을 서버로 보낸 후 다시 API 호출 시도 부탁드립니다.
+
+※ {"rt_cd":"1","msg_cd":"MCA05918","msg1":"종목코드 오류입니다."} 메시지 발생 이유
+→ 조건검색 결과 검색된 종목이 0개인 경우 위 응답값을 수신하게 됩니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKST03900400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| user_id | 사용자 HTS ID | string | Y | 40 | |
+| seq | 사용자조건 키값 | string | Y | 10 | 종목조건검색 목록조회 API의 output인 'seq'을 이용
(0 부터 시작) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | Array |
+| code | 종목코드 | string | Y | 6 | |
+| name | 종목명 | string | Y | 20 | |
+| daebi | 전일대비부호 | string | Y | 1 | 1. 상한 2. 상승 3. 보합 4. 하한 5. 하락 |
+| price | 현재가 | string | Y | 16 | |
+| chgrate | 등락율 | string | Y | 16 | |
+| acml_vol | 거래량 | string | Y | 16 | |
+| trade_amt | 거래대금 | string | Y | 16 | |
+| change | 전일대비 | string | Y | 16 | |
+| cttr | 체결강도 | string | Y | 16 | |
+| open | 시가 | string | Y | 16 | |
+| high | 고가 | string | Y | 16 | |
+| low | 저가 | string | Y | 16 | |
+| high52 | 52주최고가 | string | Y | 16 | |
+| low52 | 52주최저가 | string | Y | 16 | |
+| expprice | 예상체결가 | string | Y | 16 | |
+| expchange | 예상대비 | string | Y | 16 | |
+| expchggrate | 예상등락률 | string | Y | 16 | |
+| expcvol | 예상체결수량 | string | Y | 16 | |
+| chgrate2 | 전일거래량대비율 | string | Y | 16 | |
+| expdaebi | 예상대비부호 | string | Y | 1 | |
+| recprice | 기준가 | string | Y | 16 | |
+| uplmtprice | 상한가 | string | Y | 16 | |
+| dnlmtprice | 하한가 | string | Y | 16 | |
+| stotprice | 시가총액 | string | Y | 16 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "user_id":"abcd4321",
+ "seq":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "code": "000120",
+ "name": "CJ대한통운",
+ "daebi": "0",
+ "price": "00000138600.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 148600.0000",
+ "low52": " 69000.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 138600.0000",
+ "uplmtprice": " 180100.0000",
+ "dnlmtprice": " 97100.0000",
+ "stotprice": " 31617.9088"
+ },
+ {
+ "code": "002320",
+ "name": "한진",
+ "daebi": "0",
+ "price": "00000024350.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 27300.0000",
+ "low52": " 18010.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 24350.0000",
+ "uplmtprice": " 31650.0000",
+ "dnlmtprice": " 17050.0000",
+ "stotprice": " 3639.7474"
+ },
+ {
+ "code": "002680",
+ "name": "한탑",
+ "daebi": "0",
+ "price": "00000001234.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 2275.0000",
+ "low52": " 1125.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 1234.0000",
+ "uplmtprice": " 1604.0000",
+ "dnlmtprice": " 864.0000",
+ "stotprice": " 398.7893"
+ },
+ {
+ "code": "004710",
+ "name": "한솔테크닉스",
+ "daebi": "0",
+ "price": "00000007070.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 8390.0000",
+ "low52": " 5230.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 7070.0000",
+ "uplmtprice": " 9190.0000",
+ "dnlmtprice": " 4950.0000",
+ "stotprice": " 2270.1684"
+ },
+ {
+ "code": "005300",
+ "name": "롯데칠성",
+ "daebi": "0",
+ "price": "00000127600.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 174900.0000",
+ "low52": " 117300.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 127600.0000",
+ "uplmtprice": " 165800.0000",
+ "dnlmtprice": " 89400.0000",
+ "stotprice": " 11839.8560"
+ },
+ {
+ "code": "009070",
+ "name": "KCTC",
+ "daebi": "0",
+ "price": "00000004145.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5390.0000",
+ "low52": " 3550.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 4145.0000",
+ "uplmtprice": " 5380.0000",
+ "dnlmtprice": " 2905.0000",
+ "stotprice": " 1243.5000"
+ },
+ {
+ "code": "010420",
+ "name": "한솔PNS",
+ "daebi": "0",
+ "price": "00000001221.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 1750.0000",
+ "low52": " 1181.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 1221.0000",
+ "uplmtprice": " 1587.0000",
+ "dnlmtprice": " 855.0000",
+ "stotprice": " 250.2197"
+ },
+ {
+ "code": "015260",
+ "name": "에이엔피",
+ "daebi": "0",
+ "price": "00000001052.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 2620.0000",
+ "low52": " 1034.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 1052.0000",
+ "uplmtprice": " 1367.0000",
+ "dnlmtprice": " 737.0000",
+ "stotprice": " 474.6297"
+ },
+ {
+ "code": "015360",
+ "name": "예스코홀딩스",
+ "daebi": "0",
+ "price": "00000037000.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 37750.0000",
+ "low52": " 30400.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 37000.0000",
+ "uplmtprice": " 48100.0000",
+ "dnlmtprice": " 25900.0000",
+ "stotprice": " 2220.0000"
+ },
+ {
+ "code": "036460",
+ "name": "한국가스공사",
+ "daebi": "0",
+ "price": "00000026800.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 32250.0000",
+ "low52": " 22750.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 26800.0000",
+ "uplmtprice": " 34800.0000",
+ "dnlmtprice": " 18800.0000",
+ "stotprice": " 24739.8840"
+ },
+ {
+ "code": "036710",
+ "name": "심텍홀딩스",
+ "daebi": "0",
+ "price": "00000002900.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 4190.0000",
+ "low52": " 2380.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 2900.0000",
+ "uplmtprice": " 3770.0000",
+ "dnlmtprice": " 2030.0000",
+ "stotprice": " 1402.1542"
+ },
+ {
+ "code": "036800",
+ "name": "나이스정보통신",
+ "daebi": "0",
+ "price": "00000022350.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 29500.0000",
+ "low52": " 19910.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 22350.0000",
+ "uplmtprice": " 29050.0000",
+ "dnlmtprice": " 15650.0000",
+ "stotprice": " 2235.0000"
+ },
+ {
+ "code": "053050",
+ "name": "지에스이",
+ "daebi": "0",
+ "price": "00000003525.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5570.0000",
+ "low52": " 2810.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 3525.0000",
+ "uplmtprice": " 4580.0000",
+ "dnlmtprice": " 2470.0000",
+ "stotprice": " 1057.0628"
+ },
+ {
+ "code": "053450",
+ "name": "세코닉스",
+ "daebi": "0",
+ "price": "00000008000.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 9960.0000",
+ "low52": " 5370.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 8000.0000",
+ "uplmtprice": " 10400.0000",
+ "dnlmtprice": " 5600.0000",
+ "stotprice": " 1183.4242"
+ },
+ {
+ "code": "058850",
+ "name": "KTcs",
+ "daebi": "0",
+ "price": "00000003800.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5920.0000",
+ "low52": " 2790.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 3800.0000",
+ "uplmtprice": " 4940.0000",
+ "dnlmtprice": " 2660.0000",
+ "stotprice": " 1622.0300"
+ },
+ {
+ "code": "058860",
+ "name": "KTis",
+ "daebi": "0",
+ "price": "00000003080.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5230.0000",
+ "low52": " 2695.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 3080.0000",
+ "uplmtprice": " 4000.0000",
+ "dnlmtprice": " 2160.0000",
+ "stotprice": " 1071.9016"
+ },
+ {
+ "code": "063570",
+ "name": "한국전자금융",
+ "daebi": "0",
+ "price": "00000006610.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 7520.0000",
+ "low52": " 4665.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 6610.0000",
+ "uplmtprice": " 8590.0000",
+ "dnlmtprice": " 4630.0000",
+ "stotprice": " 2257.1648"
+ },
+ {
+ "code": "069640",
+ "name": "한세엠케이",
+ "daebi": "0",
+ "price": "00000002095.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 4170.0000",
+ "low52": " 1960.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 2095.0000",
+ "uplmtprice": " 2720.0000",
+ "dnlmtprice": " 1470.0000",
+ "stotprice": " 630.7312"
+ },
+ {
+ "code": "071670",
+ "name": "에이테크솔루션",
+ "daebi": "0",
+ "price": "00000010860.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 15200.0000",
+ "low52": " 9500.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 10860.0000",
+ "uplmtprice": " 14110.0000",
+ "dnlmtprice": " 7610.0000",
+ "stotprice": " 1086.0000"
+ },
+ {
+ "code": "085660",
+ "name": "차바이오텍",
+ "daebi": "0",
+ "price": "00000018010.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 23100.0000",
+ "low52": " 11790.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 18010.0000",
+ "uplmtprice": " 23400.0000",
+ "dnlmtprice": " 12610.0000",
+ "stotprice": " 10142.2312"
+ },
+ {
+ "code": "092300",
+ "name": "현우산업",
+ "daebi": "0",
+ "price": "00000004315.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 6850.0000",
+ "low52": " 3570.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 4315.0000",
+ "uplmtprice": " 5600.0000",
+ "dnlmtprice": " 3025.0000",
+ "stotprice": " 805.7320"
+ },
+ {
+ "code": "111110",
+ "name": "호전실업",
+ "daebi": "0",
+ "price": "00000007740.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 9100.0000",
+ "low52": " 7290.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 7740.0000",
+ "uplmtprice": " 10060.0000",
+ "dnlmtprice": " 5420.0000",
+ "stotprice": " 754.6488"
+ },
+ {
+ "code": "115530",
+ "name": "씨엔플러스",
+ "daebi": "0",
+ "price": "00000000325.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 650.0000",
+ "low52": " 301.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 325.0000",
+ "uplmtprice": " 422.0000",
+ "dnlmtprice": " 228.0000",
+ "stotprice": " 220.8798"
+ },
+ {
+ "code": "128820",
+ "name": "대성산업",
+ "daebi": "0",
+ "price": "00000004000.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5000.0000",
+ "low52": " 3405.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 4000.0000",
+ "uplmtprice": " 5200.0000",
+ "dnlmtprice": " 2800.0000",
+ "stotprice": " 1809.4191"
+ },
+ {
+ "code": "145210",
+ "name": "다이나믹디자인",
+ "daebi": "0",
+ "price": "00000005720.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 12630.0000",
+ "low52": " 2780.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 5720.0000",
+ "uplmtprice": " 7430.0000",
+ "dnlmtprice": " 4010.0000",
+ "stotprice": " 989.6225"
+ },
+ {
+ "code": "210120",
+ "name": "빅텐츠",
+ "daebi": "0",
+ "price": "00000016170.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 45700.0000",
+ "low52": " 9050.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 16170.0000",
+ "uplmtprice": " 21000.0000",
+ "dnlmtprice": " 11320.0000",
+ "stotprice": " 508.4834"
+ },
+ {
+ "code": "214680",
+ "name": "디알텍",
+ "daebi": "0",
+ "price": "00000003990.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 7590.0000",
+ "low52": " 1513.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 3990.0000",
+ "uplmtprice": " 5180.0000",
+ "dnlmtprice": " 2795.0000",
+ "stotprice": " 2921.4692"
+ },
+ {
+ "code": "216050",
+ "name": "인크로스",
+ "daebi": "0",
+ "price": "00000011110.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 20550.0000",
+ "low52": " 9690.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 11110.0000",
+ "uplmtprice": " 14440.0000",
+ "dnlmtprice": " 7780.0000",
+ "stotprice": " 1426.8820"
+ },
+ {
+ "code": "221840",
+ "name": "하이즈항공",
+ "daebi": "0",
+ "price": "00000002420.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 3835.0000",
+ "low52": " 2385.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 2420.0000",
+ "uplmtprice": " 3145.0000",
+ "dnlmtprice": " 1695.0000",
+ "stotprice": " 452.5536"
+ },
+ {
+ "code": "278650",
+ "name": "HLB바이오스텝",
+ "daebi": "0",
+ "price": "00000003870.0000",
+ "chgrate": " 0.0000",
+ "acml_vol": " 0.0000",
+ "trade_amt": " 0.0000",
+ "change": " 0.0000",
+ "cttr": " 0.0000",
+ "open": " 0.0000",
+ "high": " 0.0000",
+ "low": " 0.0000",
+ "high52": " 5380.0000",
+ "low52": " 2430.0000",
+ "expprice": "00000000000.0000",
+ "expchange": " 0.0000",
+ "expchggrate": " -100.0000",
+ "expcvol": " 0.0000",
+ "chgrate2": " 0.0000",
+ "expdaebi": "5",
+ "recprice": " 3870.0000",
+ "uplmtprice": " 5030.0000",
+ "dnlmtprice": " 2710.0000",
+ "stotprice": " 3106.5775"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/120_국내주식-196_국내주식-매물대_거래비중.md b/docs/broker/kis/rest/국내주식/시세분석/120_국내주식-196_국내주식-매물대_거래비중.md
new file mode 100644
index 0000000..5e12543
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/120_국내주식-196_국내주식-매물대_거래비중.md
@@ -0,0 +1,226 @@
+# 국내주식 매물대_거래비중
+
+- 원본 시트명: 국내주식 매물대_거래비중
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-196
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01130000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/pbar-tratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 매물대/거래비중 API입니다.
+한국투자 HTS(eFriend Plus) > [0113] 당일가격대별 매물대 화면의 데이터 중 일부를 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01130000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 주식단축종목코드 |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Uniquekey(20113) |
+| FID_INPUT_HOUR_1 | 입력시간1 | string | Y | 10 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| rprs_mrkt_kor_name | 대표시장한글명 | string | Y | 40 | |
+| stck_shrn_iscd | 주식단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| prdy_vol | 전일거래량 | string | Y | 18 | |
+| wghn_avrg_stck_prc | 가중평균주식가격 | string | Y | 192 | |
+| lstn_stcn | 상장주수 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_rank | 데이터순위 | string | Y | 10 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| cntg_vol | 체결거래량 | string | Y | 18 | |
+| acml_vol_rlim | 누적거래량비중 | string | Y | 72 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_INPUT_ISCD:136480
+FID_COND_SCR_DIV_CODE:20113
+FID_INPUT_HOUR_1:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "rprs_mrkt_kor_name": "KOSDAQ",
+ "stck_shrn_iscd": "136480",
+ "hts_kor_isnm": "하림",
+ "stck_prpr": "3240",
+ "prdy_vrss_sign": "5",
+ "prdy_vrss": "-65",
+ "prdy_ctrt": "-1.97",
+ "acml_vol": "847563",
+ "prdy_vol": "974060",
+ "wghn_avrg_stck_prc": "3256.34",
+ "lstn_stcn": "106209702"
+ },
+ "output2": [
+ {
+ "data_rank": "1",
+ "stck_prpr": "3255",
+ "cntg_vol": "124515",
+ "acml_vol_rlim": "14.69"
+ },
+ {
+ "data_rank": "2",
+ "stck_prpr": "3260",
+ "cntg_vol": "123909",
+ "acml_vol_rlim": "14.62"
+ },
+ {
+ "data_rank": "3",
+ "stck_prpr": "3250",
+ "cntg_vol": "87983",
+ "acml_vol_rlim": "10.38"
+ },
+ {
+ "data_rank": "4",
+ "stck_prpr": "3245",
+ "cntg_vol": "83496",
+ "acml_vol_rlim": "9.85"
+ },
+ {
+ "data_rank": "5",
+ "stck_prpr": "3235",
+ "cntg_vol": "72101",
+ "acml_vol_rlim": "8.51"
+ },
+ {
+ "data_rank": "6",
+ "stck_prpr": "3240",
+ "cntg_vol": "70712",
+ "acml_vol_rlim": "8.34"
+ },
+ {
+ "data_rank": "7",
+ "stck_prpr": "3265",
+ "cntg_vol": "65838",
+ "acml_vol_rlim": "7.77"
+ },
+ {
+ "data_rank": "8",
+ "stck_prpr": "3275",
+ "cntg_vol": "57283",
+ "acml_vol_rlim": "6.76"
+ },
+ {
+ "data_rank": "9",
+ "stck_prpr": "3270",
+ "cntg_vol": "56295",
+ "acml_vol_rlim": "6.64"
+ },
+ {
+ "data_rank": "10",
+ "stck_prpr": "3230",
+ "cntg_vol": "30998",
+ "acml_vol_rlim": "3.66"
+ },
+ {
+ "data_rank": "11",
+ "stck_prpr": "3290",
+ "cntg_vol": "27419",
+ "acml_vol_rlim": "3.24"
+ },
+ {
+ "data_rank": "12",
+ "stck_prpr": "3280",
+ "cntg_vol": "15080",
+ "acml_vol_rlim": "1.78"
+ },
+ {
+ "data_rank": "13",
+ "stck_prpr": "3295",
+ "cntg_vol": "13623",
+ "acml_vol_rlim": "1.61"
+ },
+ {
+ "data_rank": "14",
+ "stck_prpr": "3285",
+ "cntg_vol": "9580",
+ "acml_vol_rlim": "1.13"
+ },
+ {
+ "data_rank": "15",
+ "stck_prpr": "3310",
+ "cntg_vol": "3646",
+ "acml_vol_rlim": "0.43"
+ },
+ {
+ "data_rank": "16",
+ "stck_prpr": "3225",
+ "cntg_vol": "2199",
+ "acml_vol_rlim": "0.26"
+ },
+ {
+ "data_rank": "17",
+ "stck_prpr": "3300",
+ "cntg_vol": "1898",
+ "acml_vol_rlim": "0.22"
+ },
+ {
+ "data_rank": "18",
+ "stck_prpr": "3305",
+ "cntg_vol": "988",
+ "acml_vol_rlim": "0.12"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/121_국내주식-037_국내기관_외국인-매매종목가집계.md b/docs/broker/kis/rest/국내주식/시세분석/121_국내주식-037_국내기관_외국인-매매종목가집계.md
new file mode 100644
index 0000000..13117cc
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/121_국내주식-037_국내기관_외국인-매매종목가집계.md
@@ -0,0 +1,104 @@
+# 국내기관_외국인 매매종목가집계
+
+- 원본 시트명: 국내기관_외국인 매매종목가집계
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-037
+- HTTP Method: GET
+- 실전 TR_ID: FHPTJ04400000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/foreign-institution-total
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내기관_외국인 매매종목가집계 API입니다.
+
+HTS(efriend Plus) [0440] 외국인/기관 매매종목 가집계 화면을 API로 구현한 사항으로 화면을 함께 보시면 기능 이해가 쉽습니다.
+
+증권사 직원이 장중에 집계/입력한 자료를 단순 누계한 수치로서,
+입력시간은 외국인 09:30, 11:20, 13:20, 14:30 / 기관종합 10:00, 11:20, 13:20, 14:30 이며,
+입력한 시간은 ±10분정도 차이가 발생할 수 있으며, 장운영 사정에 다라 변동될 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPTJ04400000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 시장 분류 코드 | string | Y | 2 | V(Default) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | 16449(Default) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:코스피, 1001:코스닥
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조) |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 수량정열, 1: 금액정열 |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | 0: 순매수상위, 1: 순매도상위 |
+| FID_ETC_CLS_CODE | 기타 구분 정렬 | string | Y | 2 | 0:전체 1:외국인 2:기관계 3:기타 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output | 응답상세1 | object | Y | | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| ntby_qty | 순매수 수량 | string | Y | 18 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 8 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
+| ivtr_ntby_qty | 투자신탁 순매수 수량 | string | Y | 12 | |
+| bank_ntby_qty | 은행 순매수 수량 | string | Y | 12 | |
+| insu_ntby_qty | 보험 순매수 수량 | string | Y | 12 | |
+| mrbn_ntby_qty | 종금 순매수 수량 | string | Y | 12 | |
+| fund_ntby_qty | 기금 순매수 수량 | string | Y | 12 | |
+| etc_orgt_ntby_vol | 기타 단체 순매수 거래량 | string | Y | 18 | |
+| etc_corp_ntby_vol | 기타 법인 순매수 거래량 | string | Y | 18 | |
+| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | frgn_ntby_tr_pbmn ~ etc_corp_ntby_tr_pbmn
(단위 : 백만원, 수량*현재가) |
+| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
+| ivtr_ntby_tr_pbmn | 투자신탁 순매수 거래 대금 | string | Y | 18 | |
+| bank_ntby_tr_pbmn | 은행 순매수 거래 대금 | string | Y | 18 | |
+| insu_ntby_tr_pbmn | 보험 순매수 거래 대금 | string | Y | 18 | |
+| mrbn_ntby_tr_pbmn | 종금 순매수 거래 대금 | string | Y | 18 | |
+| fund_ntby_tr_pbmn | 기금 순매수 거래 대금 | string | Y | 18 | |
+| etc_orgt_ntby_tr_pbmn | 기타 단체 순매수 거래 대금 | string | Y | 18 | |
+| etc_corp_ntby_tr_pbmn | 기타 법인 순매수 거래 대금 | string | Y | 18 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/시세분석/122_국내주식-203_관심종목-그룹별-종목조회.md b/docs/broker/kis/rest/국내주식/시세분석/122_국내주식-203_관심종목-그룹별-종목조회.md
new file mode 100644
index 0000000..4d3b006
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/122_국내주식-203_관심종목-그룹별-종목조회.md
@@ -0,0 +1,385 @@
+# 관심종목 그룹별 종목조회
+
+- 원본 시트명: 관심종목 그룹별 종목조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-203
+- HTTP Method: GET
+- 실전 TR_ID: HHKCM113004C6
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/intstock-stocklist-by-group
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+관심종목 그룹별 종목조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0161] 관심종목 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+① 관심종목 그룹조회 → ② 관심종목 그룹별 종목조회 → ③ 관심종목(멀티종목) 시세조회 순서대로 호출하셔서 관심종목 시세 조회 가능합니다.
+
+※ 한 번의 호출에 최대 30종목의 시세 확인 가능합니다.
+
+한국투자증권 Github 에서 관심종목 복수시세조회 파이썬 샘플코드를 참고하실 수 있습니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/rest/get_interest_stocks_price.py
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKCM113004C6 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| TYPE | 관심종목구분코드 | string | Y | 1 | Unique key(1) |
+| USER_ID | 사용자 ID | string | Y | 16 | HTS_ID 입력 |
+| DATA_RANK | 데이터 순위 | string | Y | 10 | 공백 |
+| INTER_GRP_CODE | 관심 그룹 코드 | string | Y | 3 | 관심그룹 조회 결과의 그룹 값 입력 |
+| INTER_GRP_NAME | 관심 그룹 명 | string | Y | 40 | 공백 |
+| HTS_KOR_ISNM | HTS 한글 종목명 | string | Y | 40 | 공백 |
+| CNTG_CLS_CODE | 체결 구분 코드 | string | Y | 1 | 공백 |
+| FID_ETC_CLS_CODE | 기타 구분 코드 | string | Y | 2 | Unique key(4) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| inter_grp_name | 관심 그룹 명 | string | Y | 40 | |
+| output2 | 응답상세 | object array | Y | | array |
+| fid_mrkt_cls_code | FID 시장 구분 코드 | string | Y | 2 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| exch_code | 거래소코드 | string | Y | 4 | |
+| jong_code | 종목코드 | string | Y | 16 | |
+| color_code | 생상 코드 | string | Y | 8 | |
+| memo | 메모 | string | Y | 128 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| fxdt_ntby_qty | 기준일 순매수 수량 | string | Y | 12 | |
+| cntg_unpr | 체결단가 | string | Y | 11 | |
+| cntg_cls_code | 체결 구분 코드 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+TYPE:1
+USER_ID:{{HTS_ID}}
+DATA_RANK:
+INTER_GRP_CODE:002
+INTER_GRP_NAME:
+HTS_KOR_ISNM:
+CNTG_CLS_CODE:
+FID_ETC_CLS_CODE:4
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "data_rank": "0000000002",
+ "inter_grp_name": "관심종목02"
+ },
+ "output2": [
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000001",
+ "exch_code": "KRX",
+ "jong_code": "006840",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AK홀딩스",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000002",
+ "exch_code": "KRX",
+ "jong_code": "054620",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "APS홀딩스",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000003",
+ "exch_code": "KRX",
+ "jong_code": "265520",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AP시스템",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000004",
+ "exch_code": "KRX",
+ "jong_code": "211270",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AP위성",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000005",
+ "exch_code": "KRX",
+ "jong_code": "138930",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "BNK금융지주",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000006",
+ "exch_code": "KRX",
+ "jong_code": "001460",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "BYC",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000007",
+ "exch_code": "KRX",
+ "jong_code": "001465",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "BYC우",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000008",
+ "exch_code": "KRX",
+ "jong_code": "013720",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CBI",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000009",
+ "exch_code": "KRX",
+ "jong_code": "001040",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000010",
+ "exch_code": "KRX",
+ "jong_code": "079160",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ CGV",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000011",
+ "exch_code": "KRX",
+ "jong_code": "035760",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ ENM",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000012",
+ "exch_code": "KRX",
+ "jong_code": "311690",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ 바이오사이언스",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000013",
+ "exch_code": "KRX",
+ "jong_code": "00104K",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ4우(전환)",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000014",
+ "exch_code": "KRX",
+ "jong_code": "000120",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ대한통운",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000015",
+ "exch_code": "KRX",
+ "jong_code": "011150",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ씨푸드",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000016",
+ "exch_code": "KRX",
+ "jong_code": "011155",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "CJ씨푸드1우",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000017",
+ "exch_code": "KRX",
+ "jong_code": "060310",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "3S",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000018",
+ "exch_code": "KRX",
+ "jong_code": "095570",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AJ네트웍스",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000019",
+ "exch_code": "KRX",
+ "jong_code": "006840",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AK홀딩스",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000020",
+ "exch_code": "KRX",
+ "jong_code": "054620",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "APS",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000021",
+ "exch_code": "KRX",
+ "jong_code": "265520",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AP시스템",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ },
+ {
+ "fid_mrkt_cls_code": "J",
+ "data_rank": "0000000022",
+ "exch_code": "KRX",
+ "jong_code": "211270",
+ "color_code": "-1",
+ "memo": "",
+ "hts_kor_isnm": "AP위성",
+ "fxdt_ntby_qty": "0",
+ "cntg_unpr": "0.000000",
+ "cntg_cls_code": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/123_국내주식-197_주식현재가-회원사-종목매매동향.md b/docs/broker/kis/rest/국내주식/시세분석/123_국내주식-197_주식현재가-회원사-종목매매동향.md
new file mode 100644
index 0000000..c6c8a68
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/123_국내주식-197_주식현재가-회원사-종목매매동향.md
@@ -0,0 +1,311 @@
+# 주식현재가 회원사 종목매매동향
+
+- 원본 시트명: 주식현재가 회원사 종목매매동향
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-197
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04540000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-member-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식현재가 회원사 종목매매동향 API입니다.
+한국투자 HTS(eFriend Plus) > [0454] 증권사 종목매매동향 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04540000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J: KRX, NX: NXT, UN: 통합 |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 주식종목코드입력 |
+| FID_INPUT_ISCD_2 | 회원사코드 | string | Y | 8 | 회원사코드 (kis developers 포탈 사이트 포럼-> FAQ -> 종목정보 다운로드(국내) > 회원사 참조) |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 날짜 ~ |
+| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~ 날짜 |
+| FID_SCTN_CLS_CODE | 구간구분코드 | string | Y | 2 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| total_seln_qty | 총매도수량 | string | Y | 18 | |
+| total_shnu_qty | 총매수2수량 | string | Y | 18 | |
+| ntby_qty | 순매수수량 | string | Y | 18 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_INPUT_ISCD:136480
+FID_INPUT_ISCD_2:00003
+FID_INPUT_DATE_1:20240501
+FID_INPUT_DATE_2:20240530
+FID_SCTN_CLS_CODE:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240530",
+ "total_seln_qty": "55432",
+ "total_shnu_qty": "81112",
+ "ntby_qty": "25680",
+ "stck_prpr": "3240",
+ "prdy_vrss": "-65",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.97",
+ "acml_vol": "862835"
+ },
+ {
+ "stck_bsop_date": "20240529",
+ "total_seln_qty": "53901",
+ "total_shnu_qty": "130678",
+ "ntby_qty": "76777",
+ "stck_prpr": "3305",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.90",
+ "acml_vol": "974060"
+ },
+ {
+ "stck_bsop_date": "20240528",
+ "total_seln_qty": "139470",
+ "total_shnu_qty": "209017",
+ "ntby_qty": "69547",
+ "stck_prpr": "3335",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.89",
+ "acml_vol": "1553914"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "total_seln_qty": "239813",
+ "total_shnu_qty": "246930",
+ "ntby_qty": "7117",
+ "stck_prpr": "3365",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.88",
+ "acml_vol": "1750949"
+ },
+ {
+ "stck_bsop_date": "20240524",
+ "total_seln_qty": "1451049",
+ "total_shnu_qty": "1526087",
+ "ntby_qty": "75038",
+ "stck_prpr": "3395",
+ "prdy_vrss": "110",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.35",
+ "acml_vol": "11758204"
+ },
+ {
+ "stck_bsop_date": "20240523",
+ "total_seln_qty": "120530",
+ "total_shnu_qty": "159459",
+ "ntby_qty": "38929",
+ "stck_prpr": "3285",
+ "prdy_vrss": "-40",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.20",
+ "acml_vol": "1532424"
+ },
+ {
+ "stck_bsop_date": "20240522",
+ "total_seln_qty": "290601",
+ "total_shnu_qty": "292948",
+ "ntby_qty": "2347",
+ "stck_prpr": "3325",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.84",
+ "acml_vol": "2579194"
+ },
+ {
+ "stck_bsop_date": "20240521",
+ "total_seln_qty": "118718",
+ "total_shnu_qty": "75046",
+ "ntby_qty": "-43672",
+ "stck_prpr": "3265",
+ "prdy_vrss": "20",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.62",
+ "acml_vol": "979173"
+ },
+ {
+ "stck_bsop_date": "20240520",
+ "total_seln_qty": "400866",
+ "total_shnu_qty": "290925",
+ "ntby_qty": "-109941",
+ "stck_prpr": "3245",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.93",
+ "acml_vol": "3346515"
+ },
+ {
+ "stck_bsop_date": "20240517",
+ "total_seln_qty": "316302",
+ "total_shnu_qty": "397728",
+ "ntby_qty": "81426",
+ "stck_prpr": "3215",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.90",
+ "acml_vol": "3089567"
+ },
+ {
+ "stck_bsop_date": "20240516",
+ "total_seln_qty": "107617",
+ "total_shnu_qty": "82162",
+ "ntby_qty": "-25455",
+ "stck_prpr": "3155",
+ "prdy_vrss": "-30",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.94",
+ "acml_vol": "767201"
+ },
+ {
+ "stck_bsop_date": "20240514",
+ "total_seln_qty": "59559",
+ "total_shnu_qty": "57909",
+ "ntby_qty": "-1650",
+ "stck_prpr": "3185",
+ "prdy_vrss": "45",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.43",
+ "acml_vol": "667569"
+ },
+ {
+ "stck_bsop_date": "20240513",
+ "total_seln_qty": "70787",
+ "total_shnu_qty": "91304",
+ "ntby_qty": "20517",
+ "stck_prpr": "3140",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.57",
+ "acml_vol": "1291905"
+ },
+ {
+ "stck_bsop_date": "20240510",
+ "total_seln_qty": "227523",
+ "total_shnu_qty": "160715",
+ "ntby_qty": "-66808",
+ "stck_prpr": "3190",
+ "prdy_vrss": "45",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.43",
+ "acml_vol": "1841506"
+ },
+ {
+ "stck_bsop_date": "20240509",
+ "total_seln_qty": "331604",
+ "total_shnu_qty": "160679",
+ "ntby_qty": "-170925",
+ "stck_prpr": "3145",
+ "prdy_vrss": "-15",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.47",
+ "acml_vol": "2145427"
+ },
+ {
+ "stck_bsop_date": "20240508",
+ "total_seln_qty": "158034",
+ "total_shnu_qty": "154720",
+ "ntby_qty": "-3314",
+ "stck_prpr": "3160",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.27",
+ "acml_vol": "1915227"
+ },
+ {
+ "stck_bsop_date": "20240507",
+ "total_seln_qty": "23239",
+ "total_shnu_qty": "52555",
+ "ntby_qty": "29316",
+ "stck_prpr": "3060",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.33",
+ "acml_vol": "351326"
+ },
+ {
+ "stck_bsop_date": "20240503",
+ "total_seln_qty": "66664",
+ "total_shnu_qty": "94801",
+ "ntby_qty": "28137",
+ "stck_prpr": "3070",
+ "prdy_vrss": "-15",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.49",
+ "acml_vol": "420729"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "total_seln_qty": "46034",
+ "total_shnu_qty": "46915",
+ "ntby_qty": "881",
+ "stck_prpr": "3085",
+ "prdy_vrss": "30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.98",
+ "acml_vol": "473617"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/124_국내주식-113_종목별-프로그램매매추이일별.md b/docs/broker/kis/rest/국내주식/시세분석/124_국내주식-113_종목별-프로그램매매추이일별.md
new file mode 100644
index 0000000..adf5924
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/124_국내주식-113_종목별-프로그램매매추이일별.md
@@ -0,0 +1,170 @@
+# 종목별 프로그램매매추이(일별)
+
+- 원본 시트명: 종목별 프로그램매매추이(일별)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-113
+- HTTP Method: GET
+- 실전 TR_ID: FHPPG04650201
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/program-trade-by-stock-daily
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목별 프로그램매매추이(일별) API입니다.
+한국투자 HTS(eFriend Plus) > [0465] 종목별 프로그램 매매추이 화면(혹은 한국투자 MTS > 국내 현재가 > 기타수급 > 프로그램) 의 "일자별" 클릭 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)FHPPG04650200 → (신)FHPPG04650201' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | KRX : J , NXT : NX, 통합 : UN |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 10 | 기준일 (ex 0020240308), 미입력시 당일부터 조회 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_clpr | 주식 종가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| whol_smtn_seln_vol | 전체 합계 매도 거래량 | string | Y | 18 | |
+| whol_smtn_shnu_vol | 전체 합계 매수2 거래량 | string | Y | 18 | |
+| whol_smtn_ntby_qty | 전체 합계 순매수 수량 | string | Y | 18 | |
+| whol_smtn_seln_tr_pbmn | 전체 합계 매도 거래 대금 | string | Y | 18 | |
+| whol_smtn_shnu_tr_pbmn | 전체 합계 매수2 거래 대금 | string | Y | 18 | |
+| whol_smtn_ntby_tr_pbmn | 전체 합계 순매수 거래 대금 | string | Y | 18 | |
+| whol_ntby_vol_icdc | 전체 순매수 거래량 증감 | string | Y | 10 | |
+| whol_ntby_tr_pbmn_icdc2 | 전체 순매수 거래 대금 증감2 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_INPUT_ISCD:005930
+FID_INPUT_DATE_1:20240517
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240517",
+ "stck_clpr": "77400",
+ "prdy_vrss": "-800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.02",
+ "acml_vol": "15698949",
+ "acml_tr_pbmn": "1220563293000",
+ "whol_smtn_seln_vol": "6910299",
+ "whol_smtn_shnu_vol": "3468820",
+ "whol_smtn_ntby_qty": "-3441479",
+ "whol_smtn_seln_tr_pbmn": "536935491000",
+ "whol_smtn_shnu_tr_pbmn": "270120727200",
+ "whol_smtn_ntby_tr_pbmn": "-266814763800",
+ "whol_ntby_vol_icdc": "-3989127",
+ "whol_ntby_tr_pbmn_icdc2": "-311124223700"
+ },
+ {
+ "stck_bsop_date": "20240516",
+ "stck_clpr": "78200",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.13",
+ "acml_vol": "20989778",
+ "acml_tr_pbmn": "1656384883213",
+ "whol_smtn_seln_vol": "4747160",
+ "whol_smtn_shnu_vol": "5294808",
+ "whol_smtn_ntby_qty": "547648",
+ "whol_smtn_seln_tr_pbmn": "374517364400",
+ "whol_smtn_shnu_tr_pbmn": "418826824300",
+ "whol_smtn_ntby_tr_pbmn": "44309459900",
+ "whol_ntby_vol_icdc": "631626",
+ "whol_ntby_tr_pbmn_icdc2": "50772364600"
+ },
+ {
+ "stck_bsop_date": "20240514",
+ "stck_clpr": "78300",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.13",
+ "acml_vol": "11763992",
+ "acml_tr_pbmn": "920737809850",
+ "whol_smtn_seln_vol": "2056263",
+ "whol_smtn_shnu_vol": "1972285",
+ "whol_smtn_ntby_qty": "-83978",
+ "whol_smtn_seln_tr_pbmn": "160973460500",
+ "whol_smtn_shnu_tr_pbmn": "154510555800",
+ "whol_smtn_ntby_tr_pbmn": "-6462904700",
+ "whol_ntby_vol_icdc": "867690",
+ "whol_ntby_tr_pbmn_icdc2": "67673387000"
+ },
+ {
+ "stck_bsop_date": "20240513",
+ "stck_clpr": "78400",
+ "prdy_vrss": "-800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.01",
+ "acml_vol": "18652344",
+ "acml_tr_pbmn": "1460962492700",
+ "whol_smtn_seln_vol": "3971918",
+ "whol_smtn_shnu_vol": "3020250",
+ "whol_smtn_ntby_qty": "-951668",
+ "whol_smtn_seln_tr_pbmn": "311400439700",
+ "whol_smtn_shnu_tr_pbmn": "237264148000",
+ "whol_smtn_ntby_tr_pbmn": "-74136291700",
+ "whol_ntby_vol_icdc": "-1111550",
+ "whol_ntby_tr_pbmn_icdc2": "-87529870000"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/125_국내주식-204_관심종목-그룹조회.md b/docs/broker/kis/rest/국내주식/시세분석/125_국내주식-204_관심종목-그룹조회.md
new file mode 100644
index 0000000..003b6f4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/125_국내주식-204_관심종목-그룹조회.md
@@ -0,0 +1,124 @@
+# 관심종목 그룹조회
+
+- 원본 시트명: 관심종목 그룹조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-204
+- HTTP Method: GET
+- 실전 TR_ID: HHKCM113004C7
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/intstock-grouplist
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+관심종목 그룹조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0161] 관심종목 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+① 관심종목 그룹조회 → ② 관심종목 그룹별 종목조회 → ③ 관심종목(멀티종목) 시세조회 순서대로 호출하셔서 관심종목 시세 조회 가능합니다.
+
+※ 한 번의 호출에 최대 30종목의 시세 확인 가능합니다.
+
+한국투자증권 Github 에서 관심종목 복수시세조회 파이썬 샘플코드를 참고하실 수 있습니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/rest/get_interest_stocks_price.py
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKCM113004C7 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| TYPE | 관심종목구분코드 | string | Y | 1 | Unique key(1) |
+| FID_ETC_CLS_CODE | FID 기타 구분 코드 | string | Y | 2 | Unique key(00) |
+| USER_ID | 사용자 ID | string | Y | 16 | HTS_ID 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object | Y | | |
+| date | 일자 | string | Y | 8 | |
+| trnm_hour | 전송 시간 | string | Y | 6 | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| inter_grp_code | 관심 그룹 코드 | string | Y | 3 | |
+| inter_grp_name | 관심 그룹 명 | string | Y | 40 | |
+| ask_cnt | 요청 개수 | string | Y | 4 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+TYPE:1
+FID_ETC_CLS_CODE:00
+USER_ID:{{HTS_ID}}
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "date": "20230517",
+ "trnm_hour": "171648",
+ "data_rank": "0000000000",
+ "inter_grp_code": "001",
+ "inter_grp_name": "조건검색결과",
+ "ask_cnt": "100"
+ },
+ {
+ "date": "20240318",
+ "trnm_hour": "133351",
+ "data_rank": "0000000001",
+ "inter_grp_code": "000",
+ "inter_grp_name": "기본그룹1",
+ "ask_cnt": "011"
+ },
+ {
+ "date": "20240529",
+ "trnm_hour": "090525",
+ "data_rank": "0000000002",
+ "inter_grp_code": "002",
+ "inter_grp_name": "관심종목02",
+ "ask_cnt": "022"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/126_v1_국내주식-046_종목별-외인기관-추정가집계.md b/docs/broker/kis/rest/국내주식/시세분석/126_v1_국내주식-046_종목별-외인기관-추정가집계.md
new file mode 100644
index 0000000..cad234a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/126_v1_국내주식-046_종목별-외인기관-추정가집계.md
@@ -0,0 +1,123 @@
+# 종목별 외인기관 추정가집계
+
+- 원본 시트명: 종목별 외인기관 추정가집계
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: v1_국내주식-046
+- HTTP Method: GET
+- 실전 TR_ID: HHPTJ04160200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/investor-trend-estimate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목별 외국인, 기관 추정가집계 API입니다.
+
+한국투자 MTS > 국내 현재가 > 투자자 > 투자자동향 탭 > 왼쪽구분을 '추정(주)'로 선택 시 확인 가능한 데이터를 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+증권사 직원이 장중에 집계/입력한 자료를 단순 누계한 수치로서,
+입력시간은 외국인 09:30, 11:20, 13:20, 14:30 / 기관종합 10:00, 11:20, 13:20, 14:30 이며, 사정에 따라 변동될 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHPTJ04160200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | Array |
+| bsop_hour_gb | 입력구분 | string | Y | 1 | 1: 09시 30분 입력
2: 10시 00분 입력
3: 11시 20분 입력
4: 13시 20분 입력
5: 14시 30분 입력 |
+| frgn_fake_ntby_qty | 외국인수량(가집계) | string | Y | 18 | |
+| orgn_fake_ntby_qty | 기관수량(가집계) | string | Y | 18 | |
+| sum_fake_ntby_qty | 합산수량(가집계) | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "MKSC_SHRN_ISCD":"000660"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "bsop_hour_gb": "5",
+ "frgn_fake_ntby_qty": "-00000000000030000",
+ "orgn_fake_ntby_qty": "000000000000121000",
+ "sum_fake_ntby_qty": "000000000000091000"
+ },
+ {
+ "bsop_hour_gb": "4",
+ "frgn_fake_ntby_qty": "-00000000000093000",
+ "orgn_fake_ntby_qty": "000000000000130000",
+ "sum_fake_ntby_qty": "000000000000037000"
+ },
+ {
+ "bsop_hour_gb": "3",
+ "frgn_fake_ntby_qty": "-00000000000026000",
+ "orgn_fake_ntby_qty": "000000000000037000",
+ "sum_fake_ntby_qty": "000000000000011000"
+ },
+ {
+ "bsop_hour_gb": "2",
+ "frgn_fake_ntby_qty": "-00000000000038000",
+ "orgn_fake_ntby_qty": "000000000000022000",
+ "sum_fake_ntby_qty": "-00000000000016000"
+ },
+ {
+ "bsop_hour_gb": "1",
+ "frgn_fake_ntby_qty": "-00000000000023000",
+ "orgn_fake_ntby_qty": "000000000000000000",
+ "sum_fake_ntby_qty": "-00000000000023000"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/127_v1_국내주식-056_종목별일별매수매도체결량.md b/docs/broker/kis/rest/국내주식/시세분석/127_v1_국내주식-056_종목별일별매수매도체결량.md
new file mode 100644
index 0000000..bd2491a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/127_v1_국내주식-056_종목별일별매수매도체결량.md
@@ -0,0 +1,198 @@
+# 종목별일별매수매도체결량
+
+- 원본 시트명: 종목별일별매수매도체결량
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: v1_국내주식-056
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03010800
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-trade-volume
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+종목별일별매수매도체결량 API입니다. 실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
+국내주식 종목의 일별 매수체결량, 매도체결량 데이터를 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST03010800 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J: KRX, NX: NXT, UN: 통합 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 005930 |
+| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | from |
+| FID_INPUT_DATE_2 | FID 입력 날짜2 | string | Y | 10 | to |
+| FID_PERIOD_DIV_CODE | FID 기간 분류 코드 | string | Y | 32 | D |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| shnu_cnqn_smtn | 매수 체결량 합계 | string | Y | 18 | |
+| seln_cnqn_smtn | 매도 체결량 합계 | string | Y | 18 | |
+| output2 | 응답상세2 | object array | Y | | array |
+| stck_bsop_date | 거래상태정보 | string | Y | 8 | |
+| total_seln_qty | 총 매도 수량 | string | Y | 18 | |
+| total_shnu_qty | 총 매수 수량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "fid_cond_mrkt_div_code":"J",
+ "fid_input_iscd":"005930",
+ "fid_input_date_1":"20240101",
+ "fid_input_date_2":"20240126",
+ "fid_period_div_code":"D"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "shnu_cnqn_smtn": "4520816",
+ "seln_cnqn_smtn": "5285722"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240126",
+ "total_seln_qty": "5285722",
+ "total_shnu_qty": "4520816"
+ },
+ {
+ "stck_bsop_date": "20240125",
+ "total_seln_qty": "5610781",
+ "total_shnu_qty": "4008095"
+ },
+ {
+ "stck_bsop_date": "20240124",
+ "total_seln_qty": "7001409",
+ "total_shnu_qty": "4628223"
+ },
+ {
+ "stck_bsop_date": "20240123",
+ "total_seln_qty": "6929612",
+ "total_shnu_qty": "6221072"
+ },
+ {
+ "stck_bsop_date": "20240122",
+ "total_seln_qty": "9304203",
+ "total_shnu_qty": "8269298"
+ },
+ {
+ "stck_bsop_date": "20240119",
+ "total_seln_qty": "7937786",
+ "total_shnu_qty": "12024544"
+ },
+ {
+ "stck_bsop_date": "20240118",
+ "total_seln_qty": "7130130",
+ "total_shnu_qty": "8051305"
+ },
+ {
+ "stck_bsop_date": "20240117",
+ "total_seln_qty": "12448352",
+ "total_shnu_qty": "7781842"
+ },
+ {
+ "stck_bsop_date": "20240116",
+ "total_seln_qty": "7231456",
+ "total_shnu_qty": "5660392"
+ },
+ {
+ "stck_bsop_date": "20240115",
+ "total_seln_qty": "5146657",
+ "total_shnu_qty": "6242907"
+ },
+ {
+ "stck_bsop_date": "20240112",
+ "total_seln_qty": "6112124",
+ "total_shnu_qty": "5706461"
+ },
+ {
+ "stck_bsop_date": "20240111",
+ "total_seln_qty": "10835895",
+ "total_shnu_qty": "10905905"
+ },
+ {
+ "stck_bsop_date": "20240110",
+ "total_seln_qty": "12367976",
+ "total_shnu_qty": "6256368"
+ },
+ {
+ "stck_bsop_date": "20240109",
+ "total_seln_qty": "16376304",
+ "total_shnu_qty": "7458947"
+ },
+ {
+ "stck_bsop_date": "20240108",
+ "total_seln_qty": "5318849",
+ "total_shnu_qty": "4631085"
+ },
+ {
+ "stck_bsop_date": "20240105",
+ "total_seln_qty": "4907468",
+ "total_shnu_qty": "5219184"
+ },
+ {
+ "stck_bsop_date": "20240104",
+ "total_seln_qty": "6041013",
+ "total_shnu_qty": "7038798"
+ },
+ {
+ "stck_bsop_date": "20240103",
+ "total_seln_qty": "12066549",
+ "total_shnu_qty": "7713276"
+ },
+ {
+ "stck_bsop_date": "20240102",
+ "total_seln_qty": "5855872",
+ "total_shnu_qty": "9333762"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/128_국내주식-192_국내주식-체결금액별-매매비중.md b/docs/broker/kis/rest/국내주식/시세분석/128_국내주식-192_국내주식-체결금액별-매매비중.md
new file mode 100644
index 0000000..ad32ce1
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/128_국내주식-192_국내주식-체결금액별-매매비중.md
@@ -0,0 +1,202 @@
+# 국내주식 체결금액별 매매비중
+
+- 원본 시트명: 국내주식 체결금액별 매매비중
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-192
+- HTTP Method: GET
+- 실전 TR_ID: FHKST111900C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/tradprt-byamt
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 체결금액별 매매비중 API입니다.
+한국투자 HTS(eFriend Plus) > [0135] 체결금액별 매매비중 화면의 "상단 표" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST111900C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J: KRX, NX: NXT, UN: 통합 |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Uniquekey(11119) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 종목코드(ex)(005930 (삼성전자)) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| prpr_name | 가격명 | string | Y | 40 | |
+| smtn_avrg_prpr | 합계 평균가격 | string | Y | 10 | |
+| acml_vol | 합계 거래량 | string | Y | 18 | |
+| whol_ntby_qty_rate | 합계 순매수비율 | string | Y | 72 | |
+| ntby_cntg_csnu | 합계 순매수건수 | string | Y | 10 | |
+| seln_cnqn_smtn | 매도 거래량 | string | Y | 18 | |
+| whol_seln_vol_rate | 매도 거래량비율 | string | Y | 72 | |
+| seln_cntg_csnu | 매도 건수 | string | Y | 10 | |
+| shnu_cnqn_smtn | 매수 거래량 | string | Y | 18 | |
+| whol_shun_vol_rate | 매수 거래량비율 | string | Y | 72 | |
+| shnu_cntg_csnu | 매수 건수 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:11119
+FID_INPUT_ISCD:005930
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "prpr_name": "3백 이하",
+ "smtn_avrg_prpr": "78315",
+ "acml_vol": "291426",
+ "whol_ntby_qty_rate": "0.37",
+ "ntby_cntg_csnu": "13297",
+ "seln_cnqn_smtn": "126451",
+ "whol_seln_vol_rate": "1.21",
+ "seln_cntg_csnu": "16084",
+ "shnu_cnqn_smtn": "164975",
+ "whol_shun_vol_rate": "1.58",
+ "shnu_cntg_csnu": "29381"
+ },
+ {
+ "prpr_name": "5백 이하",
+ "smtn_avrg_prpr": "78317",
+ "acml_vol": "138138",
+ "whol_ntby_qty_rate": "-0.13",
+ "ntby_cntg_csnu": "-278",
+ "seln_cnqn_smtn": "75634",
+ "whol_seln_vol_rate": "0.73",
+ "seln_cntg_csnu": "1525",
+ "shnu_cnqn_smtn": "62504",
+ "whol_shun_vol_rate": "0.60",
+ "shnu_cntg_csnu": "1247"
+ },
+ {
+ "prpr_name": "1천 이하",
+ "smtn_avrg_prpr": "78304",
+ "acml_vol": "378958",
+ "whol_ntby_qty_rate": "0.10",
+ "ntby_cntg_csnu": "110",
+ "seln_cnqn_smtn": "184499",
+ "whol_seln_vol_rate": "1.77",
+ "seln_cntg_csnu": "2000",
+ "shnu_cnqn_smtn": "194459",
+ "whol_shun_vol_rate": "1.87",
+ "shnu_cntg_csnu": "2110"
+ },
+ {
+ "prpr_name": "3천 이하",
+ "smtn_avrg_prpr": "78328",
+ "acml_vol": "720672",
+ "whol_ntby_qty_rate": "-0.51",
+ "ntby_cntg_csnu": "-330",
+ "seln_cnqn_smtn": "387086",
+ "whol_seln_vol_rate": "3.72",
+ "seln_cntg_csnu": "1993",
+ "shnu_cnqn_smtn": "333586",
+ "whol_shun_vol_rate": "3.20",
+ "shnu_cntg_csnu": "1663"
+ },
+ {
+ "prpr_name": "5천 이하",
+ "smtn_avrg_prpr": "78349",
+ "acml_vol": "429911",
+ "whol_ntby_qty_rate": "0.16",
+ "ntby_cntg_csnu": "63",
+ "seln_cnqn_smtn": "206855",
+ "whol_seln_vol_rate": "1.99",
+ "seln_cntg_csnu": "426",
+ "shnu_cnqn_smtn": "223056",
+ "whol_shun_vol_rate": "2.14",
+ "shnu_cntg_csnu": "489"
+ },
+ {
+ "prpr_name": "1억 이하",
+ "smtn_avrg_prpr": "78336",
+ "acml_vol": "580130",
+ "whol_ntby_qty_rate": "-1.24",
+ "ntby_cntg_csnu": "-153",
+ "seln_cnqn_smtn": "354585",
+ "whol_seln_vol_rate": "3.40",
+ "seln_cntg_csnu": "402",
+ "shnu_cnqn_smtn": "225545",
+ "whol_shun_vol_rate": "2.17",
+ "shnu_cntg_csnu": "249"
+ },
+ {
+ "prpr_name": "5억 이하",
+ "smtn_avrg_prpr": "78326",
+ "acml_vol": "1664623",
+ "whol_ntby_qty_rate": "-1.57",
+ "ntby_cntg_csnu": "-61",
+ "seln_cnqn_smtn": "914220",
+ "whol_seln_vol_rate": "8.78",
+ "seln_cntg_csnu": "306",
+ "shnu_cnqn_smtn": "750403",
+ "whol_shun_vol_rate": "7.21",
+ "shnu_cntg_csnu": "245"
+ },
+ {
+ "prpr_name": "5억 초과",
+ "smtn_avrg_prpr": "78316",
+ "acml_vol": "6210233",
+ "whol_ntby_qty_rate": "-18.01",
+ "ntby_cntg_csnu": "-55",
+ "seln_cnqn_smtn": "4042917",
+ "whol_seln_vol_rate": "38.82",
+ "seln_cntg_csnu": "173",
+ "shnu_cnqn_smtn": "2167316",
+ "whol_shun_vol_rate": "20.81",
+ "shnu_cntg_csnu": "118"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/129_국내주식-116_프로그램매매-투자자매매동향당일.md b/docs/broker/kis/rest/국내주식/시세분석/129_국내주식-116_프로그램매매-투자자매매동향당일.md
new file mode 100644
index 0000000..cf5680a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/129_국내주식-116_프로그램매매-투자자매매동향당일.md
@@ -0,0 +1,346 @@
+# 프로그램매매 투자자매매동향(당일)
+
+- 원본 시트명: 프로그램매매 투자자매매동향(당일)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-116
+- HTTP Method: GET
+- 실전 TR_ID: HHPPG046600C1
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/investor-program-trade-today
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+프로그램매매 투자자매매동향(당일) API입니다.
+한국투자 HTS(eFriend Plus) > [0466] 프로그램매매 투자자별 동향 화면 의 "당일동향" 표의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)HHPPG046600C0 → (신)HHPPG046600C1' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| EXCH_DIV_CLS_CODE | 거래소 구분 코드 | string | Y | 2 | J : KRX, NX : NXT, UN : 통합 |
+| MRKT_DIV_CLS_CODE | 시장 구분 코드 | string | Y | 1 | 1:코스피, 4:코스닥 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| invr_cls_code | 투자자코드 | string | Y | 4 | |
+| all_seln_qty | 전체매도수량 | string | Y | 18 | |
+| all_seln_amt | 전체매도대금 | string | Y | 18 | |
+| invr_cls_name | 투자자 구분 명 | string | Y | 20 | |
+| all_shnu_qty | 전체매수수량 | string | Y | 18 | |
+| all_shnu_amt | 전체매수대금 | string | Y | 18 | |
+| all_ntby_amt | 전체순매수대금 | string | Y | 12 | |
+| arbt_seln_qty | 차익매도수량 | string | Y | 18 | |
+| all_ntby_qty | 전체순매수수량 | string | Y | 12 | |
+| arbt_shnu_qty | 차익매수수량 | string | Y | 18 | |
+| arbt_ntby_qty | 차익순매수수량 | string | Y | 12 | |
+| arbt_seln_amt | 차익매도대금 | string | Y | 18 | |
+| arbt_shnu_amt | 차익매수대금 | string | Y | 18 | |
+| arbt_ntby_amt | 차익순매수대금 | string | Y | 12 | |
+| nabt_seln_qty | 비차익매도수량 | string | Y | 18 | |
+| nabt_shnu_qty | 비차익매수수량 | string | Y | 18 | |
+| nabt_ntby_qty | 비차익순매수수량 | string | Y | 12 | |
+| nabt_seln_amt | 비차익매도대금 | string | Y | 18 | |
+| nabt_shnu_amt | 비차익매수대금 | string | Y | 18 | |
+| nabt_ntby_amt | 비차익순매수대금 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+MRKT_DIV_CLS_CODE:1
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "invr_cls_code": "7100",
+ "invr_cls_name": "기 타",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "289",
+ "nabt_shnu_qty": "242",
+ "nabt_ntby_qty": "-47",
+ "nabt_seln_amt": "7151",
+ "nabt_shnu_amt": "4006",
+ "nabt_ntby_amt": "-3145",
+ "all_seln_qty": "289",
+ "all_shnu_qty": "242",
+ "all_ntby_qty": "-47",
+ "all_seln_amt": "7151",
+ "all_shnu_amt": "4006",
+ "all_ntby_amt": "-3145"
+ },
+ {
+ "invr_cls_code": "6000",
+ "invr_cls_name": "연기금등",
+ "arbt_seln_qty": "440",
+ "arbt_shnu_qty": "410",
+ "arbt_ntby_qty": "-29",
+ "arbt_seln_amt": "27863",
+ "arbt_shnu_amt": "25971",
+ "arbt_ntby_amt": "-1891",
+ "nabt_seln_qty": "608",
+ "nabt_shnu_qty": "474",
+ "nabt_ntby_qty": "-134",
+ "nabt_seln_amt": "16795",
+ "nabt_shnu_amt": "23282",
+ "nabt_ntby_amt": "6486",
+ "all_seln_qty": "1049",
+ "all_shnu_qty": "885",
+ "all_ntby_qty": "-164",
+ "all_seln_amt": "44658",
+ "all_shnu_amt": "49253",
+ "all_ntby_amt": "4595"
+ },
+ {
+ "invr_cls_code": "5000",
+ "invr_cls_name": "기타금융",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "0",
+ "nabt_shnu_qty": "0",
+ "nabt_ntby_qty": "0",
+ "nabt_seln_amt": "0",
+ "nabt_shnu_amt": "20",
+ "nabt_ntby_amt": "20",
+ "all_seln_qty": "0",
+ "all_shnu_qty": "0",
+ "all_ntby_qty": "0",
+ "all_seln_amt": "0",
+ "all_shnu_amt": "20",
+ "all_ntby_amt": "20"
+ },
+ {
+ "invr_cls_code": "2000",
+ "invr_cls_name": "보 험",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "211",
+ "nabt_shnu_qty": "110",
+ "nabt_ntby_qty": "-101",
+ "nabt_seln_amt": "12580",
+ "nabt_shnu_amt": "6296",
+ "nabt_ntby_amt": "-6283",
+ "all_seln_qty": "211",
+ "all_shnu_qty": "110",
+ "all_ntby_qty": "-101",
+ "all_seln_amt": "12580",
+ "all_shnu_amt": "6296",
+ "all_ntby_amt": "-6283"
+ },
+ {
+ "invr_cls_code": "4000",
+ "invr_cls_name": "은 행",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "28",
+ "nabt_shnu_qty": "65",
+ "nabt_ntby_qty": "36",
+ "nabt_seln_amt": "563",
+ "nabt_shnu_amt": "851",
+ "nabt_ntby_amt": "288",
+ "all_seln_qty": "28",
+ "all_shnu_qty": "65",
+ "all_ntby_qty": "36",
+ "all_seln_amt": "563",
+ "all_shnu_amt": "851",
+ "all_ntby_amt": "288"
+ },
+ {
+ "invr_cls_code": "3100",
+ "invr_cls_name": "사 모",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "303",
+ "nabt_shnu_qty": "181",
+ "nabt_ntby_qty": "-121",
+ "nabt_seln_amt": "12440",
+ "nabt_shnu_amt": "8092",
+ "nabt_ntby_amt": "-4348",
+ "all_seln_qty": "303",
+ "all_shnu_qty": "181",
+ "all_ntby_qty": "-121",
+ "all_seln_amt": "12440",
+ "all_shnu_amt": "8092",
+ "all_ntby_amt": "-4348"
+ },
+ {
+ "invr_cls_code": "3000",
+ "invr_cls_name": "투 신",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "764",
+ "nabt_shnu_qty": "806",
+ "nabt_ntby_qty": "41",
+ "nabt_seln_amt": "41009",
+ "nabt_shnu_amt": "38826",
+ "nabt_ntby_amt": "-2183",
+ "all_seln_qty": "764",
+ "all_shnu_qty": "806",
+ "all_ntby_qty": "41",
+ "all_seln_amt": "41009",
+ "all_shnu_amt": "38826",
+ "all_ntby_amt": "-2183"
+ },
+ {
+ "invr_cls_code": "1000",
+ "invr_cls_name": "금융투자",
+ "arbt_seln_qty": "445",
+ "arbt_shnu_qty": "2",
+ "arbt_ntby_qty": "-443",
+ "arbt_seln_amt": "28429",
+ "arbt_shnu_amt": "143",
+ "arbt_ntby_amt": "-28285",
+ "nabt_seln_qty": "98",
+ "nabt_shnu_qty": "70",
+ "nabt_ntby_qty": "-27",
+ "nabt_seln_amt": "5176",
+ "nabt_shnu_amt": "6003",
+ "nabt_ntby_amt": "826",
+ "all_seln_qty": "543",
+ "all_shnu_qty": "72",
+ "all_ntby_qty": "-470",
+ "all_seln_amt": "33605",
+ "all_shnu_amt": "6146",
+ "all_ntby_amt": "-27459"
+ },
+ {
+ "invr_cls_code": "8888",
+ "invr_cls_name": "기 관",
+ "arbt_seln_qty": "885",
+ "arbt_shnu_qty": "413",
+ "arbt_ntby_qty": "-472",
+ "arbt_seln_amt": "56292",
+ "arbt_shnu_amt": "26114",
+ "arbt_ntby_amt": "-30177",
+ "nabt_seln_qty": "2014",
+ "nabt_shnu_qty": "1709",
+ "nabt_ntby_qty": "-305",
+ "nabt_seln_amt": "88565",
+ "nabt_shnu_amt": "83373",
+ "nabt_ntby_amt": "-5192",
+ "all_seln_qty": "2900",
+ "all_shnu_qty": "2122",
+ "all_ntby_qty": "-778",
+ "all_seln_amt": "144858",
+ "all_shnu_amt": "109487",
+ "all_ntby_amt": "-35370"
+ },
+ {
+ "invr_cls_code": "8000",
+ "invr_cls_name": "개 인",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "0",
+ "arbt_ntby_qty": "0",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "0",
+ "arbt_ntby_amt": "0",
+ "nabt_seln_qty": "683",
+ "nabt_shnu_qty": "528",
+ "nabt_ntby_qty": "-154",
+ "nabt_seln_amt": "16867",
+ "nabt_shnu_amt": "9496",
+ "nabt_ntby_amt": "-7371",
+ "all_seln_qty": "683",
+ "all_shnu_qty": "528",
+ "all_ntby_qty": "-154",
+ "all_seln_amt": "16867",
+ "all_shnu_amt": "9496",
+ "all_ntby_amt": "-7371"
+ },
+ {
+ "invr_cls_code": "9100",
+ "invr_cls_name": "외국인",
+ "arbt_seln_qty": "0",
+ "arbt_shnu_qty": "57",
+ "arbt_ntby_qty": "57",
+ "arbt_seln_amt": "0",
+ "arbt_shnu_amt": "4321",
+ "arbt_ntby_amt": "4321",
+ "nabt_seln_qty": "88573",
+ "nabt_shnu_qty": "73539",
+ "nabt_ntby_qty": "-15034",
+ "nabt_seln_amt": "2640145",
+ "nabt_shnu_amt": "1983063",
+ "nabt_ntby_amt": "-657082",
+ "all_seln_qty": "88573",
+ "all_shnu_qty": "73596",
+ "all_ntby_qty": "-14976",
+ "all_seln_amt": "2640145",
+ "all_shnu_amt": "1987384",
+ "all_ntby_amt": "-652761"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/130_국내주식-193_국내-증시자금-종합.md b/docs/broker/kis/rest/국내주식/시세분석/130_국내주식-193_국내-증시자금-종합.md
new file mode 100644
index 0000000..24113e4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/130_국내주식-193_국내-증시자금-종합.md
@@ -0,0 +1,331 @@
+# 국내 증시자금 종합
+
+- 원본 시트명: 국내 증시자금 종합
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-193
+- HTTP Method: GET
+- 실전 TR_ID: FHKST649100C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/mktfunds
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내 증시자금 종합 API입니다.
+한국투자 HTS(eFriend Plus) > [0470] 증시자금 종합 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다. (단위: 억원)
+
+※ 해당자료는 금융투자협회의 자료를 제공하고 있으며, 오류와 지연이 발생할 수 있습니다.
+※ 위 정보에 의한 투자판단의 최종책임은 정보이용자에게 있으며, 당사와 한국금융투자협회는 어떠한 법적인 책임도 지지 않사오니 투자에 참고로만 이용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST649100C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_date | 영업일자 | string | Y | 8 | |
+| bstp_nmix_prpr | 업종지수현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종지수전일대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | 1. 상한 2. 상승 3. 보합 4. 하한 5. 하락 |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| hts_avls | HTS시가총액 | string | Y | 18 | 단위: 백만원 |
+| cust_dpmn_amt | 고객예탁금금액 | string | Y | 18 | 단위: 억원 |
+| cust_dpmn_amt_prdy_vrss | 고객예탁금금액전일대비 | string | Y | 18 | |
+| amt_tnrt | 금액회전율 | string | Y | 84 | |
+| uncl_amt | 미수금액 | string | Y | 18 | 단위: 억원 |
+| crdt_loan_rmnd | 신용융자잔고 | string | Y | 18 | 단위: 억원 |
+| futs_tfam_amt | 선물예수금금액 | string | Y | 18 | 단위: 억원 |
+| sttp_amt | 주식형금액 | string | Y | 18 | 단위: 억원 |
+| mxtp_amt | 혼합형금액 | string | Y | 18 | 단위: 억원 |
+| bntp_amt | 채권형금액 | string | Y | 18 | 단위: 억원 |
+| mmf_amt | MMF금액 | string | Y | 18 | 단위: 억원 |
+| secu_lend_amt | 담보대출잔고금액 | string | Y | 18 | 단위: 억원 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_INPUT_DATE_1:20240503
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_date": "20240430",
+ "bstp_nmix_prpr": "2692.06",
+ "bstp_nmix_prdy_vrss": "4.62",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "100.17",
+ "hts_avls": "2193843858",
+ "cust_dpmn_amt": "572306",
+ "cust_dpmn_amt_prdy_vrss": "4435",
+ "amt_tnrt": "33.87",
+ "uncl_amt": "9289",
+ "crdt_loan_rmnd": "191730",
+ "futs_tfam_amt": "112724",
+ "sttp_amt": "1112330",
+ "mxtp_amt": "264052",
+ "bntp_amt": "1497053",
+ "mmf_amt": "1971372",
+ "secu_lend_amt": "199663"
+ },
+ {
+ "bsop_date": "20240429",
+ "bstp_nmix_prpr": "2687.44",
+ "bstp_nmix_prdy_vrss": "31.11",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "101.17",
+ "hts_avls": "2189691726",
+ "cust_dpmn_amt": "567872",
+ "cust_dpmn_amt_prdy_vrss": "2770",
+ "amt_tnrt": "31.81",
+ "uncl_amt": "9770",
+ "crdt_loan_rmnd": "191876",
+ "futs_tfam_amt": "114477",
+ "sttp_amt": "1108725",
+ "mxtp_amt": "264014",
+ "bntp_amt": "1490082",
+ "mmf_amt": "1995789",
+ "secu_lend_amt": "205197"
+ },
+ {
+ "bsop_date": "20240426",
+ "bstp_nmix_prpr": "2656.33",
+ "bstp_nmix_prdy_vrss": "27.71",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "101.05",
+ "hts_avls": "2164477451",
+ "cust_dpmn_amt": "565102",
+ "cust_dpmn_amt_prdy_vrss": "8389",
+ "amt_tnrt": "32.27",
+ "uncl_amt": "9224",
+ "crdt_loan_rmnd": "190610",
+ "futs_tfam_amt": "114228",
+ "sttp_amt": "1099696",
+ "mxtp_amt": "263514",
+ "bntp_amt": "1486148",
+ "mmf_amt": "2014269",
+ "secu_lend_amt": "200841"
+ },
+ {
+ "bsop_date": "20240425",
+ "bstp_nmix_prpr": "2628.62",
+ "bstp_nmix_prdy_vrss": "-47.13",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "98.24",
+ "hts_avls": "2142440795",
+ "cust_dpmn_amt": "556713",
+ "cust_dpmn_amt_prdy_vrss": "9753",
+ "amt_tnrt": "30.55",
+ "uncl_amt": "9460",
+ "crdt_loan_rmnd": "190653",
+ "futs_tfam_amt": "119102",
+ "sttp_amt": "1091640",
+ "mxtp_amt": "263032",
+ "bntp_amt": "1486119",
+ "mmf_amt": "2034032",
+ "secu_lend_amt": "197721"
+ },
+ {
+ "bsop_date": "20240424",
+ "bstp_nmix_prpr": "2675.75",
+ "bstp_nmix_prdy_vrss": "52.73",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "102.01",
+ "hts_avls": "2180629130",
+ "cust_dpmn_amt": "546960",
+ "cust_dpmn_amt_prdy_vrss": "-11693",
+ "amt_tnrt": "33.20",
+ "uncl_amt": "9503",
+ "crdt_loan_rmnd": "189912",
+ "futs_tfam_amt": "118058",
+ "sttp_amt": "1095621",
+ "mxtp_amt": "262947",
+ "bntp_amt": "1484163",
+ "mmf_amt": "2055945",
+ "secu_lend_amt": "199263"
+ },
+ {
+ "bsop_date": "20240423",
+ "bstp_nmix_prpr": "2623.02",
+ "bstp_nmix_prdy_vrss": "-6.42",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "99.76",
+ "hts_avls": "2137640963",
+ "cust_dpmn_amt": "558653",
+ "cust_dpmn_amt_prdy_vrss": "-7143",
+ "amt_tnrt": "31.04",
+ "uncl_amt": "9454",
+ "crdt_loan_rmnd": "190361",
+ "futs_tfam_amt": "117715",
+ "sttp_amt": "1083125",
+ "mxtp_amt": "262801",
+ "bntp_amt": "1481191",
+ "mmf_amt": "2059132",
+ "secu_lend_amt": "198055"
+ },
+ {
+ "bsop_date": "20240422",
+ "bstp_nmix_prpr": "2629.44",
+ "bstp_nmix_prdy_vrss": "37.58",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "101.45",
+ "hts_avls": "2143157216",
+ "cust_dpmn_amt": "565797",
+ "cust_dpmn_amt_prdy_vrss": "11043",
+ "amt_tnrt": "33.64",
+ "uncl_amt": "9312",
+ "crdt_loan_rmnd": "190326",
+ "futs_tfam_amt": "118954",
+ "sttp_amt": "1085224",
+ "mxtp_amt": "262713",
+ "bntp_amt": "1477973",
+ "mmf_amt": "2083552",
+ "secu_lend_amt": "197038"
+ },
+ {
+ "bsop_date": "20240419",
+ "bstp_nmix_prpr": "2591.86",
+ "bstp_nmix_prdy_vrss": "-42.84",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "98.37",
+ "hts_avls": "2113960518",
+ "cust_dpmn_amt": "554754",
+ "cust_dpmn_amt_prdy_vrss": "4154",
+ "amt_tnrt": "41.58",
+ "uncl_amt": "9806",
+ "crdt_loan_rmnd": "190624",
+ "futs_tfam_amt": "119487",
+ "sttp_amt": "1083386",
+ "mxtp_amt": "262645",
+ "bntp_amt": "1475873",
+ "mmf_amt": "2087866",
+ "secu_lend_amt": "198926"
+ },
+ {
+ "bsop_date": "20240418",
+ "bstp_nmix_prpr": "2634.70",
+ "bstp_nmix_prdy_vrss": "50.52",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "101.95",
+ "hts_avls": "2148591607",
+ "cust_dpmn_amt": "550600",
+ "cust_dpmn_amt_prdy_vrss": "-2090",
+ "amt_tnrt": "33.32",
+ "uncl_amt": "9932",
+ "crdt_loan_rmnd": "191816",
+ "futs_tfam_amt": "115974",
+ "sttp_amt": "1088431",
+ "mxtp_amt": "261979",
+ "bntp_amt": "1472540",
+ "mmf_amt": "2096220",
+ "secu_lend_amt": "199652"
+ },
+ {
+ "bsop_date": "20240417",
+ "bstp_nmix_prpr": "2584.18",
+ "bstp_nmix_prdy_vrss": "-25.45",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "99.02",
+ "hts_avls": "2108636206",
+ "cust_dpmn_amt": "552690",
+ "cust_dpmn_amt_prdy_vrss": "-23278",
+ "amt_tnrt": "32.09",
+ "uncl_amt": "9653",
+ "crdt_loan_rmnd": "194102",
+ "futs_tfam_amt": "114956",
+ "sttp_amt": "1086475",
+ "mxtp_amt": "261671",
+ "bntp_amt": "1472499",
+ "mmf_amt": "2109537",
+ "secu_lend_amt": "198961"
+ },
+ {
+ "bsop_date": "20240416",
+ "bstp_nmix_prpr": "2609.63",
+ "bstp_nmix_prdy_vrss": "-60.80",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "97.72",
+ "hts_avls": "2129095534",
+ "cust_dpmn_amt": "575969",
+ "cust_dpmn_amt_prdy_vrss": "9287",
+ "amt_tnrt": "35.91",
+ "uncl_amt": "9583",
+ "crdt_loan_rmnd": "193485",
+ "futs_tfam_amt": "116520",
+ "sttp_amt": "1092931",
+ "mxtp_amt": "261632",
+ "bntp_amt": "1471604",
+ "mmf_amt": "2083522",
+ "secu_lend_amt": "198067"
+ },...
+ {
+ "bsop_date": "20231204",
+ "bstp_nmix_prpr": "2514.95",
+ "bstp_nmix_prdy_vrss": "9.94",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "100.40",
+ "hts_avls": "2012605764",
+ "cust_dpmn_amt": "483930",
+ "cust_dpmn_amt_prdy_vrss": "-2751",
+ "amt_tnrt": "39.82",
+ "uncl_amt": "9477",
+ "crdt_loan_rmnd": "172738",
+ "futs_tfam_amt": "111758",
+ "sttp_amt": "1020141",
+ "mxtp_amt": "241287",
+ "bntp_amt": "1372663",
+ "mmf_amt": "1937326",
+ "secu_lend_amt": "212773"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/131_국내주식-118_국내주식-예상체결가-추이.md b/docs/broker/kis/rest/국내주식/시세분석/131_국내주식-118_국내주식-예상체결가-추이.md
new file mode 100644
index 0000000..0d4daef
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/131_국내주식-118_국내주식-예상체결가-추이.md
@@ -0,0 +1,384 @@
+# 국내주식 예상체결가 추이
+
+- 원본 시트명: 국내주식 예상체결가 추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-118
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01810000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/exp-price-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예상체결가 추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0184] 예상체결지수 추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01810000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_mkop_cls_code | 장운영 구분 코드 | string | Y | 12 | 0:전체, 4:체결량 0 제외 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 5 | 종목코드(ex. 005930) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
+| antc_cnpr | 예상 체결가 | string | Y | 10 | |
+| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
+| antc_cntg_vrss | 예상 체결 대비 | string | Y | 10 | |
+| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
+| antc_vol | 예상 거래량 | string | Y | 18 | |
+| antc_tr_pbmn | 예상 거래대금 | string | Y | 19 | |
+| output2 | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_mkop_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "rprs_mrkt_kor_name": "KOSPI200",
+ "antc_cnpr": "72600",
+ "antc_cntg_vrss_sign": "2",
+ "antc_cntg_vrss": "300",
+ "antc_cntg_prdy_ctrt": "0.41",
+ "antc_vol": "420303",
+ "antc_tr_pbmn": "30513997800"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090023",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "420303"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090023",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "420196"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090023",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "420206"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090023",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "419330"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090022",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "419131"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090022",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418134"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090022",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418123"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090021",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418123"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090020",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418123"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090019",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418123"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090019",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418120"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090018",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418120"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090017",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418120"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090017",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418121"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090016",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418121"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090016",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "418003"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090016",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417953"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090016",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417729"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090016",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417679"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417679"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417060"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "417050"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416945"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416921"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090015",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416915"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090014",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416915"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090014",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416770"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090014",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "416759"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090014",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "415059"
+ },
+ {
+ "stck_bsop_date": "20240318",
+ "stck_cntg_hour": "090013",
+ "stck_prpr": "72600",
+ "prdy_vrss_sign": "2",
+ "prdy_vrss": "300",
+ "prdy_ctrt": "0.41",
+ "acml_vol": "414942"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/133_v1_국내주식-074_시장별-투자자매매동향시세.md b/docs/broker/kis/rest/국내주식/시세분석/133_v1_국내주식-074_시장별-투자자매매동향시세.md
new file mode 100644
index 0000000..a380408
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/133_v1_국내주식-074_시장별-투자자매매동향시세.md
@@ -0,0 +1,233 @@
+# 시장별 투자자매매동향(시세)
+
+- 원본 시트명: 시장별 투자자매매동향(시세)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: v1_국내주식-074
+- HTTP Method: GET
+- 실전 TR_ID: FHPTJ04030000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-investor-time-by-market
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+시장별 투자자매매동향(시세성) API입니다.
+한국투자 HTS(eFriend Plus) > [0403] 시장별 시간동향 의 상단 표 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPTJ04030000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | 시장구분 | string | Y | 12 | 코스피: KSP, 코스닥:KSQ,
선물,콜옵션,풋옵션 : K2I, 주식선물:999,
ETF: ETF, ELW:ELW, ETN: ETN,
미니: MKI, 위클리월 : WKM, 위클리목: WKI
코스닥150: KQI |
+| fid_input_iscd_2 | 업종구분 | string | Y | 8 | - fid_input_iscd: KSP(코스피) 혹은 KSQ(코스닥)인 경우
코스피(0001_종합, .…0027_제조업 )
코스닥(1001_종합, …. 1041_IT부품)
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조)
- fid_input_iscd가 K2I인 경우
F001(선물)
OC01(콜옵션)
OP01(풋옵션)
- fid_input_iscd가 999인 경우
S001(주식선물)
- fid_input_iscd가 ETF인 경우
T000(ETF)
- fid_input_iscd가 ELW인 경우
W000(ELW)
- fid_input_iscd가 ETN인 경우
E199(ETN)
- fid_input_iscd가 MKI인 경우
F004(미니선물)
OC02(미니콜옵션)
OP02(미니풋옵션)
- fid_input_iscd가 WKM인 경우
OC05(위클리콜(월))
OP05(위클리풋(월))
- fid_input_iscd가 WKI인 경우
OC04(위클리콜(목))
OP04(위클리풋(목))
- fid_input_iscd가 KQI인 경우
F002(코스닥150선물)
OC03(코스닥150콜옵션)
OP03(코스닥150풋옵션) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| frgn_seln_vol | 외국인 매도 거래량 | string | Y | 18 | |
+| frgn_shnu_vol | 외국인 매수2 거래량 | string | Y | 18 | |
+| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
+| frgn_seln_tr_pbmn | 외국인 매도 거래 대금 | string | Y | 18 | |
+| frgn_shnu_tr_pbmn | 외국인 매수2 거래 대금 | string | Y | 18 | |
+| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | |
+| prsn_seln_vol | 개인 매도 거래량 | string | Y | 18 | |
+| prsn_shnu_vol | 개인 매수2 거래량 | string | Y | 18 | |
+| prsn_ntby_qty | 개인 순매수 수량 | string | Y | 12 | |
+| prsn_seln_tr_pbmn | 개인 매도 거래 대금 | string | Y | 18 | |
+| prsn_shnu_tr_pbmn | 개인 매수2 거래 대금 | string | Y | 18 | |
+| prsn_ntby_tr_pbmn | 개인 순매수 거래 대금 | string | Y | 18 | |
+| orgn_seln_vol | 기관계 매도 거래량 | string | Y | 18 | |
+| orgn_shnu_vol | 기관계 매수2 거래량 | string | Y | 18 | |
+| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
+| orgn_seln_tr_pbmn | 기관계 매도 거래 대금 | string | Y | 18 | |
+| orgn_shnu_tr_pbmn | 기관계 매수2 거래 대금 | string | Y | 18 | |
+| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
+| scrt_seln_vol | 증권 매도 거래량 | string | Y | 18 | |
+| scrt_shnu_vol | 증권 매수2 거래량 | string | Y | 18 | |
+| scrt_ntby_qty | 증권 순매수 수량 | string | Y | 12 | |
+| scrt_seln_tr_pbmn | 증권 매도 거래 대금 | string | Y | 18 | |
+| scrt_shnu_tr_pbmn | 증권 매수2 거래 대금 | string | Y | 18 | |
+| scrt_ntby_tr_pbmn | 증권 순매수 거래 대금 | string | Y | 18 | |
+| ivtr_seln_vol | 투자신탁 매도 거래량 | string | Y | 18 | |
+| ivtr_shnu_vol | 투자신탁 매수2 거래량 | string | Y | 18 | |
+| ivtr_ntby_qty | 투자신탁 순매수 수량 | string | Y | 12 | |
+| ivtr_seln_tr_pbmn | 투자신탁 매도 거래 대금 | string | Y | 18 | |
+| ivtr_shnu_tr_pbmn | 투자신탁 매수2 거래 대금 | string | Y | 18 | |
+| ivtr_ntby_tr_pbmn | 투자신탁 순매수 거래 대금 | string | Y | 18 | |
+| pe_fund_seln_tr_pbmn | 사모 펀드 매도 거래 대금 | string | Y | 18 | |
+| pe_fund_seln_vol | 사모 펀드 매도 거래량 | string | Y | 18 | |
+| pe_fund_ntby_vol | 사모 펀드 순매수 거래량 | string | Y | 18 | |
+| pe_fund_shnu_tr_pbmn | 사모 펀드 매수2 거래 대금 | string | Y | 18 | |
+| pe_fund_shnu_vol | 사모 펀드 매수2 거래량 | string | Y | 18 | |
+| pe_fund_ntby_tr_pbmn | 사모 펀드 순매수 거래 대금 | string | Y | 18 | |
+| bank_seln_vol | 은행 매도 거래량 | string | Y | 18 | |
+| bank_shnu_vol | 은행 매수2 거래량 | string | Y | 18 | |
+| bank_ntby_qty | 은행 순매수 수량 | string | Y | 12 | |
+| bank_seln_tr_pbmn | 은행 매도 거래 대금 | string | Y | 18 | |
+| bank_shnu_tr_pbmn | 은행 매수2 거래 대금 | string | Y | 18 | |
+| bank_ntby_tr_pbmn | 은행 순매수 거래 대금 | string | Y | 18 | |
+| insu_seln_vol | 보험 매도 거래량 | string | Y | 18 | |
+| insu_shnu_vol | 보험 매수2 거래량 | string | Y | 18 | |
+| insu_ntby_qty | 보험 순매수 수량 | string | Y | 12 | |
+| insu_seln_tr_pbmn | 보험 매도 거래 대금 | string | Y | 18 | |
+| insu_shnu_tr_pbmn | 보험 매수2 거래 대금 | string | Y | 18 | |
+| insu_ntby_tr_pbmn | 보험 순매수 거래 대금 | string | Y | 18 | |
+| mrbn_seln_vol | 종금 매도 거래량 | string | Y | 18 | |
+| mrbn_shnu_vol | 종금 매수2 거래량 | string | Y | 18 | |
+| mrbn_ntby_qty | 종금 순매수 수량 | string | Y | 12 | |
+| mrbn_seln_tr_pbmn | 종금 매도 거래 대금 | string | Y | 18 | |
+| mrbn_shnu_tr_pbmn | 종금 매수2 거래 대금 | string | Y | 18 | |
+| mrbn_ntby_tr_pbmn | 종금 순매수 거래 대금 | string | Y | 18 | |
+| fund_seln_vol | 기금 매도 거래량 | string | Y | 18 | |
+| fund_shnu_vol | 기금 매수2 거래량 | string | Y | 18 | |
+| fund_ntby_qty | 기금 순매수 수량 | string | Y | 12 | |
+| fund_seln_tr_pbmn | 기금 매도 거래 대금 | string | Y | 18 | |
+| fund_shnu_tr_pbmn | 기금 매수2 거래 대금 | string | Y | 18 | |
+| fund_ntby_tr_pbmn | 기금 순매수 거래 대금 | string | Y | 18 | |
+| etc_orgt_seln_vol | 기타 단체 매도 거래량 | string | Y | 18 | |
+| etc_orgt_shnu_vol | 기타 단체 매수2 거래량 | string | Y | 18 | |
+| etc_orgt_ntby_vol | 기타 단체 순매수 거래량 | string | Y | 18 | |
+| etc_orgt_seln_tr_pbmn | 기타 단체 매도 거래 대금 | string | Y | 18 | |
+| etc_orgt_shnu_tr_pbmn | 기타 단체 매수2 거래 대금 | string | Y | 18 | |
+| etc_orgt_ntby_tr_pbmn | 기타 단체 순매수 거래 대금 | string | Y | 18 | |
+| etc_corp_seln_vol | 기타 법인 매도 거래량 | string | Y | 18 | |
+| etc_corp_shnu_vol | 기타 법인 매수2 거래량 | string | Y | 18 | |
+| etc_corp_ntby_vol | 기타 법인 순매수 거래량 | string | Y | 18 | |
+| etc_corp_seln_tr_pbmn | 기타 법인 매도 거래 대금 | string | Y | 18 | |
+| etc_corp_shnu_tr_pbmn | 기타 법인 매수2 거래 대금 | string | Y | 18 | |
+| etc_corp_ntby_tr_pbmn | 기타 법인 순매수 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"FID_INPUT_ISCD":"KSP",
+"FID_INPUT_ISCD_2":"0001"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "frgn_seln_vol": "75588",
+ "frgn_shnu_vol": "70298",
+ "frgn_ntby_qty": "-5290",
+ "frgn_seln_tr_pbmn": "2818983",
+ "frgn_shnu_tr_pbmn": "2967639",
+ "frgn_ntby_tr_pbmn": "148656",
+ "prsn_seln_vol": "294375",
+ "prsn_shnu_vol": "300449",
+ "prsn_ntby_qty": "6074",
+ "prsn_seln_tr_pbmn": "5131230",
+ "prsn_shnu_tr_pbmn": "5020361",
+ "prsn_ntby_tr_pbmn": "-110869",
+ "orgn_seln_vol": "36911",
+ "orgn_shnu_vol": "37631",
+ "orgn_ntby_qty": "720",
+ "orgn_seln_tr_pbmn": "2110371",
+ "orgn_shnu_tr_pbmn": "2054839",
+ "orgn_ntby_tr_pbmn": "-55532",
+ "scrt_seln_vol": "8493",
+ "scrt_shnu_vol": "12126",
+ "scrt_ntby_qty": "3633",
+ "scrt_seln_tr_pbmn": "384357",
+ "scrt_shnu_tr_pbmn": "472598",
+ "scrt_ntby_tr_pbmn": "88241",
+ "ivtr_seln_vol": "4086",
+ "ivtr_shnu_vol": "3964",
+ "ivtr_ntby_qty": "-122",
+ "ivtr_seln_tr_pbmn": "177374",
+ "ivtr_shnu_tr_pbmn": "165434",
+ "ivtr_ntby_tr_pbmn": "-11940",
+ "pe_fund_seln_tr_pbmn": "213413",
+ "pe_fund_seln_vol": "4833",
+ "pe_fund_ntby_vol": "-1804",
+ "pe_fund_shnu_tr_pbmn": "115551",
+ "pe_fund_shnu_vol": "3029",
+ "pe_fund_ntby_tr_pbmn": "-97861",
+ "bank_seln_vol": "245",
+ "bank_shnu_vol": "51",
+ "bank_ntby_qty": "-193",
+ "bank_seln_tr_pbmn": "13382",
+ "bank_shnu_tr_pbmn": "2873",
+ "bank_ntby_tr_pbmn": "-10509",
+ "insu_seln_vol": "1653",
+ "insu_shnu_vol": "1050",
+ "insu_ntby_qty": "-603",
+ "insu_seln_tr_pbmn": "79782",
+ "insu_shnu_tr_pbmn": "50378",
+ "insu_ntby_tr_pbmn": "-29404",
+ "mrbn_seln_vol": "230",
+ "mrbn_shnu_vol": "310",
+ "mrbn_ntby_qty": "80",
+ "mrbn_seln_tr_pbmn": "10393",
+ "mrbn_shnu_tr_pbmn": "11896",
+ "mrbn_ntby_tr_pbmn": "1502",
+ "fund_seln_vol": "17372",
+ "fund_shnu_vol": "17101",
+ "fund_ntby_qty": "-271",
+ "fund_seln_tr_pbmn": "1231671",
+ "fund_shnu_tr_pbmn": "1236109",
+ "fund_ntby_tr_pbmn": "4439",
+ "etc_orgt_seln_vol": "0",
+ "etc_orgt_shnu_vol": "0",
+ "etc_orgt_ntby_vol": "0",
+ "etc_orgt_seln_tr_pbmn": "0",
+ "etc_orgt_shnu_tr_pbmn": "0",
+ "etc_orgt_ntby_tr_pbmn": "0",
+ "etc_corp_seln_vol": "5061",
+ "etc_corp_shnu_vol": "3558",
+ "etc_corp_ntby_vol": "-1503",
+ "etc_corp_seln_tr_pbmn": "95856",
+ "etc_corp_shnu_tr_pbmn": "113601",
+ "etc_corp_ntby_tr_pbmn": "17745"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/134_v1_국내주식-044_종목별-프로그램매매추이체결.md b/docs/broker/kis/rest/국내주식/시세분석/134_v1_국내주식-044_종목별-프로그램매매추이체결.md
new file mode 100644
index 0000000..3edfda8
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/134_v1_국내주식-044_종목별-프로그램매매추이체결.md
@@ -0,0 +1,84 @@
+# 종목별 프로그램매매추이(체결)
+
+- 원본 시트명: 종목별 프로그램매매추이(체결)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: v1_국내주식-044
+- HTTP Method: GET
+- 실전 TR_ID: FHPPG04650101
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/program-trade-by-stock
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목별 프로그램매매추이(체결) API입니다.
+
+한국투자 HTS(eFriend Plus) > [0465] 종목별 프로그램 매매추이 화면(혹은 한국투자 MTS > 국내 현재가 > 기타수급 > 프로그램) 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)FHPPG04650100 → (신)FHPPG04650101' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | KRX : J , NXT : NX, 통합 : UN |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업 시간 | string | Y | 6 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+| prdy_vrss | 전일 대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| whol_smtn_seln_vol | 전체 합계 매도 거래량 | string | Y | 18 | |
+| whol_smtn_shnu_vol | 전체 합계 매수2 거래량 | string | Y | 18 | |
+| whol_smtn_ntby_qty | 전체 합계 순매수 수량 | string | Y | 18 | |
+| whol_smtn_seln_tr_pbmn | 전체 합계 매도 거래 대금 | string | Y | 18 | |
+| whol_smtn_shnu_tr_pbmn | 전체 합계 매수2 거래 대금 | string | Y | 18 | |
+| whol_smtn_ntby_tr_pbmn | 전체 합계 순매수 거래 대금 | string | Y | 18 | |
+| whol_ntby_vol_icdc | 전체 순매수 거래량 증감 | string | Y | 10 | |
+| whol_ntby_tr_pbmn_icdc | 전체 순매수 거래 대금 증감 | string | Y | 10 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/시세분석/135_국내주식-161_외국계-매매종목-가집계.md b/docs/broker/kis/rest/국내주식/시세분석/135_국내주식-161_외국계-매매종목-가집계.md
new file mode 100644
index 0000000..299525c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/135_국내주식-161_외국계-매매종목-가집계.md
@@ -0,0 +1,377 @@
+# 외국계 매매종목 가집계
+
+- 원본 시트명: 외국계 매매종목 가집계
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-161
+- HTTP Method: GET
+- 실전 TR_ID: FHKST644100C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/frgnmem-trade-estimate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+외국계 매매종목 가집계 API입니다.
+한국투자 HTS(eFriend Plus) > [0430] 외국계 매매종목 가집계 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST644100C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | 시장구분코드 (J) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Uniquekey (16441) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 0000(전체), 1001(코스피), 2001(코스닥) |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | 0(금액순), 1(수량순) |
+| FID_RANK_SORT_CLS_CODE_2 | 순위정렬구분코드2 | string | Y | 2 | 0(매수순), 1(매도순) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| glob_ntsl_qty | 외국계순매도수량 | string | Y | 12 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| glob_total_seln_qty | 외국계총매도수량 | string | Y | 18 | |
+| glob_total_shnu_qty | 외국계총매수2수량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:16441
+FID_INPUT_ISCD:0000
+FID_RANK_SORT_CLS_CODE:0
+FID_RANK_SORT_CLS_CODE_2:0
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "005930",
+ "hts_kor_isnm": "삼성전자",
+ "glob_ntsl_qty": "3870530",
+ "stck_prpr": "81300",
+ "prdy_vrss": "3700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.77",
+ "acml_vol": "24892595",
+ "glob_total_seln_qty": "547879",
+ "glob_total_shnu_qty": "4418409"
+ },
+ {
+ "stck_shrn_iscd": "000660",
+ "hts_kor_isnm": "SK하이닉스",
+ "glob_ntsl_qty": "964256",
+ "stck_prpr": "179600",
+ "prdy_vrss": "6400",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.70",
+ "acml_vol": "4333233",
+ "glob_total_seln_qty": "680043",
+ "glob_total_shnu_qty": "1644299"
+ },
+ {
+ "stck_shrn_iscd": "267260",
+ "hts_kor_isnm": "HD현대일렉트릭",
+ "glob_ntsl_qty": "329507",
+ "stck_prpr": "252000",
+ "prdy_vrss": "22000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "9.57",
+ "acml_vol": "955597",
+ "glob_total_seln_qty": "87986",
+ "glob_total_shnu_qty": "417493"
+ },
+ {
+ "stck_shrn_iscd": "005935",
+ "hts_kor_isnm": "삼성전자우",
+ "glob_ntsl_qty": "455400",
+ "stck_prpr": "66900",
+ "prdy_vrss": "2300",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.56",
+ "acml_vol": "1554888",
+ "glob_total_seln_qty": "211634",
+ "glob_total_shnu_qty": "667034"
+ },
+ {
+ "stck_shrn_iscd": "011070",
+ "hts_kor_isnm": "LG이노텍",
+ "glob_ntsl_qty": "79842",
+ "stck_prpr": "239500",
+ "prdy_vrss": "5000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.13",
+ "acml_vol": "283787",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "79842"
+ },
+ {
+ "stck_shrn_iscd": "012450",
+ "hts_kor_isnm": "한화에어로스페이스",
+ "glob_ntsl_qty": "56853",
+ "stck_prpr": "218500",
+ "prdy_vrss": "3000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.39",
+ "acml_vol": "334636",
+ "glob_total_seln_qty": "15218",
+ "glob_total_shnu_qty": "72071"
+ },
+ {
+ "stck_shrn_iscd": "010140",
+ "hts_kor_isnm": "삼성중공업",
+ "glob_ntsl_qty": "1230023",
+ "stck_prpr": "9600",
+ "prdy_vrss": "210",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.24",
+ "acml_vol": "7158181",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "1230023"
+ },
+ {
+ "stck_shrn_iscd": "009150",
+ "hts_kor_isnm": "삼성전기",
+ "glob_ntsl_qty": "73431",
+ "stck_prpr": "158000",
+ "prdy_vrss": "6900",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.57",
+ "acml_vol": "551401",
+ "glob_total_seln_qty": "3452",
+ "glob_total_shnu_qty": "76883"
+ },
+ {
+ "stck_shrn_iscd": "316140",
+ "hts_kor_isnm": "우리금융지주",
+ "glob_ntsl_qty": "605764",
+ "stck_prpr": "14190",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.42",
+ "acml_vol": "2313443",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "605764"
+ },
+ {
+ "stck_shrn_iscd": "010120",
+ "hts_kor_isnm": "LS ELECTRIC",
+ "glob_ntsl_qty": "47936",
+ "stck_prpr": "164800",
+ "prdy_vrss": "5000",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.13",
+ "acml_vol": "787906",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "47936"
+ },
+ {
+ "stck_shrn_iscd": "035420",
+ "hts_kor_isnm": "NAVER",
+ "glob_ntsl_qty": "35414",
+ "stck_prpr": "194800",
+ "prdy_vrss": "200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.10",
+ "acml_vol": "1270446",
+ "glob_total_seln_qty": "3814",
+ "glob_total_shnu_qty": "39228"
+ },
+ {
+ "stck_shrn_iscd": "034020",
+ "hts_kor_isnm": "두산에너빌리티",
+ "glob_ntsl_qty": "407917",
+ "stck_prpr": "17080",
+ "prdy_vrss": "530",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.20",
+ "acml_vol": "4896880",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "407917"
+ },
+ {
+ "stck_shrn_iscd": "032830",
+ "hts_kor_isnm": "삼성생명",
+ "glob_ntsl_qty": "71420",
+ "stck_prpr": "88300",
+ "prdy_vrss": "4500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "5.37",
+ "acml_vol": "428755",
+ "glob_total_seln_qty": "106254",
+ "glob_total_shnu_qty": "177674"
+ },
+ {
+ "stck_shrn_iscd": "196170",
+ "hts_kor_isnm": "알테오젠",
+ "glob_ntsl_qty": "29877",
+ "stck_prpr": "177300",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.06",
+ "acml_vol": "848702",
+ "glob_total_seln_qty": "902",
+ "glob_total_shnu_qty": "30779"
+ },
+ {
+ "stck_shrn_iscd": "031980",
+ "hts_kor_isnm": "피에스케이홀딩스",
+ "glob_ntsl_qty": "107530",
+ "stck_prpr": "50500",
+ "prdy_vrss": "3900",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "8.37",
+ "acml_vol": "625360",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "107530"
+ },
+ {
+ "stck_shrn_iscd": "036930",
+ "hts_kor_isnm": "주성엔지니어링",
+ "glob_ntsl_qty": "139898",
+ "stck_prpr": "34950",
+ "prdy_vrss": "600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.75",
+ "acml_vol": "782431",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "139898"
+ },
+ {
+ "stck_shrn_iscd": "259960",
+ "hts_kor_isnm": "크래프톤",
+ "glob_ntsl_qty": "18822",
+ "stck_prpr": "257500",
+ "prdy_vrss": "6500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.59",
+ "acml_vol": "192541",
+ "glob_total_seln_qty": "20936",
+ "glob_total_shnu_qty": "39758"
+ },
+ {
+ "stck_shrn_iscd": "024110",
+ "hts_kor_isnm": "기업은행",
+ "glob_ntsl_qty": "296747",
+ "stck_prpr": "13760",
+ "prdy_vrss": "100",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.73",
+ "acml_vol": "1259841",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "296747"
+ },
+ {
+ "stck_shrn_iscd": "047810",
+ "hts_kor_isnm": "한국항공우주",
+ "glob_ntsl_qty": "75000",
+ "stck_prpr": "53200",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "499071",
+ "glob_total_seln_qty": "0",
+ "glob_total_shnu_qty": "75000"
+ },
+ {
+ "stck_shrn_iscd": "298040",
+ "hts_kor_isnm": "효성중공업",
+ "glob_ntsl_qty": "13317",
+ "stck_prpr": "298000",
+ "prdy_vrss": "9500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.29",
+ "acml_vol": "127846",
+ "glob_total_seln_qty": "435",
+ "glob_total_shnu_qty": "13752"
+ },
+ {
+ "stck_shrn_iscd": "000720",
+ "hts_kor_isnm": "현대건설",
+ "glob_ntsl_qty": "105515",
+ "stck_prpr": "35600",
+ "prdy_vrss": "350",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.99",
+ "acml_vol": "383978",
+ "glob_total_seln_qty": "9872",
+ "glob_total_shnu_qty": "115387"
+ },
+ {
+ "stck_shrn_iscd": "084370",
+ "hts_kor_isnm": "유진테크",
+ "glob_ntsl_qty": "60338",
+ "stck_prpr": "57600",
+ "prdy_vrss": "2200",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "3.97",
+ "acml_vol": "242728",
+ "glob_total_seln_qty": "18396",
+ "glob_total_shnu_qty": "78734"
+ },
+ {
+ "stck_shrn_iscd": "064350",
+ "hts_kor_isnm": "현대로템",
+ "glob_ntsl_qty": "91584",
+ "stck_prpr": "38100",
+ "prdy_vrss": "150",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.40",
+ "acml_vol": "1032621",
+ "glob_total_seln_qty": "2256",
+ "glob_total_shnu_qty": "93840"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/136_국내주식-140_국내주식-시간외예상체결등락률.md b/docs/broker/kis/rest/국내주식/시세분석/136_국내주식-140_국내주식-시간외예상체결등락률.md
new file mode 100644
index 0000000..bb70876
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/136_국내주식-140_국내주식-시간외예상체결등락률.md
@@ -0,0 +1,560 @@
+# 국내주식 시간외예상체결등락률
+
+- 원본 시트명: 국내주식 시간외예상체결등락률
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-140
+- HTTP Method: GET
+- 실전 TR_ID: FHKST11860000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ranking/overtime-exp-trans-fluct
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외예상체결등락률 API입니다.
+한국투자 HTS(eFriend Plus) > [0236] 시간외 예상체결등락률 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST11860000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (J: 주식) |
+| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11186) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000(전체), 0001(코스피), 1001(코스닥) |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | 0(상승률), 1(상승폭), 2(보합), 3(하락률), 4(하락폭) |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | '0(전체), 1(관리종목), 2(투자주의), 3(투자경고),
4(투자위험예고), 5(투자위험), 6(보통주), 7(우선주)' |
+| FID_INPUT_PRICE_1 | 입력 가격1 | string | Y | 12 | 가격 ~ |
+| FID_INPUT_PRICE_2 | 입력 가격2 | string | Y | 12 | 공백 |
+| FID_INPUT_VOL_1 | 입력 거래량 | string | Y | 18 | 거래량 ~ |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| data_rank | 데이터 순위 | string | Y | 10 | |
+| iscd_stat_cls_code | 종목 상태 구분 코드 | string | Y | 3 | |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | Y | 10 | |
+| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | Y | 10 | |
+| ovtm_untp_antc_cntg_vrsssign | 시간외 단일가 예상 체결 대비 | string | Y | 1 | |
+| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | Y | 82 | |
+| ovtm_untp_askp_rsqn1 | 시간외 단일가 매도호가 잔량1 | string | Y | 12 | |
+| ovtm_untp_bidp_rsqn1 | 시간외 단일가 매수호가 잔량1 | string | Y | 12 | |
+| ovtm_untp_antc_cnqn | 시간외 단일가 예상 체결량 | string | Y | 18 | |
+| itmt_vol | 장중 거래량 | string | Y | 18 | |
+| stck_prpr | 주식 현재가 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:11186
+FID_INPUT_ISCD:0000
+FID_RANK_SORT_CLS_CODE:0
+FID_DIV_CLS_CODE:0
+FID_INPUT_PRICE_1:
+FID_INPUT_PRICE_2:
+FID_INPUT_VOL_1:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "data_rank": "1",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "025820",
+ "hts_kor_isnm": "이구산업",
+ "ovtm_untp_antc_cnpr": "6270",
+ "ovtm_untp_antc_cntg_vrss": "570",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "10.00",
+ "ovtm_untp_askp_rsqn1": "231200",
+ "ovtm_untp_bidp_rsqn1": "394",
+ "ovtm_untp_antc_cnqn": "253267",
+ "itmt_vol": "14355442",
+ "stck_prpr": "5700"
+ },
+ {
+ "data_rank": "2",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "024840",
+ "hts_kor_isnm": "KBI메탈",
+ "ovtm_untp_antc_cnpr": "1805",
+ "ovtm_untp_antc_cntg_vrss": "164",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.99",
+ "ovtm_untp_askp_rsqn1": "0",
+ "ovtm_untp_bidp_rsqn1": "1512765",
+ "ovtm_untp_antc_cnqn": "25869",
+ "itmt_vol": "13518874",
+ "stck_prpr": "1641"
+ },
+ {
+ "data_rank": "3",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "097800",
+ "hts_kor_isnm": "윈팩",
+ "ovtm_untp_antc_cnpr": "1334",
+ "ovtm_untp_antc_cntg_vrss": "121",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.98",
+ "ovtm_untp_askp_rsqn1": "150248",
+ "ovtm_untp_bidp_rsqn1": "300",
+ "ovtm_untp_antc_cnqn": "40546",
+ "itmt_vol": "1020359",
+ "stck_prpr": "1213"
+ },
+ {
+ "data_rank": "4",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "060280",
+ "hts_kor_isnm": "큐렉소",
+ "ovtm_untp_antc_cnpr": "13460",
+ "ovtm_untp_antc_cntg_vrss": "1220",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.97",
+ "ovtm_untp_askp_rsqn1": "0",
+ "ovtm_untp_bidp_rsqn1": "5409",
+ "ovtm_untp_antc_cnqn": "4769",
+ "itmt_vol": "233482",
+ "stck_prpr": "12240"
+ },
+ {
+ "data_rank": "5",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "206650",
+ "hts_kor_isnm": "유바이오로직스",
+ "ovtm_untp_antc_cnpr": "13270",
+ "ovtm_untp_antc_cntg_vrss": "1200",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.94",
+ "ovtm_untp_askp_rsqn1": "23618",
+ "ovtm_untp_bidp_rsqn1": "8",
+ "ovtm_untp_antc_cnqn": "20021",
+ "itmt_vol": "182132",
+ "stck_prpr": "12070"
+ },
+ {
+ "data_rank": "6",
+ "iscd_stat_cls_code": "51",
+ "stck_shrn_iscd": "008110",
+ "hts_kor_isnm": "대동전자",
+ "ovtm_untp_antc_cnpr": "7680",
+ "ovtm_untp_antc_cntg_vrss": "690",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.87",
+ "ovtm_untp_askp_rsqn1": "0",
+ "ovtm_untp_bidp_rsqn1": "16106",
+ "ovtm_untp_antc_cnqn": "238",
+ "itmt_vol": "3577",
+ "stck_prpr": "6990"
+ },
+ {
+ "data_rank": "7",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "058450",
+ "hts_kor_isnm": "엔터파트너즈",
+ "ovtm_untp_antc_cnpr": "5910",
+ "ovtm_untp_antc_cntg_vrss": "510",
+ "ovtm_untp_antc_cntg_vrss_sign": "1",
+ "ovtm_untp_antc_cntg_ctrt": "9.44",
+ "ovtm_untp_askp_rsqn1": "607",
+ "ovtm_untp_bidp_rsqn1": "10000",
+ "ovtm_untp_antc_cnqn": "20026",
+ "itmt_vol": "3168350",
+ "stck_prpr": "5400"
+ },
+ {
+ "data_rank": "8",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "336060",
+ "hts_kor_isnm": "웨이버스",
+ "ovtm_untp_antc_cnpr": "1589",
+ "ovtm_untp_antc_cntg_vrss": "129",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "8.84",
+ "ovtm_untp_askp_rsqn1": "3539",
+ "ovtm_untp_bidp_rsqn1": "2739",
+ "ovtm_untp_antc_cnqn": "3970",
+ "itmt_vol": "195703",
+ "stck_prpr": "1460"
+ },
+ {
+ "data_rank": "9",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "047560",
+ "hts_kor_isnm": "이스트소프트",
+ "ovtm_untp_antc_cnpr": "26900",
+ "ovtm_untp_antc_cntg_vrss": "2000",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "8.03",
+ "ovtm_untp_askp_rsqn1": "826",
+ "ovtm_untp_bidp_rsqn1": "30",
+ "ovtm_untp_antc_cnqn": "9827",
+ "itmt_vol": "399313",
+ "stck_prpr": "24900"
+ },
+ {
+ "data_rank": "10",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "018470",
+ "hts_kor_isnm": "조일알미늄",
+ "ovtm_untp_antc_cnpr": "2380",
+ "ovtm_untp_antc_cntg_vrss": "155",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "6.97",
+ "ovtm_untp_askp_rsqn1": "33239",
+ "ovtm_untp_bidp_rsqn1": "8263",
+ "ovtm_untp_antc_cnqn": "133388",
+ "itmt_vol": "8895974",
+ "stck_prpr": "2225"
+ },
+ {
+ "data_rank": "11",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "012800",
+ "hts_kor_isnm": "대창",
+ "ovtm_untp_antc_cnpr": "1630",
+ "ovtm_untp_antc_cntg_vrss": "87",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "5.64",
+ "ovtm_untp_askp_rsqn1": "3999",
+ "ovtm_untp_bidp_rsqn1": "5309",
+ "ovtm_untp_antc_cnqn": "109013",
+ "itmt_vol": "9386217",
+ "stck_prpr": "1543"
+ },
+ {
+ "data_rank": "12",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "279600",
+ "hts_kor_isnm": "미디어젠",
+ "ovtm_untp_antc_cnpr": "14300",
+ "ovtm_untp_antc_cntg_vrss": "660",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "4.84",
+ "ovtm_untp_askp_rsqn1": "1957",
+ "ovtm_untp_bidp_rsqn1": "50",
+ "ovtm_untp_antc_cnqn": "7",
+ "itmt_vol": "8603",
+ "stck_prpr": "13640"
+ },
+ {
+ "data_rank": "13",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "102120",
+ "hts_kor_isnm": "어보브반도체",
+ "ovtm_untp_antc_cnpr": "17220",
+ "ovtm_untp_antc_cntg_vrss": "770",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "4.68",
+ "ovtm_untp_askp_rsqn1": "126",
+ "ovtm_untp_bidp_rsqn1": "38",
+ "ovtm_untp_antc_cnqn": "7594",
+ "itmt_vol": "1243555",
+ "stck_prpr": "16450"
+ },
+ {
+ "data_rank": "14",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "217330",
+ "hts_kor_isnm": "싸이토젠",
+ "ovtm_untp_antc_cnpr": "13670",
+ "ovtm_untp_antc_cntg_vrss": "570",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "4.35",
+ "ovtm_untp_askp_rsqn1": "86",
+ "ovtm_untp_bidp_rsqn1": "86",
+ "ovtm_untp_antc_cnqn": "114",
+ "itmt_vol": "41089",
+ "stck_prpr": "13100"
+ },
+ {
+ "data_rank": "15",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "204270",
+ "hts_kor_isnm": "제이앤티씨",
+ "ovtm_untp_antc_cnpr": "20300",
+ "ovtm_untp_antc_cntg_vrss": "840",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "4.32",
+ "ovtm_untp_askp_rsqn1": "31630",
+ "ovtm_untp_bidp_rsqn1": "68",
+ "ovtm_untp_antc_cnqn": "17659",
+ "itmt_vol": "6038040",
+ "stck_prpr": "19460"
+ },
+ {
+ "data_rank": "16",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "049630",
+ "hts_kor_isnm": "재영솔루텍",
+ "ovtm_untp_antc_cnpr": "717",
+ "ovtm_untp_antc_cntg_vrss": "27",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "3.91",
+ "ovtm_untp_askp_rsqn1": "5419",
+ "ovtm_untp_bidp_rsqn1": "1018",
+ "ovtm_untp_antc_cnqn": "581",
+ "itmt_vol": "356136",
+ "stck_prpr": "690"
+ },
+ {
+ "data_rank": "17",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "011300",
+ "hts_kor_isnm": "성안",
+ "ovtm_untp_antc_cnpr": "1295",
+ "ovtm_untp_antc_cntg_vrss": "39",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "3.11",
+ "ovtm_untp_askp_rsqn1": "974",
+ "ovtm_untp_bidp_rsqn1": "1126",
+ "ovtm_untp_antc_cnqn": "30",
+ "itmt_vol": "469466",
+ "stck_prpr": "1256"
+ },
+ {
+ "data_rank": "18",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "164060",
+ "hts_kor_isnm": "이루다",
+ "ovtm_untp_antc_cnpr": "6390",
+ "ovtm_untp_antc_cntg_vrss": "190",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "3.06",
+ "ovtm_untp_askp_rsqn1": "223",
+ "ovtm_untp_bidp_rsqn1": "812",
+ "ovtm_untp_antc_cnqn": "146",
+ "itmt_vol": "86988",
+ "stck_prpr": "6200"
+ },
+ {
+ "data_rank": "19",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "008500",
+ "hts_kor_isnm": "일정실업",
+ "ovtm_untp_antc_cnpr": "16300",
+ "ovtm_untp_antc_cntg_vrss": "460",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.90",
+ "ovtm_untp_askp_rsqn1": "11",
+ "ovtm_untp_bidp_rsqn1": "825",
+ "ovtm_untp_antc_cnqn": "352",
+ "itmt_vol": "450888",
+ "stck_prpr": "15840"
+ },
+ {
+ "data_rank": "20",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "226330",
+ "hts_kor_isnm": "신테카바이오",
+ "ovtm_untp_antc_cnpr": "11350",
+ "ovtm_untp_antc_cntg_vrss": "310",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.81",
+ "ovtm_untp_askp_rsqn1": "116",
+ "ovtm_untp_bidp_rsqn1": "100",
+ "ovtm_untp_antc_cnqn": "1568",
+ "itmt_vol": "150421",
+ "stck_prpr": "11040"
+ },
+ {
+ "data_rank": "21",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "313760",
+ "hts_kor_isnm": "윌링스",
+ "ovtm_untp_antc_cnpr": "6980",
+ "ovtm_untp_antc_cntg_vrss": "180",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.65",
+ "ovtm_untp_askp_rsqn1": "40",
+ "ovtm_untp_bidp_rsqn1": "65",
+ "ovtm_untp_antc_cnqn": "8",
+ "itmt_vol": "436483",
+ "stck_prpr": "6800"
+ },
+ {
+ "data_rank": "22",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "196300",
+ "hts_kor_isnm": "애니젠",
+ "ovtm_untp_antc_cnpr": "15500",
+ "ovtm_untp_antc_cntg_vrss": "370",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.45",
+ "ovtm_untp_askp_rsqn1": "21",
+ "ovtm_untp_bidp_rsqn1": "20",
+ "ovtm_untp_antc_cnqn": "35",
+ "itmt_vol": "66884",
+ "stck_prpr": "15130"
+ },
+ {
+ "data_rank": "23",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "003160",
+ "hts_kor_isnm": "디아이",
+ "ovtm_untp_antc_cnpr": "19400",
+ "ovtm_untp_antc_cntg_vrss": "460",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.43",
+ "ovtm_untp_askp_rsqn1": "129",
+ "ovtm_untp_bidp_rsqn1": "36",
+ "ovtm_untp_antc_cnqn": "10214",
+ "itmt_vol": "12266019",
+ "stck_prpr": "18940"
+ },
+ {
+ "data_rank": "24",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "014910",
+ "hts_kor_isnm": "성문전자",
+ "ovtm_untp_antc_cnpr": "1485",
+ "ovtm_untp_antc_cntg_vrss": "33",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.27",
+ "ovtm_untp_askp_rsqn1": "200",
+ "ovtm_untp_bidp_rsqn1": "33",
+ "ovtm_untp_antc_cnqn": "1",
+ "itmt_vol": "58133",
+ "stck_prpr": "1452"
+ },
+ {
+ "data_rank": "25",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "291650",
+ "hts_kor_isnm": "압타머사이언스",
+ "ovtm_untp_antc_cnpr": "2655",
+ "ovtm_untp_antc_cntg_vrss": "55",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.12",
+ "ovtm_untp_askp_rsqn1": "99",
+ "ovtm_untp_bidp_rsqn1": "1",
+ "ovtm_untp_antc_cnqn": "1",
+ "itmt_vol": "184868",
+ "stck_prpr": "2600"
+ },
+ {
+ "data_rank": "26",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "017510",
+ "hts_kor_isnm": "세명전기",
+ "ovtm_untp_antc_cnpr": "3790",
+ "ovtm_untp_antc_cntg_vrss": "75",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.02",
+ "ovtm_untp_askp_rsqn1": "3652",
+ "ovtm_untp_bidp_rsqn1": "20",
+ "ovtm_untp_antc_cnqn": "7126",
+ "itmt_vol": "15284327",
+ "stck_prpr": "3715"
+ },
+ {
+ "data_rank": "27",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "072770",
+ "hts_kor_isnm": "율호",
+ "ovtm_untp_antc_cnpr": "2530",
+ "ovtm_untp_antc_cntg_vrss": "50",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "2.02",
+ "ovtm_untp_askp_rsqn1": "135",
+ "ovtm_untp_bidp_rsqn1": "14",
+ "ovtm_untp_antc_cnqn": "800",
+ "itmt_vol": "538402",
+ "stck_prpr": "2480"
+ },
+ {
+ "data_rank": "28",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "001780",
+ "hts_kor_isnm": "알루코",
+ "ovtm_untp_antc_cnpr": "3345",
+ "ovtm_untp_antc_cntg_vrss": "65",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "1.98",
+ "ovtm_untp_askp_rsqn1": "15679",
+ "ovtm_untp_bidp_rsqn1": "567",
+ "ovtm_untp_antc_cnqn": "3419",
+ "itmt_vol": "1403435",
+ "stck_prpr": "3280"
+ },
+ {
+ "data_rank": "29",
+ "iscd_stat_cls_code": "55",
+ "stck_shrn_iscd": "017370",
+ "hts_kor_isnm": "우신시스템",
+ "ovtm_untp_antc_cnpr": "8300",
+ "ovtm_untp_antc_cntg_vrss": "160",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "1.97",
+ "ovtm_untp_askp_rsqn1": "160",
+ "ovtm_untp_bidp_rsqn1": "6",
+ "ovtm_untp_antc_cnqn": "34",
+ "itmt_vol": "59584",
+ "stck_prpr": "8140"
+ },
+ {
+ "data_rank": "30",
+ "iscd_stat_cls_code": "57",
+ "stck_shrn_iscd": "203400",
+ "hts_kor_isnm": "에이비온",
+ "ovtm_untp_antc_cnpr": "5980",
+ "ovtm_untp_antc_cntg_vrss": "110",
+ "ovtm_untp_antc_cntg_vrss_sign": "2",
+ "ovtm_untp_antc_cntg_ctrt": "1.87",
+ "ovtm_untp_askp_rsqn1": "289",
+ "ovtm_untp_bidp_rsqn1": "230",
+ "ovtm_untp_antc_cnqn": "1",
+ "itmt_vol": "128021",
+ "stck_prpr": "5870"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/137_국내주식-164_종목별-외국계-순매수추이.md b/docs/broker/kis/rest/국내주식/시세분석/137_국내주식-164_종목별-외국계-순매수추이.md
new file mode 100644
index 0000000..96a016e
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/137_국내주식-164_종목별-외국계-순매수추이.md
@@ -0,0 +1,216 @@
+# 종목별 외국계 순매수추이
+
+- 원본 시트명: 종목별 외국계 순매수추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-164
+- HTTP Method: GET
+- 실전 TR_ID: FHKST644400C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/frgnmem-pchs-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+종목별 외국계 순매수추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0433] 종목별 외국계 순매수추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST644400C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_ISCD | 조건시장분류코드 | string | Y | 12 | 종목코드(ex) 005930(삼성전자)) |
+| FID_INPUT_ISCD_2 | 조건화면분류코드 | string | Y | 8 | 외국계 전체(99999) |
+| FID_COND_MRKT_DIV_CODE | 시장구분코드 | string | Y | 10 | J (KRX만 지원) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업시간 | string | Y | 6 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| frgn_seln_vol | 외국인매도거래량 | string | Y | 18 | |
+| frgn_shnu_vol | 외국인매수2거래량 | string | Y | 18 | |
+| glob_ntby_qty | 외국계순매수수량 | string | Y | 12 | |
+| frgn_ntby_qty_icdc | 외국인순매수수량증감 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_INPUT_ISCD:005930
+FID_INPUT_ISCD_2:99999
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_hour": "153106",
+ "stck_prpr": "81300",
+ "prdy_vrss": "3700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.77",
+ "acml_vol": "24771461",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4418409",
+ "glob_ntby_qty": "3870530",
+ "frgn_ntby_qty_icdc": "194396"
+ },
+ {
+ "bsop_hour": "151952",
+ "stck_prpr": "81200",
+ "prdy_vrss": "3600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.64",
+ "acml_vol": "23517309",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4224013",
+ "glob_ntby_qty": "3676134",
+ "frgn_ntby_qty_icdc": "3123"
+ },
+ {
+ "bsop_hour": "151836",
+ "stck_prpr": "81100",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.51",
+ "acml_vol": "23404992",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4220890",
+ "glob_ntby_qty": "3673011",
+ "frgn_ntby_qty_icdc": "1700"
+ },
+ {
+ "bsop_hour": "151724",
+ "stck_prpr": "81100",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.51",
+ "acml_vol": "23374199",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4219190",
+ "glob_ntby_qty": "3671311",
+ "frgn_ntby_qty_icdc": "1261"
+ },
+ {
+ "bsop_hour": "151613",
+ "stck_prpr": "81100",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.51",
+ "acml_vol": "23327774",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4217929",
+ "glob_ntby_qty": "3670050",
+ "frgn_ntby_qty_icdc": "5152"
+ },
+ {
+ "bsop_hour": "151503",
+ "stck_prpr": "81100",
+ "prdy_vrss": "3500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.51",
+ "acml_vol": "23255295",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4212777",
+ "glob_ntby_qty": "3664898",
+ "frgn_ntby_qty_icdc": "181"
+ },
+ {
+ "bsop_hour": "151355",
+ "stck_prpr": "81200",
+ "prdy_vrss": "3600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.64",
+ "acml_vol": "23222914",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4212596",
+ "glob_ntby_qty": "3664717",
+ "frgn_ntby_qty_icdc": "87"
+ },
+ {
+ "bsop_hour": "151245",
+ "stck_prpr": "81200",
+ "prdy_vrss": "3600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.64",
+ "acml_vol": "23207485",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4212509",
+ "glob_ntby_qty": "3664630",
+ "frgn_ntby_qty_icdc": "588"
+ },
+ {
+ "bsop_hour": "151136",
+ "stck_prpr": "81300",
+ "prdy_vrss": "3700",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.77",
+ "acml_vol": "23126698",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4211921",
+ "glob_ntby_qty": "3664042",
+ "frgn_ntby_qty_icdc": "4468"
+ },
+ {
+ "bsop_hour": "151022",
+ "stck_prpr": "81200",
+ "prdy_vrss": "3600",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "4.64",
+ "acml_vol": "23058530",
+ "frgn_seln_vol": "547879",
+ "frgn_shnu_vol": "4207453",
+ "glob_ntby_qty": "3659574",
+ "frgn_ntby_qty_icdc": "143"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/시세분석/138_국내주식-205_관심종목멀티종목-시세조회.md b/docs/broker/kis/rest/국내주식/시세분석/138_국내주식-205_관심종목멀티종목-시세조회.md
new file mode 100644
index 0000000..6c2c1fd
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/시세분석/138_국내주식-205_관심종목멀티종목-시세조회.md
@@ -0,0 +1,269 @@
+# 관심종목(멀티종목) 시세조회
+
+- 원본 시트명: 관심종목(멀티종목) 시세조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-205
+- HTTP Method: GET
+- 실전 TR_ID: FHKST11300006
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/intstock-multprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+관심종목(멀티종목) 시세조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0161] 관심종목 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST11300006 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE_1 | 조건 시장 분류 코드1 | string | Y | 2 | 그룹별종목조회 결과 fid_mrkt_cls_code(시장구분) 1 입력
J: KRX, NX: NXT, UN: 통합
ex) J |
+| FID_INPUT_ISCD_1 | 입력 종목코드1 | string | Y | 16 | 그룹별종목조회 결과 jong_code(종목코드) 1 입력
ex) 005930 |
+| FID_COND_MRKT_DIV_CODE_2 | 조건 시장 분류 코드2 | string | Y | 2 | |
+| FID_INPUT_ISCD_2 | 입력 종목코드2 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_3 | 조건 시장 분류 코드3 | string | Y | 2 | |
+| FID_INPUT_ISCD_3 | 입력 종목코드3 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_4 | 조건 시장 분류 코드4 | string | Y | 2 | |
+| FID_INPUT_ISCD_4 | 입력 종목코드4 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_5 | 조건 시장 분류 코드5 | string | Y | 2 | |
+| FID_INPUT_ISCD_5 | 입력 종목코드5 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_6 | 조건 시장 분류 코드6 | string | Y | 2 | |
+| FID_INPUT_ISCD_6 | 입력 종목코드6 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_7 | 조건 시장 분류 코드7 | string | Y | 2 | |
+| FID_INPUT_ISCD_7 | 입력 종목코드7 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_8 | 조건 시장 분류 코드8 | string | Y | 2 | |
+| FID_INPUT_ISCD_8 | 입력 종목코드8 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_9 | 조건 시장 분류 코드9 | string | Y | 2 | |
+| FID_INPUT_ISCD_9 | 입력 종목코드9 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_10 | 조건 시장 분류 코드10 | string | Y | 12 | |
+| FID_INPUT_ISCD_10 | 입력 종목코드10 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_11 | 조건 시장 분류 코드11 | string | Y | 2 | |
+| FID_INPUT_ISCD_11 | 입력 종목코드11 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_12 | 조건 시장 분류 코드12 | string | Y | 2 | |
+| FID_INPUT_ISCD_12 | 입력 종목코드12 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_13 | 조건 시장 분류 코드13 | string | Y | 2 | |
+| FID_INPUT_ISCD_13 | 입력 종목코드13 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_14 | 조건 시장 분류 코드14 | string | Y | 2 | |
+| FID_INPUT_ISCD_14 | 입력 종목코드14 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_15 | 조건 시장 분류 코드15 | string | Y | 2 | |
+| FID_INPUT_ISCD_15 | 입력 종목코드15 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_16 | 조건 시장 분류 코드16 | string | Y | 2 | |
+| FID_INPUT_ISCD_16 | 입력 종목코드16 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_17 | 조건 시장 분류 코드17 | string | Y | 2 | |
+| FID_INPUT_ISCD_17 | 입력 종목코드17 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_18 | 조건 시장 분류 코드18 | string | Y | 2 | |
+| FID_INPUT_ISCD_18 | 입력 종목코드18 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_19 | 조건 시장 분류 코드19 | string | Y | 2 | |
+| FID_INPUT_ISCD_19 | 입력 종목코드19 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_20 | 조건 시장 분류 코드20 | string | Y | 2 | |
+| FID_INPUT_ISCD_20 | 입력 종목코드20 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_21 | 조건 시장 분류 코드21 | string | Y | 2 | |
+| FID_INPUT_ISCD_21 | 입력 종목코드21 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_22 | 조건 시장 분류 코드22 | string | Y | 2 | |
+| FID_INPUT_ISCD_22 | 입력 종목코드22 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_23 | 조건 시장 분류 코드23 | string | Y | 2 | |
+| FID_INPUT_ISCD_23 | 입력 종목코드23 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_24 | 조건 시장 분류 코드24 | string | Y | 2 | |
+| FID_INPUT_ISCD_24 | 입력 종목코드24 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_25 | 조건 시장 분류 코드25 | string | Y | 2 | |
+| FID_INPUT_ISCD_25 | 입력 종목코드25 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_26 | 조건 시장 분류 코드26 | string | Y | 16 | |
+| FID_INPUT_ISCD_26 | 입력 종목코드26 | string | Y | 2 | |
+| FID_COND_MRKT_DIV_CODE_27 | 조건 시장 분류 코드27 | string | Y | 2 | |
+| FID_INPUT_ISCD_27 | 입력 종목코드27 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_28 | 조건 시장 분류 코드28 | string | Y | 2 | |
+| FID_INPUT_ISCD_28 | 입력 종목코드28 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_29 | 조건 시장 분류 코드29 | string | Y | 2 | |
+| FID_INPUT_ISCD_29 | 입력 종목코드29 | string | Y | 16 | |
+| FID_COND_MRKT_DIV_CODE_30 | 조건 시장 분류 코드30 | string | Y | 2 | |
+| FID_INPUT_ISCD_30 | 입력 종목코드30 | string | Y | 16 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| kospi_kosdaq_cls_name | 코스피 코스닥 구분 명 | string | Y | 10 | |
+| mrkt_trtm_cls_name | 시장 조치 구분 명 | string | Y | 10 | |
+| hour_cls_code | 시간 구분 코드 | string | Y | 1 | |
+| inter_shrn_iscd | 관심 단축 종목코드 | string | Y | 16 | |
+| inter_kor_isnm | 관심 한글 종목명 | string | Y | 40 | |
+| inter2_prpr | 관심2 현재가 | string | Y | 11 | |
+| inter2_prdy_vrss | 관심2 전일 대비 | string | Y | 11 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| inter2_oprc | 관심2 시가 | string | Y | 11 | |
+| inter2_hgpr | 관심2 고가 | string | Y | 11 | |
+| inter2_lwpr | 관심2 저가 | string | Y | 11 | |
+| inter2_llam | 관심2 하한가 | string | Y | 11 | |
+| inter2_mxpr | 관심2 상한가 | string | Y | 11 | |
+| inter2_askp | 관심2 매도호가 | string | Y | 11 | |
+| inter2_bidp | 관심2 매수호가 | string | Y | 11 | |
+| seln_rsqn | 매도 잔량 | string | Y | 12 | |
+| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| inter2_prdy_clpr | 관심2 전일 종가 | string | Y | 11 | |
+| oprc_vrss_hgpr_rate | 시가 대비 최고가 비율 | string | Y | 84 | |
+| intr_antc_cntg_vrss | 관심 예상 체결 대비 | string | Y | 11 | |
+| intr_antc_cntg_vrss_sign | 관심 예상 체결 대비 부호 | string | Y | 1 | |
+| intr_antc_cntg_prdy_ctrt | 관심 예상 체결 전일 대비율 | string | Y | 72 | |
+| intr_antc_vol | 관심 예상 거래량 | string | Y | 18 | |
+| inter2_sdpr | 관심2 기준가 | string | Y | 11 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE_1:J
+FID_INPUT_ISCD_1:005930
+FID_COND_MRKT_DIV_CODE_2:J
+FID_INPUT_ISCD_2:000660
+FID_COND_MRKT_DIV_CODE_3:U
+FID_INPUT_ISCD_3:0001
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "kospi_kosdaq_cls_name": "거래소",
+ "mrkt_trtm_cls_name": "거래소",
+ "hour_cls_code": "0",
+ "inter_shrn_iscd": "005930",
+ "inter_kor_isnm": "삼성전자",
+ "inter2_prpr": "77400",
+ "inter2_prdy_vrss": "-800",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.02",
+ "acml_vol": "15713440",
+ "inter2_oprc": "78600",
+ "inter2_hgpr": "78800",
+ "inter2_lwpr": "77200",
+ "inter2_llam": "54800",
+ "inter2_mxpr": "101600",
+ "inter2_askp": "77400",
+ "inter2_bidp": "77300",
+ "seln_rsqn": "10248",
+ "shnu_rsqn": "269626",
+ "total_askp_rsqn": "1404667",
+ "total_bidp_rsqn": "2150657",
+ "acml_tr_pbmn": "1221686345500",
+ "inter2_prdy_clpr": "78200",
+ "oprc_vrss_hgpr_rate": "0.25",
+ "intr_antc_cntg_vrss": "0",
+ "intr_antc_cntg_vrss_sign": "3",
+ "intr_antc_cntg_prdy_ctrt": "0.00",
+ "intr_antc_vol": "0",
+ "inter2_sdpr": "78200"
+ },
+ {
+ "kospi_kosdaq_cls_name": "거래소",
+ "mrkt_trtm_cls_name": "거래소",
+ "hour_cls_code": "0",
+ "inter_shrn_iscd": "000660",
+ "inter_kor_isnm": "SK하이닉스",
+ "inter2_prpr": "189900",
+ "inter2_prdy_vrss": "-3100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.61",
+ "acml_vol": "2758944",
+ "inter2_oprc": "192000",
+ "inter2_hgpr": "193500",
+ "inter2_lwpr": "189900",
+ "inter2_llam": "135100",
+ "inter2_mxpr": "250500",
+ "inter2_askp": "190000",
+ "inter2_bidp": "189900",
+ "seln_rsqn": "5625",
+ "shnu_rsqn": "4782",
+ "total_askp_rsqn": "27318",
+ "total_bidp_rsqn": "33313",
+ "acml_tr_pbmn": "528227479600",
+ "inter2_prdy_clpr": "193000",
+ "oprc_vrss_hgpr_rate": "0.78",
+ "intr_antc_cntg_vrss": "0",
+ "intr_antc_cntg_vrss_sign": "3",
+ "intr_antc_cntg_prdy_ctrt": "0.00",
+ "intr_antc_vol": "0",
+ "inter2_sdpr": "193000"
+ },
+ {
+ "kospi_kosdaq_cls_name": "업종",
+ "mrkt_trtm_cls_name": "",
+ "hour_cls_code": "2",
+ "inter_shrn_iscd": "0001",
+ "inter_kor_isnm": "종합",
+ "inter2_prpr": "2724.62",
+ "inter2_prdy_vrss": "-28.38",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.03",
+ "acml_vol": "561107",
+ "inter2_oprc": "2751.47",
+ "inter2_hgpr": "2752.17",
+ "inter2_lwpr": "2724.62",
+ "inter2_llam": "",
+ "inter2_mxpr": "",
+ "inter2_askp": "",
+ "inter2_bidp": "",
+ "seln_rsqn": "",
+ "shnu_rsqn": "",
+ "total_askp_rsqn": "19237981",
+ "total_bidp_rsqn": "49315150",
+ "acml_tr_pbmn": "10288958",
+ "inter2_prdy_clpr": "2753.00",
+ "oprc_vrss_hgpr_rate": "",
+ "intr_antc_cntg_vrss": "-28.18",
+ "intr_antc_cntg_vrss_sign": "5",
+ "intr_antc_cntg_prdy_ctrt": "-1.02",
+ "intr_antc_vol": "560841",
+ "inter2_sdpr": "2753.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/실시간시세/162_국내주식-장운영정보-통합_국내주식-장운영정보-통합.md b/docs/broker/kis/rest/국내주식/실시간시세/162_국내주식-장운영정보-통합_국내주식-장운영정보-통합.md
new file mode 100644
index 0000000..d952eb0
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/실시간시세/162_국내주식-장운영정보-통합_국내주식-장운영정보-통합.md
@@ -0,0 +1,60 @@
+# 국내주식 장운영정보 (통합)
+
+- 원본 시트명: 국내주식 장운영정보 (통합)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 장운영정보 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNMKO0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNMKO0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | N | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | N | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0UNMKO0 : 국내주식 장운영정보 (통합) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| TRHT_YN | 거래정지 여부 | string | Y | 1 | |
+| TR_SUSP_REAS_CNTT | 거래 정지 사유 내용 | string | Y | 100 | |
+| MKOP_CLS_CODE | 장운영 구분 코드 | string | Y | 3 | |
+| ANTC_MKOP_CLS_CODE | 예상 장운영 구분 코드 | string | Y | 3 | |
+| MRKT_TRTM_CLS_CODE | 임의연장구분코드 | string | Y | 1 | |
+| DIVI_APP_CLS_CODE | 동시호가배분처리구분코드 | string | Y | 2 | |
+| ISCD_STAT_CLS_CODE | 종목상태구분코드 | string | Y | 2 | |
+| VI_CLS_CODE | VI적용구분코드 | string | Y | 1 | |
+| OVTM_VI_CLS_CODE | 시간외단일가VI적용구분코드 | string | Y | 1 | |
+| EXCH_CLS_CODE | 거래소 구분코드 | string | Y | 1 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/실시간시세/187_국내주식-장운영정보-NXT_국내주식-장운영정보-NXT.md b/docs/broker/kis/rest/국내주식/실시간시세/187_국내주식-장운영정보-NXT_국내주식-장운영정보-NXT.md
new file mode 100644
index 0000000..362f2d7
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/실시간시세/187_국내주식-장운영정보-NXT_국내주식-장운영정보-NXT.md
@@ -0,0 +1,61 @@
+# 국내주식 장운영정보 (NXT)
+
+- 원본 시트명: 국내주식 장운영정보 (NXT)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 장운영정보 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXMKO0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXMKO0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | Y | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | Y | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXMKO0 : 국내주식 장운영정보 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 종목코드 | string | Y | 9 | |
+| TRHT_YN | 거래정지 여부 | string | Y | 1 | |
+| TR_SUSP_REAS_CNTT | 거래 정지 사유 내용 | string | Y | 100 | |
+| MKOP_CLS_CODE | 장운영 구분 코드 | string | Y | 3 | |
+| ANTC_MKOP_CLS_CODE | 예상 장운영 구분 코드 | string | Y | 3 | |
+| MRKT_TRTM_CLS_CODE | 임의연장구분코드 | string | Y | 1 | |
+| DIVI_APP_CLS_CODE | 동시호가배분처리구분코드 | string | Y | 2 | |
+| ISCD_STAT_CLS_CODE | 종목상태구분코드 | string | Y | 2 | |
+| VI_CLS_CODE | VI적용구분코드 | string | Y | 1 | |
+| OVTM_VI_CLS_CODE | 시간외단일가VI적용구분코드 | string | Y | 1 | |
+| EXCH_CLS_CODE | 거래소 구분코드 | string | Y | 1 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/070_국내주식-121_국내주식-예상체결지수-추이.md b/docs/broker/kis/rest/국내주식/업종/기타/070_국내주식-121_국내주식-예상체결지수-추이.md
new file mode 100644
index 0000000..41c8865
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/070_국내주식-121_국내주식-예상체결지수-추이.md
@@ -0,0 +1,366 @@
+# 국내주식 예상체결지수 추이
+
+- 원본 시트명: 국내주식 예상체결지수 추이
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-121
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01840000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/exp-index-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예상체결지수 추이 API입니다.
+한국투자 HTS(eFriend Plus) > [0184] 예상체결지수 추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01840000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_MKOP_CLS_CODE | 장운영 구분 코드 | string | Y | 2 | 1: 장시작전, 2: 장마감 |
+| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 10(10초), 30(30초), 60(1분), 600(10분) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:코스피, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 U) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식 단축 종목코드 | string | Y | 6 | |
+| bstp_nmix_prpr | HTS 한글 종목명 | string | Y | 112 | |
+| prdy_vrss_sign | 주식 현재가 | string | Y | 1 | |
+| bstp_nmix_prdy_vrss | 전일 대비 | string | Y | 112 | |
+| prdy_ctrt | 전일 대비 부호 | string | Y | 82 | |
+| acml_vol | 전일 대비율 | string | Y | 18 | |
+| acml_tr_pbmn | 기준가 대비 현재가 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:U
+fid_input_iscd:0001
+fid_input_hour_1:
+fid_mkop_cls_code:1
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "666666",
+ "bstp_nmix_prpr": "2765.30",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "18.67",
+ "prdy_ctrt": "0.68",
+ "acml_vol": "5951",
+ "acml_tr_pbmn": "130953"
+ },
+ {
+ "stck_cntg_hour": "085950",
+ "bstp_nmix_prpr": "2766.50",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "19.87",
+ "prdy_ctrt": "0.72",
+ "acml_vol": "5641",
+ "acml_tr_pbmn": "122873"
+ },
+ {
+ "stck_cntg_hour": "085940",
+ "bstp_nmix_prpr": "2768.19",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "21.56",
+ "prdy_ctrt": "0.78",
+ "acml_vol": "5369",
+ "acml_tr_pbmn": "115013"
+ },
+ {
+ "stck_cntg_hour": "085930",
+ "bstp_nmix_prpr": "2766.70",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.07",
+ "prdy_ctrt": "0.73",
+ "acml_vol": "5168",
+ "acml_tr_pbmn": "107488"
+ },
+ {
+ "stck_cntg_hour": "085920",
+ "bstp_nmix_prpr": "2767.01",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.38",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "5052",
+ "acml_tr_pbmn": "103832"
+ },
+ {
+ "stck_cntg_hour": "085910",
+ "bstp_nmix_prpr": "2767.09",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.46",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4919",
+ "acml_tr_pbmn": "101950"
+ },
+ {
+ "stck_cntg_hour": "085900",
+ "bstp_nmix_prpr": "2766.91",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.28",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4840",
+ "acml_tr_pbmn": "99526"
+ },
+ {
+ "stck_cntg_hour": "085850",
+ "bstp_nmix_prpr": "2767.06",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.43",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4740",
+ "acml_tr_pbmn": "93391"
+ },
+ {
+ "stck_cntg_hour": "085840",
+ "bstp_nmix_prpr": "2767.12",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.49",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "4655",
+ "acml_tr_pbmn": "92533"
+ },
+ {
+ "stck_cntg_hour": "085830",
+ "bstp_nmix_prpr": "2767.27",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.64",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "4639",
+ "acml_tr_pbmn": "91639"
+ },
+ {
+ "stck_cntg_hour": "085820",
+ "bstp_nmix_prpr": "2767.35",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.72",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "4560",
+ "acml_tr_pbmn": "90798"
+ },
+ {
+ "stck_cntg_hour": "085810",
+ "bstp_nmix_prpr": "2767.22",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.59",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "4541",
+ "acml_tr_pbmn": "93370"
+ },
+ {
+ "stck_cntg_hour": "085800",
+ "bstp_nmix_prpr": "2767.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.45",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4487",
+ "acml_tr_pbmn": "91617"
+ },
+ {
+ "stck_cntg_hour": "085750",
+ "bstp_nmix_prpr": "2766.75",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.12",
+ "prdy_ctrt": "0.73",
+ "acml_vol": "4440",
+ "acml_tr_pbmn": "90268"
+ },
+ {
+ "stck_cntg_hour": "085740",
+ "bstp_nmix_prpr": "2766.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.33",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4483",
+ "acml_tr_pbmn": "90078"
+ },
+ {
+ "stck_cntg_hour": "085730",
+ "bstp_nmix_prpr": "2766.93",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.30",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4427",
+ "acml_tr_pbmn": "89631"
+ },
+ {
+ "stck_cntg_hour": "085720",
+ "bstp_nmix_prpr": "2766.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.33",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4402",
+ "acml_tr_pbmn": "89052"
+ },
+ {
+ "stck_cntg_hour": "085710",
+ "bstp_nmix_prpr": "2767.00",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.37",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4525",
+ "acml_tr_pbmn": "87706"
+ },
+ {
+ "stck_cntg_hour": "085700",
+ "bstp_nmix_prpr": "2767.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.45",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4660",
+ "acml_tr_pbmn": "84754"
+ },
+ {
+ "stck_cntg_hour": "085650",
+ "bstp_nmix_prpr": "2767.40",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.77",
+ "prdy_ctrt": "0.76",
+ "acml_vol": "4636",
+ "acml_tr_pbmn": "84339"
+ },
+ {
+ "stck_cntg_hour": "085640",
+ "bstp_nmix_prpr": "2767.30",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.67",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "4569",
+ "acml_tr_pbmn": "84041"
+ },
+ {
+ "stck_cntg_hour": "085630",
+ "bstp_nmix_prpr": "2767.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.74",
+ "prdy_ctrt": "0.76",
+ "acml_vol": "4559",
+ "acml_tr_pbmn": "83314"
+ },
+ {
+ "stck_cntg_hour": "085620",
+ "bstp_nmix_prpr": "2767.43",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.80",
+ "prdy_ctrt": "0.76",
+ "acml_vol": "4490",
+ "acml_tr_pbmn": "83074"
+ },
+ {
+ "stck_cntg_hour": "085610",
+ "bstp_nmix_prpr": "2767.74",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "21.11",
+ "prdy_ctrt": "0.77",
+ "acml_vol": "4436",
+ "acml_tr_pbmn": "80274"
+ },
+ {
+ "stck_cntg_hour": "085600",
+ "bstp_nmix_prpr": "2766.95",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.32",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4032",
+ "acml_tr_pbmn": "78386"
+ },
+ {
+ "stck_cntg_hour": "085550",
+ "bstp_nmix_prpr": "2766.86",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.23",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "4026",
+ "acml_tr_pbmn": "77796"
+ },
+ {
+ "stck_cntg_hour": "085540",
+ "bstp_nmix_prpr": "2766.90",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.27",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "3946",
+ "acml_tr_pbmn": "76794"
+ },
+ {
+ "stck_cntg_hour": "085530",
+ "bstp_nmix_prpr": "2767.15",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.52",
+ "prdy_ctrt": "0.75",
+ "acml_vol": "3932",
+ "acml_tr_pbmn": "76859"
+ },
+ {
+ "stck_cntg_hour": "085520",
+ "bstp_nmix_prpr": "2766.95",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "20.32",
+ "prdy_ctrt": "0.74",
+ "acml_vol": "3922",
+ "acml_tr_pbmn": "75766"
+ },
+ {
+ "stck_cntg_hour": "085510",
+ "bstp_nmix_prpr": "2766.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "19.74",
+ "prdy_ctrt": "0.72",
+ "acml_vol": "4008",
+ "acml_tr_pbmn": "75458"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/071_v1_국내주식-021_국내주식업종기간별시세일_주_월_년.md b/docs/broker/kis/rest/국내주식/업종/기타/071_v1_국내주식-021_국내주식업종기간별시세일_주_월_년.md
new file mode 100644
index 0000000..b58edb2
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/071_v1_국내주식-021_국내주식업종기간별시세일_주_월_년.md
@@ -0,0 +1,143 @@
+# 국내주식업종기간별시세(일_주_월_년)
+
+- 원본 시트명: 국내주식업종기간별시세(일_주_월_년)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-021
+- HTTP Method: GET
+- 실전 TR_ID: FHKUP03500100
+- 모의 TR_ID: FHKUP03500100
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-indexchartprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 업종기간별시세(일/주/월/년) API입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 50건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '[실전투자/모의투자]
FHKUP03500100' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 업종 : U |
+| FID_INPUT_ISCD | 업종 상세코드 | string | Y | 2 | '0001 : 종합
0002 : 대형주
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조)' |
+| FID_INPUT_DATE_1 | 조회 시작일자 | string | Y | 10 | 조회 시작일자 (ex. 20220501) |
+| FID_INPUT_DATE_2 | 조회 종료일자 | string | Y | 10 | 조회 종료일자 (ex. 20220530) |
+| FID_PERIOD_DIV_CODE | ' 기간분류코드' | string | Y | 32 | ' D:일봉 W:주봉, M:월봉, Y:년봉' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | Single |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| prdy_nmix | 전일 지수 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| futs_prdy_oprc | 선물 전일 시가 | string | Y | 112 | |
+| futs_prdy_hgpr | 선물 전일 최고가 | string | Y | 112 | |
+| futs_prdy_lwpr | 선물 전일 최저가 | string | Y | 112 | |
+| output2 | 응답상세 | object array | Y | | Array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| mod_yn | 변경 여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "U",
+ "fid_input_date_1": "20220411",
+ "fid_input_date_2": "20220509",
+ "fid_input_iscd": "0001",
+ "fid_period_div_code": "D"
+ }
+```
+
+### Response Example
+
+```text
+"output1": {
+ "acml_tr_pbmn": "4736153",
+ "acml_vol": "305715",
+ "bstp_cls_code": "0001",
+ "bstp_nmix_hgpr": "2653.87",
+ "bstp_nmix_lwpr": "2634.29",
+ "bstp_nmix_oprc": "2651.63",
+ "bstp_nmix_prdy_ctrt": "0.11",
+ "bstp_nmix_prdy_vrss": "2.78",
+ "bstp_nmix_prpr": "2642.07",
+ "futs_prdy_hgpr": "2641.68",
+ "futs_prdy_lwpr": "2605.38",
+ "futs_prdy_oprc": "2605.78",
+ "hts_kor_isnm": "\uc885\ud569",
+ "prdy_nmix": "2639.29",
+ "prdy_vol": "755653",
+ "prdy_vrss_sign": "2"
+ },
+ "output2": [
+ {
+ "acml_tr_pbmn": "9289660",
+ "acml_vol": "892653",
+ "bstp_nmix_hgpr": "2642.75",
+ "bstp_nmix_lwpr": "2606.08",
+ "bstp_nmix_oprc": "2634.32",
+ "bstp_nmix_prpr": "2610.81",
+ "mod_yn": "N",
+ "stck_bsop_date": "20220509"
+ },
+ {
+ "acml_tr_pbmn": "10595418",
+ "acml_vol": "1333936",
+.....
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/072_국내주식-119_국내업종-시간별지수분.md b/docs/broker/kis/rest/국내주식/업종/기타/072_국내주식-119_국내업종-시간별지수분.md
new file mode 100644
index 0000000..7b3700a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/072_국내주식-119_국내업종-시간별지수분.md
@@ -0,0 +1,435 @@
+# 국내업종 시간별지수(분)
+
+- 원본 시트명: 국내업종 시간별지수(분)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-119
+- HTTP Method: GET
+- 실전 TR_ID: FHPUP02110200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-index-timeprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 시간별지수(분) API입니다.
+한국투자 HTS(eFriend Plus) > [0211] 업종 시간별지수 화면에서 우측 '1분' 선택 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPUP02110200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_HOUR_1 | ?입력 시간1 | string | Y | 10 | 초단위, 60(1분), 300(5분), 600(10분) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0001:거래소, 1001:코스닥, 2001:코스피200, 3003:KSQ150 |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업 시간 | string | Y | 6 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:U
+fid_input_iscd:1001
+fid_input_hour_1:120
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "bsop_hour": "100600",
+ "bstp_nmix_prpr": "916.77",
+ "bstp_nmix_prdy_vrss": "11.27",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3839797",
+ "acml_vol": "313374",
+ "cntg_vol": "870"
+ },
+ {
+ "bsop_hour": "100400",
+ "bstp_nmix_prpr": "916.65",
+ "bstp_nmix_prdy_vrss": "11.15",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3829216",
+ "acml_vol": "312504",
+ "cntg_vol": "4352"
+ },
+ {
+ "bsop_hour": "100200",
+ "bstp_nmix_prpr": "916.69",
+ "bstp_nmix_prdy_vrss": "11.19",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3779730",
+ "acml_vol": "308152",
+ "cntg_vol": "4959"
+ },
+ {
+ "bsop_hour": "100000",
+ "bstp_nmix_prpr": "916.76",
+ "bstp_nmix_prdy_vrss": "11.26",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3716791",
+ "acml_vol": "303193",
+ "cntg_vol": "5103"
+ },
+ {
+ "bsop_hour": "095800",
+ "bstp_nmix_prpr": "916.60",
+ "bstp_nmix_prdy_vrss": "11.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3651490",
+ "acml_vol": "298090",
+ "cntg_vol": "5732"
+ },
+ {
+ "bsop_hour": "095600",
+ "bstp_nmix_prpr": "917.37",
+ "bstp_nmix_prdy_vrss": "11.87",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3588380",
+ "acml_vol": "292358",
+ "cntg_vol": "5331"
+ },
+ {
+ "bsop_hour": "095400",
+ "bstp_nmix_prpr": "917.64",
+ "bstp_nmix_prdy_vrss": "12.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_tr_pbmn": "3521010",
+ "acml_vol": "287027",
+ "cntg_vol": "6827"
+ },
+ {
+ "bsop_hour": "095200",
+ "bstp_nmix_prpr": "916.31",
+ "bstp_nmix_prdy_vrss": "10.81",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.19",
+ "acml_tr_pbmn": "3445942",
+ "acml_vol": "280200",
+ "cntg_vol": "7263"
+ },
+ {
+ "bsop_hour": "095000",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3373037",
+ "acml_vol": "272937",
+ "cntg_vol": "5040"
+ },
+ {
+ "bsop_hour": "094800",
+ "bstp_nmix_prpr": "916.82",
+ "bstp_nmix_prdy_vrss": "11.32",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3304716",
+ "acml_vol": "267897",
+ "cntg_vol": "6828"
+ },
+ {
+ "bsop_hour": "094600",
+ "bstp_nmix_prpr": "916.74",
+ "bstp_nmix_prdy_vrss": "11.24",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3222590",
+ "acml_vol": "261069",
+ "cntg_vol": "8510"
+ },
+ {
+ "bsop_hour": "094400",
+ "bstp_nmix_prpr": "914.70",
+ "bstp_nmix_prdy_vrss": "9.20",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.02",
+ "acml_tr_pbmn": "3137995",
+ "acml_vol": "252559",
+ "cntg_vol": "6781"
+ },
+ {
+ "bsop_hour": "094200",
+ "bstp_nmix_prpr": "914.33",
+ "bstp_nmix_prdy_vrss": "8.83",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.98",
+ "acml_tr_pbmn": "3073035",
+ "acml_vol": "245778",
+ "cntg_vol": "7274"
+ },
+ {
+ "bsop_hour": "094000",
+ "bstp_nmix_prpr": "914.00",
+ "bstp_nmix_prdy_vrss": "8.50",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.94",
+ "acml_tr_pbmn": "3001499",
+ "acml_vol": "238504",
+ "cntg_vol": "7439"
+ },
+ {
+ "bsop_hour": "093800",
+ "bstp_nmix_prpr": "913.15",
+ "bstp_nmix_prdy_vrss": "7.65",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.84",
+ "acml_tr_pbmn": "2908979",
+ "acml_vol": "231065",
+ "cntg_vol": "8180"
+ },
+ {
+ "bsop_hour": "093600",
+ "bstp_nmix_prpr": "912.23",
+ "bstp_nmix_prdy_vrss": "6.73",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.74",
+ "acml_tr_pbmn": "2815470",
+ "acml_vol": "222885",
+ "cntg_vol": "7271"
+ },
+ {
+ "bsop_hour": "093400",
+ "bstp_nmix_prpr": "911.14",
+ "bstp_nmix_prdy_vrss": "5.64",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.62",
+ "acml_tr_pbmn": "2729472",
+ "acml_vol": "215614",
+ "cntg_vol": "6032"
+ },
+ {
+ "bsop_hour": "093200",
+ "bstp_nmix_prpr": "911.12",
+ "bstp_nmix_prdy_vrss": "5.62",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.62",
+ "acml_tr_pbmn": "2640030",
+ "acml_vol": "209582",
+ "cntg_vol": "7254"
+ },
+ {
+ "bsop_hour": "093000",
+ "bstp_nmix_prpr": "910.35",
+ "bstp_nmix_prdy_vrss": "4.85",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.54",
+ "acml_tr_pbmn": "2542281",
+ "acml_vol": "202328",
+ "cntg_vol": "7789"
+ },
+ {
+ "bsop_hour": "092800",
+ "bstp_nmix_prpr": "911.05",
+ "bstp_nmix_prdy_vrss": "5.55",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.61",
+ "acml_tr_pbmn": "2420975",
+ "acml_vol": "194539",
+ "cntg_vol": "8109"
+ },
+ {
+ "bsop_hour": "092600",
+ "bstp_nmix_prpr": "911.91",
+ "bstp_nmix_prdy_vrss": "6.41",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.71",
+ "acml_tr_pbmn": "2312684",
+ "acml_vol": "186430",
+ "cntg_vol": "8233"
+ },
+ {
+ "bsop_hour": "092400",
+ "bstp_nmix_prpr": "912.18",
+ "bstp_nmix_prdy_vrss": "6.68",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.74",
+ "acml_tr_pbmn": "2210228",
+ "acml_vol": "178197",
+ "cntg_vol": "8295"
+ },
+ {
+ "bsop_hour": "092200",
+ "bstp_nmix_prpr": "912.13",
+ "bstp_nmix_prdy_vrss": "6.63",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.73",
+ "acml_tr_pbmn": "2106912",
+ "acml_vol": "169902",
+ "cntg_vol": "9285"
+ },
+ {
+ "bsop_hour": "092000",
+ "bstp_nmix_prpr": "910.92",
+ "bstp_nmix_prdy_vrss": "5.42",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.60",
+ "acml_tr_pbmn": "1980631",
+ "acml_vol": "160617",
+ "cntg_vol": "10198"
+ },
+ {
+ "bsop_hour": "091800",
+ "bstp_nmix_prpr": "910.87",
+ "bstp_nmix_prdy_vrss": "5.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.59",
+ "acml_tr_pbmn": "1836549",
+ "acml_vol": "150419",
+ "cntg_vol": "10738"
+ },
+ {
+ "bsop_hour": "091600",
+ "bstp_nmix_prpr": "910.99",
+ "bstp_nmix_prdy_vrss": "5.49",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.61",
+ "acml_tr_pbmn": "1700334",
+ "acml_vol": "139681",
+ "cntg_vol": "11517"
+ },
+ {
+ "bsop_hour": "091400",
+ "bstp_nmix_prpr": "909.83",
+ "bstp_nmix_prdy_vrss": "4.33",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.48",
+ "acml_tr_pbmn": "1572262",
+ "acml_vol": "128164",
+ "cntg_vol": "12918"
+ },
+ {
+ "bsop_hour": "091200",
+ "bstp_nmix_prpr": "909.84",
+ "bstp_nmix_prdy_vrss": "4.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.48",
+ "acml_tr_pbmn": "1430578",
+ "acml_vol": "115246",
+ "cntg_vol": "12623"
+ },
+ {
+ "bsop_hour": "091000",
+ "bstp_nmix_prpr": "910.28",
+ "bstp_nmix_prdy_vrss": "4.78",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.53",
+ "acml_tr_pbmn": "1296270",
+ "acml_vol": "102623",
+ "cntg_vol": "14403"
+ },
+ {
+ "bsop_hour": "090800",
+ "bstp_nmix_prpr": "909.65",
+ "bstp_nmix_prdy_vrss": "4.15",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.46",
+ "acml_tr_pbmn": "1143581",
+ "acml_vol": "88220",
+ "cntg_vol": "11854"
+ },
+ {
+ "bsop_hour": "090600",
+ "bstp_nmix_prpr": "909.95",
+ "bstp_nmix_prdy_vrss": "4.45",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.49",
+ "acml_tr_pbmn": "980294",
+ "acml_vol": "76366",
+ "cntg_vol": "12512"
+ },
+ {
+ "bsop_hour": "090400",
+ "bstp_nmix_prpr": "909.15",
+ "bstp_nmix_prdy_vrss": "3.65",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.40",
+ "acml_tr_pbmn": "805755",
+ "acml_vol": "63854",
+ "cntg_vol": "14223"
+ },
+ {
+ "bsop_hour": "090200",
+ "bstp_nmix_prpr": "908.43",
+ "bstp_nmix_prdy_vrss": "2.93",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.32",
+ "acml_tr_pbmn": "606769",
+ "acml_vol": "49631",
+ "cntg_vol": "21310"
+ },
+ {
+ "bsop_hour": "090000",
+ "bstp_nmix_prpr": "910.96",
+ "bstp_nmix_prdy_vrss": "5.46",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.60",
+ "acml_tr_pbmn": "347460",
+ "acml_vol": "28321",
+ "cntg_vol": "28321"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/073_v1_국내주식-066_국내업종-구분별전체시세.md b/docs/broker/kis/rest/국내주식/업종/기타/073_v1_국내주식-066_국내업종-구분별전체시세.md
new file mode 100644
index 0000000..0060def
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/073_v1_국내주식-066_국내업종-구분별전체시세.md
@@ -0,0 +1,1058 @@
+# 국내업종 구분별전체시세
+
+- 원본 시트명: 국내업종 구분별전체시세
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-066
+- HTTP Method: GET
+- 실전 TR_ID: FHPUP02140000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-index-category-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 구분별전체시세 API입니다.
+한국투자 HTS(eFriend Plus) > [0214] 업종 전체시세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPUP02140000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 코스피(0001), 코스닥(1001), 코스피200(2001)
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조) |
+| FID_COND_SCR_DIV_CODE | FID 조건 화면 분류 코드 | string | Y | 5 | Unique key( 20214 ) |
+| FID_MRKT_CLS_CODE | FID 시장 구분 코드 | string | Y | 2 | 시장구분코드(K:거래소, Q:코스닥, K2:코스피200) |
+| FID_BLNG_CLS_CODE | FID 소속 구분 코드 | string | Y | 2 | 시장구분코드에 따라 아래와 같이 입력
시장구분코드(K:거래소) 0:전업종, 1:기타구분, 2:자본금구분 3:상업별구분
시장구분코드(Q:코스닥) 0:전업종, 1:기타구분, 2:벤처구분 3:일반구분
시장구분코드(K2:코스닥) 0:전업종 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | Y | | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 7 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 7 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 7 | |
+| uplm_issu_cnt | 상한 종목 수 | string | Y | 7 | |
+| lslm_issu_cnt | 하한 종목 수 | string | Y | 7 | |
+| prdy_tr_pbmn | 전일 거래 대금 | string | Y | 18 | |
+| dryy_bstp_nmix_hgpr_date | 연중업종지수최고가일자 | string | Y | 8 | |
+| dryy_bstp_nmix_hgpr | 연중업종지수최고가 | string | Y | 112 | |
+| dryy_bstp_nmix_lwpr | 연중업종지수최저가 | string | Y | 112 | |
+| dryy_bstp_nmix_lwpr_date | 연중업종지수최저가일자 | string | Y | 8 | |
+| output2 | 응답상세2 | object array | Y | | array |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| acml_vol_rlim | 누적 거래량 비중 | string | Y | 72 | |
+| acml_tr_pbmn_rlim | 누적 거래 대금 비중 | string | Y | 72 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"U",
+"fid_input_iscd":"0001",
+"fid_cond_scr_div_code":"20214",
+"fid_mrkt_cls_code":"K2",
+"fid_blng_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "bstp_nmix_prpr": "2648.76",
+ "bstp_nmix_prdy_vrss": "34.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_vol": "584715",
+ "acml_tr_pbmn": "10001487",
+ "bstp_nmix_oprc": "2635.63",
+ "bstp_nmix_hgpr": "2648.76",
+ "bstp_nmix_lwpr": "2625.01",
+ "prdy_vol": "621363",
+ "ascn_issu_cnt": "628",
+ "down_issu_cnt": "250",
+ "stnr_issu_cnt": "58",
+ "uplm_issu_cnt": "0",
+ "lslm_issu_cnt": "0",
+ "prdy_tr_pbmn": "10691024",
+ "dryy_bstp_nmix_hgpr_date": "20240102",
+ "dryy_bstp_nmix_hgpr": "2675.80",
+ "dryy_bstp_nmix_lwpr": "2429.12",
+ "dryy_bstp_nmix_lwpr_date": "20240118"
+ },
+ "output2": [
+ {
+ "bstp_cls_code": "2001",
+ "hts_kor_isnm": "KOSPI200",
+ "bstp_nmix_prpr": "355.52",
+ "bstp_nmix_prdy_vrss": "4.31",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_vol": "118963",
+ "acml_tr_pbmn": "7078909",
+ "acml_vol_rlim": "100.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2007",
+ "hts_kor_isnm": "KOSPI100",
+ "bstp_nmix_prpr": "2691.34",
+ "bstp_nmix_prdy_vrss": "33.27",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_vol": "76784",
+ "acml_tr_pbmn": "6124444",
+ "acml_vol_rlim": "64.54",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2008",
+ "hts_kor_isnm": "KOSPI50",
+ "bstp_nmix_prpr": "2478.39",
+ "bstp_nmix_prdy_vrss": "28.83",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.18",
+ "acml_vol": "52269",
+ "acml_tr_pbmn": "5222300",
+ "acml_vol_rlim": "43.94",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2039",
+ "hts_kor_isnm": "K커뮤니케이션서비스",
+ "bstp_nmix_prpr": "1850.38",
+ "bstp_nmix_prdy_vrss": "3.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.17",
+ "acml_vol": "5893",
+ "acml_tr_pbmn": "477398",
+ "acml_vol_rlim": "4.95",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2009",
+ "hts_kor_isnm": "K건설",
+ "bstp_nmix_prpr": "325.34",
+ "bstp_nmix_prdy_vrss": "8.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.55",
+ "acml_vol": "6636",
+ "acml_tr_pbmn": "225841",
+ "acml_vol_rlim": "5.58",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2010",
+ "hts_kor_isnm": "K중공업",
+ "bstp_nmix_prpr": "322.92",
+ "bstp_nmix_prdy_vrss": "3.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.05",
+ "acml_vol": "9613",
+ "acml_tr_pbmn": "203930",
+ "acml_vol_rlim": "8.08",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2011",
+ "hts_kor_isnm": "K철강소재",
+ "bstp_nmix_prpr": "884.98",
+ "bstp_nmix_prdy_vrss": "35.05",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "4.12",
+ "acml_vol": "4814",
+ "acml_tr_pbmn": "456186",
+ "acml_vol_rlim": "4.05",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2012",
+ "hts_kor_isnm": "K에너지화학",
+ "bstp_nmix_prpr": "1385.94",
+ "bstp_nmix_prdy_vrss": "45.89",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.42",
+ "acml_vol": "7623",
+ "acml_tr_pbmn": "833756",
+ "acml_vol_rlim": "6.41",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2013",
+ "hts_kor_isnm": "K정보기술",
+ "bstp_nmix_prpr": "3233.61",
+ "bstp_nmix_prdy_vrss": "42.48",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.33",
+ "acml_vol": "20799",
+ "acml_tr_pbmn": "1899061",
+ "acml_vol_rlim": "17.48",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2014",
+ "hts_kor_isnm": "K금융",
+ "bstp_nmix_prpr": "780.59",
+ "bstp_nmix_prdy_vrss": "27.94",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.71",
+ "acml_vol": "23753",
+ "acml_tr_pbmn": "672909",
+ "acml_vol_rlim": "19.97",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2015",
+ "hts_kor_isnm": "K생활소비재",
+ "bstp_nmix_prpr": "793.68",
+ "bstp_nmix_prdy_vrss": "12.81",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.64",
+ "acml_vol": "4244",
+ "acml_tr_pbmn": "288488",
+ "acml_vol_rlim": "3.57",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2016",
+ "hts_kor_isnm": "K경기소비재",
+ "bstp_nmix_prpr": "1724.67",
+ "bstp_nmix_prdy_vrss": "42.88",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.55",
+ "acml_vol": "10060",
+ "acml_tr_pbmn": "1004566",
+ "acml_vol_rlim": "8.46",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2017",
+ "hts_kor_isnm": "K산업재",
+ "bstp_nmix_prpr": "633.49",
+ "bstp_nmix_prdy_vrss": "6.82",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.09",
+ "acml_vol": "23323",
+ "acml_tr_pbmn": "823914",
+ "acml_vol_rlim": "19.61",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2018",
+ "hts_kor_isnm": "K헬스케어",
+ "bstp_nmix_prpr": "1840.09",
+ "bstp_nmix_prdy_vrss": "14.36",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.79",
+ "acml_vol": "2204",
+ "acml_tr_pbmn": "192860",
+ "acml_vol_rlim": "1.85",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2019",
+ "hts_kor_isnm": "K고배당",
+ "bstp_nmix_prpr": "3173.16",
+ "bstp_nmix_prdy_vrss": "86.09",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.79",
+ "acml_vol": "41569",
+ "acml_tr_pbmn": "2859723",
+ "acml_vol_rlim": "34.94",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2021",
+ "hts_kor_isnm": "K200가치저변동성",
+ "bstp_nmix_prpr": "5446.64",
+ "bstp_nmix_prdy_vrss": "120.03",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.25",
+ "acml_vol": "86859",
+ "acml_tr_pbmn": "4469357",
+ "acml_vol_rlim": "73.01",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2022",
+ "hts_kor_isnm": "K200중소형주",
+ "bstp_nmix_prpr": "1221.07",
+ "bstp_nmix_prdy_vrss": "22.17",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.85",
+ "acml_vol": "42179",
+ "acml_tr_pbmn": "954465",
+ "acml_vol_rlim": "35.46",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2023",
+ "hts_kor_isnm": "K200경기방어소비재",
+ "bstp_nmix_prpr": "903.55",
+ "bstp_nmix_prdy_vrss": "8.98",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.00",
+ "acml_vol": "8450",
+ "acml_tr_pbmn": "550010",
+ "acml_vol_rlim": "7.10",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2024",
+ "hts_kor_isnm": "K200에너지화학 레버리지",
+ "bstp_nmix_prpr": "836.53",
+ "bstp_nmix_prdy_vrss": "53.55",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "6.84",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2025",
+ "hts_kor_isnm": "K200정보기술 레버리지",
+ "bstp_nmix_prpr": "4350.42",
+ "bstp_nmix_prdy_vrss": "112.40",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.65",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2026",
+ "hts_kor_isnm": "K200금융 레버리지",
+ "bstp_nmix_prpr": "517.48",
+ "bstp_nmix_prdy_vrss": "35.72",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "7.41",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2027",
+ "hts_kor_isnm": "K200경기소비재 레버리지",
+ "bstp_nmix_prpr": "989.98",
+ "bstp_nmix_prdy_vrss": "47.94",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "5.09",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2035",
+ "hts_kor_isnm": "코스피200 TR",
+ "bstp_nmix_prpr": "449.66",
+ "bstp_nmix_prdy_vrss": "5.45",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2036",
+ "hts_kor_isnm": "코스피200 NTR",
+ "bstp_nmix_prpr": "433.34",
+ "bstp_nmix_prdy_vrss": "5.25",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2028",
+ "hts_kor_isnm": "K200건설 레버리지",
+ "bstp_nmix_prpr": "204.06",
+ "bstp_nmix_prdy_vrss": "9.87",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "5.08",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2029",
+ "hts_kor_isnm": "K200중공업 레버리지",
+ "bstp_nmix_prpr": "169.43",
+ "bstp_nmix_prdy_vrss": "3.48",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.10",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2030",
+ "hts_kor_isnm": "K200헬스케어 레버리지",
+ "bstp_nmix_prpr": "659.07",
+ "bstp_nmix_prdy_vrss": "10.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.56",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2040",
+ "hts_kor_isnm": "코스피200 초대형 제외지수",
+ "bstp_nmix_prpr": "256.52",
+ "bstp_nmix_prdy_vrss": "4.70",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.87",
+ "acml_vol": "105736",
+ "acml_tr_pbmn": "6115607",
+ "acml_vol_rlim": "88.88",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2037",
+ "hts_kor_isnm": "코스피200 예측 고배당 50",
+ "bstp_nmix_prpr": "1989.88",
+ "bstp_nmix_prdy_vrss": "49.77",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.57",
+ "acml_vol": "22491",
+ "acml_tr_pbmn": "1659649",
+ "acml_vol_rlim": "18.91",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2038",
+ "hts_kor_isnm": "코스피200 예측 배당성장 50",
+ "bstp_nmix_prpr": "1661.50",
+ "bstp_nmix_prdy_vrss": "33.18",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.04",
+ "acml_vol": "39463",
+ "acml_tr_pbmn": "2424471",
+ "acml_vol_rlim": "33.17",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2041",
+ "hts_kor_isnm": "K200 정보기술 TR",
+ "bstp_nmix_prpr": "3742.21",
+ "bstp_nmix_prdy_vrss": "49.16",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.33",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2042",
+ "hts_kor_isnm": "K200 금융 TR",
+ "bstp_nmix_prpr": "1192.40",
+ "bstp_nmix_prdy_vrss": "42.68",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.71",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2044",
+ "hts_kor_isnm": "K200 에너지화학 TR",
+ "bstp_nmix_prpr": "1786.68",
+ "bstp_nmix_prdy_vrss": "59.16",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.42",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2045",
+ "hts_kor_isnm": "K200 생활소비재 TR",
+ "bstp_nmix_prpr": "1031.76",
+ "bstp_nmix_prdy_vrss": "16.65",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.64",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2046",
+ "hts_kor_isnm": "K200 건설 TR",
+ "bstp_nmix_prpr": "386.22",
+ "bstp_nmix_prdy_vrss": "9.59",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.55",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2047",
+ "hts_kor_isnm": "K200 중공업 TR",
+ "bstp_nmix_prpr": "356.92",
+ "bstp_nmix_prdy_vrss": "3.72",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.05",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2048",
+ "hts_kor_isnm": "K200 철강소재 TR",
+ "bstp_nmix_prpr": "1172.71",
+ "bstp_nmix_prdy_vrss": "46.45",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "4.12",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2049",
+ "hts_kor_isnm": "K200 산업재 TR",
+ "bstp_nmix_prpr": "753.63",
+ "bstp_nmix_prdy_vrss": "8.11",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.09",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2050",
+ "hts_kor_isnm": "K200 헬스케어 TR",
+ "bstp_nmix_prpr": "1966.27",
+ "bstp_nmix_prdy_vrss": "15.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.79",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2051",
+ "hts_kor_isnm": "K200 커뮤니케이션서비스 TR",
+ "bstp_nmix_prpr": "2355.58",
+ "bstp_nmix_prdy_vrss": "4.00",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.17",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2224",
+ "hts_kor_isnm": "K200 비중상한 30%",
+ "bstp_nmix_prpr": "355.08",
+ "bstp_nmix_prdy_vrss": "4.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_vol": "118963",
+ "acml_tr_pbmn": "7078909",
+ "acml_vol_rlim": "100.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2225",
+ "hts_kor_isnm": "K200 비중상한 30% TR",
+ "bstp_nmix_prpr": "449.00",
+ "bstp_nmix_prdy_vrss": "5.53",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2226",
+ "hts_kor_isnm": "K200 비중상한 30% NTR",
+ "bstp_nmix_prpr": "432.91",
+ "bstp_nmix_prdy_vrss": "5.33",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2227",
+ "hts_kor_isnm": "K200 비중상한 25%",
+ "bstp_nmix_prpr": "351.32",
+ "bstp_nmix_prdy_vrss": "4.69",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.35",
+ "acml_vol": "118963",
+ "acml_tr_pbmn": "7078909",
+ "acml_vol_rlim": "100.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2228",
+ "hts_kor_isnm": "K200 비중상한 25% TR",
+ "bstp_nmix_prpr": "444.32",
+ "bstp_nmix_prdy_vrss": "5.93",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.35",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2230",
+ "hts_kor_isnm": "K200 비중상한 25% NTR",
+ "bstp_nmix_prpr": "428.34",
+ "bstp_nmix_prdy_vrss": "5.72",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.35",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2232",
+ "hts_kor_isnm": "K200 비중상한 20%",
+ "bstp_nmix_prpr": "341.02",
+ "bstp_nmix_prdy_vrss": "4.89",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.45",
+ "acml_vol": "118963",
+ "acml_tr_pbmn": "7078909",
+ "acml_vol_rlim": "100.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2233",
+ "hts_kor_isnm": "K200 비중상한 20% TR",
+ "bstp_nmix_prpr": "430.39",
+ "bstp_nmix_prdy_vrss": "6.17",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.45",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2235",
+ "hts_kor_isnm": "K200 비중상한 20% NTR",
+ "bstp_nmix_prpr": "415.42",
+ "bstp_nmix_prdy_vrss": "5.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.46",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2043",
+ "hts_kor_isnm": "K200 경기소비재 TR",
+ "bstp_nmix_prpr": "2152.99",
+ "bstp_nmix_prdy_vrss": "53.53",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.55",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2284",
+ "hts_kor_isnm": "코스피 200 선물지수 TWAP형",
+ "bstp_nmix_prpr": "1786.47",
+ "bstp_nmix_prdy_vrss": "18.33",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.04",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2285",
+ "hts_kor_isnm": "코스피 200 선물 TWAP 인버스지수",
+ "bstp_nmix_prpr": "2555.41",
+ "bstp_nmix_prdy_vrss": "-26.53",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-1.03",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2286",
+ "hts_kor_isnm": "코스피 200 선물 TWAP 레버리지",
+ "bstp_nmix_prpr": "1448.92",
+ "bstp_nmix_prdy_vrss": "29.55",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.08",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2287",
+ "hts_kor_isnm": "코스피 200 선물 TWAP 인버스-2X",
+ "bstp_nmix_prpr": "2598.71",
+ "bstp_nmix_prdy_vrss": "-54.80",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-2.07",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2751",
+ "hts_kor_isnm": "F-K200 에너지/화학",
+ "bstp_nmix_prpr": "1201.20",
+ "bstp_nmix_prdy_vrss": "34.48",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.96",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2752",
+ "hts_kor_isnm": "F-K200 정보기술",
+ "bstp_nmix_prpr": "2051.35",
+ "bstp_nmix_prdy_vrss": "18.30",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.90",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2753",
+ "hts_kor_isnm": "F-K200 금융",
+ "bstp_nmix_prpr": "1291.69",
+ "bstp_nmix_prdy_vrss": "40.86",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.27",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2754",
+ "hts_kor_isnm": "F-K200 경기소비재",
+ "bstp_nmix_prpr": "1121.37",
+ "bstp_nmix_prdy_vrss": "17.42",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.58",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2755",
+ "hts_kor_isnm": "F-K200 건설",
+ "bstp_nmix_prpr": "1218.34",
+ "bstp_nmix_prdy_vrss": "25.51",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "2.14",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2756",
+ "hts_kor_isnm": "F-K200 중공업",
+ "bstp_nmix_prpr": "962.17",
+ "bstp_nmix_prdy_vrss": "8.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.94",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2757",
+ "hts_kor_isnm": "F-K200 헬스케어",
+ "bstp_nmix_prpr": "963.71",
+ "bstp_nmix_prdy_vrss": "2.84",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.30",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2758",
+ "hts_kor_isnm": "F-K200 생활소비재",
+ "bstp_nmix_prpr": "637.56",
+ "bstp_nmix_prdy_vrss": "1.77",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.28",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2759",
+ "hts_kor_isnm": "F-K200 철강/소재",
+ "bstp_nmix_prpr": "903.55",
+ "bstp_nmix_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "bstp_nmix_prdy_ctrt": "0.00",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2760",
+ "hts_kor_isnm": "F-K200 산업재",
+ "bstp_nmix_prpr": "1031.59",
+ "bstp_nmix_prdy_vrss": "7.80",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.76",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2761",
+ "hts_kor_isnm": "F-K200 에너지/화학 레버리지",
+ "bstp_nmix_prpr": "1039.81",
+ "bstp_nmix_prdy_vrss": "58.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "5.92",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2762",
+ "hts_kor_isnm": "F-K200 정보기술 레버리지",
+ "bstp_nmix_prpr": "3228.56",
+ "bstp_nmix_prdy_vrss": "57.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.81",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2763",
+ "hts_kor_isnm": "F-K200 금융 레버리지",
+ "bstp_nmix_prpr": "1311.74",
+ "bstp_nmix_prdy_vrss": "80.53",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "6.54",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2764",
+ "hts_kor_isnm": "F-K200 경기소비재 레버리지",
+ "bstp_nmix_prpr": "1001.75",
+ "bstp_nmix_prdy_vrss": "30.72",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "3.16",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2765",
+ "hts_kor_isnm": "F-K200 건설 레버리지",
+ "bstp_nmix_prpr": "976.07",
+ "bstp_nmix_prdy_vrss": "40.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "4.28",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2766",
+ "hts_kor_isnm": "F-K200 중공업 레버리지",
+ "bstp_nmix_prpr": "532.58",
+ "bstp_nmix_prdy_vrss": "9.86",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.89",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2767",
+ "hts_kor_isnm": "F-K200 헬스케어 레버리지",
+ "bstp_nmix_prpr": "610.89",
+ "bstp_nmix_prdy_vrss": "3.63",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.60",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2768",
+ "hts_kor_isnm": "F-K200 생활소비재 레버리지",
+ "bstp_nmix_prpr": "376.44",
+ "bstp_nmix_prdy_vrss": "2.12",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.57",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2769",
+ "hts_kor_isnm": "F-K200 철강/소재 레버리지",
+ "bstp_nmix_prpr": "546.02",
+ "bstp_nmix_prdy_vrss": "0.04",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.01",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2770",
+ "hts_kor_isnm": "F-K200 산업재 레버리지",
+ "bstp_nmix_prpr": "868.46",
+ "bstp_nmix_prdy_vrss": "13.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.53",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2771",
+ "hts_kor_isnm": "F-K200 에너지/화학 인버스",
+ "bstp_nmix_prpr": "607.50",
+ "bstp_nmix_prdy_vrss": "-18.44",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-2.95",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2772",
+ "hts_kor_isnm": "F-K200 정보기술 인버스",
+ "bstp_nmix_prpr": "379.71",
+ "bstp_nmix_prdy_vrss": "-3.41",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-0.89",
+ "acml_vol": "0",
+ "acml_tr_pbmn": "0",
+ "acml_vol_rlim": "0.00",
+ "acml_tr_pbmn_rlim": ""
+ },
+ {
+ "bstp_cls_code": "2773",
+ "hts_kor_isnm": "F-K200 금융 인버스",
+ "bstp_nmix_prpr": "615.73",
+ "bstp_nmix_prdy_vrss": "-20.73",
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/074_v1_국내주식-045_업종-분봉조회.md b/docs/broker/kis/rest/국내주식/업종/기타/074_v1_국내주식-045_업종-분봉조회.md
new file mode 100644
index 0000000..d067148
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/074_v1_국내주식-045_업종-분봉조회.md
@@ -0,0 +1,1060 @@
+# 업종 분봉조회
+
+- 원본 시트명: 업종 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-045
+- HTTP Method: GET
+- 실전 TR_ID: FHKUP03500200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-indexchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+업종 분봉조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0350] 업종 종합차트 화면의 분봉기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+실전계좌의 경우, 한 번의 호출에 최대 102건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKUP03500200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | U |
+| FID_ETC_CLS_CODE | FID 기타 구분 코드 | string | Y | 12 | 0: 기본 1:장마감,시간외 제외 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 0001 : 종합
0002 : 대형주
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조) |
+| FID_INPUT_HOUR_1 | FID 입력 시간1 | string | Y | 12 | 30, 60 -> 1분, 600-> 10분, 3600 -> 1시간 |
+| FID_PW_DATA_INCU_YN | FID 과거 데이터 포함 여부 | string | Y | 12 | Y (과거) / N (당일) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output1 | 응답상세 | object array | Y | | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| prdy_nmix | 전일 지수 | string | Y | 112 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| futs_prdy_oprc | 선물 전일 시가 | string | Y | 112 | |
+| futs_prdy_hgpr | 선물 전일 최고가 | string | Y | 112 | |
+| futs_prdy_lwpr | 선물 전일 최저가 | string | Y | 112 | |
+| Output2 | 응답상세2 | object | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"FID_COND_MRKT_DIV_CODE":"U",
+"FID_INPUT_ISCD":"1001",
+"FID_INPUT_HOUR_1":"120",
+"FID_PW_DATA_INCU_YN":"Y",
+"FID_ETC_CLS_CODE":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "bstp_nmix_prdy_vrss": "-3.68",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-0.44",
+ "prdy_nmix": "837.24",
+ "acml_vol": "554702",
+ "acml_tr_pbmn": "5740155",
+ "hts_kor_isnm": "KOSDAQ",
+ "bstp_nmix_prpr": "833.56",
+ "bstp_cls_code": "1001",
+ "prdy_vol": "1238780",
+ "bstp_nmix_oprc": "841.21",
+ "bstp_nmix_hgpr": "841.21",
+ "bstp_nmix_lwpr": "830.09",
+ "futs_prdy_oprc": "818.76",
+ "futs_prdy_hgpr": "839.52",
+ "futs_prdy_lwpr": "817.06"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "103200",
+ "bstp_nmix_prpr": "833.56",
+ "bstp_nmix_oprc": "834.07",
+ "bstp_nmix_hgpr": "834.07",
+ "bstp_nmix_lwpr": "833.56",
+ "cntg_vol": "4618",
+ "acml_tr_pbmn": "5740155"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "103000",
+ "bstp_nmix_prpr": "833.99",
+ "bstp_nmix_oprc": "834.29",
+ "bstp_nmix_hgpr": "834.29",
+ "bstp_nmix_lwpr": "833.89",
+ "cntg_vol": "4601",
+ "acml_tr_pbmn": "5689290"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "102800",
+ "bstp_nmix_prpr": "834.24",
+ "bstp_nmix_oprc": "833.47",
+ "bstp_nmix_hgpr": "834.32",
+ "bstp_nmix_lwpr": "833.44",
+ "cntg_vol": "4978",
+ "acml_tr_pbmn": "5635506"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "102600",
+ "bstp_nmix_prpr": "833.46",
+ "bstp_nmix_oprc": "832.36",
+ "bstp_nmix_hgpr": "833.46",
+ "bstp_nmix_lwpr": "832.36",
+ "cntg_vol": "5033",
+ "acml_tr_pbmn": "5581000"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "102400",
+ "bstp_nmix_prpr": "832.48",
+ "bstp_nmix_oprc": "832.92",
+ "bstp_nmix_hgpr": "832.92",
+ "bstp_nmix_lwpr": "832.47",
+ "cntg_vol": "5239",
+ "acml_tr_pbmn": "5518332"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "102200",
+ "bstp_nmix_prpr": "832.85",
+ "bstp_nmix_oprc": "832.77",
+ "bstp_nmix_hgpr": "832.87",
+ "bstp_nmix_lwpr": "832.69",
+ "cntg_vol": "6042",
+ "acml_tr_pbmn": "5455651"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "102000",
+ "bstp_nmix_prpr": "832.74",
+ "bstp_nmix_oprc": "832.55",
+ "bstp_nmix_hgpr": "833.25",
+ "bstp_nmix_lwpr": "832.55",
+ "cntg_vol": "6301",
+ "acml_tr_pbmn": "5372736"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "101800",
+ "bstp_nmix_prpr": "832.83",
+ "bstp_nmix_oprc": "832.51",
+ "bstp_nmix_hgpr": "832.83",
+ "bstp_nmix_lwpr": "832.22",
+ "cntg_vol": "5676",
+ "acml_tr_pbmn": "5284172"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "101600",
+ "bstp_nmix_prpr": "832.50",
+ "bstp_nmix_oprc": "832.27",
+ "bstp_nmix_hgpr": "832.62",
+ "bstp_nmix_lwpr": "832.09",
+ "cntg_vol": "4771",
+ "acml_tr_pbmn": "5219827"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "101400",
+ "bstp_nmix_prpr": "832.44",
+ "bstp_nmix_oprc": "832.03",
+ "bstp_nmix_hgpr": "832.52",
+ "bstp_nmix_lwpr": "832.03",
+ "cntg_vol": "6639",
+ "acml_tr_pbmn": "5167005"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "101200",
+ "bstp_nmix_prpr": "832.11",
+ "bstp_nmix_oprc": "831.98",
+ "bstp_nmix_hgpr": "832.24",
+ "bstp_nmix_lwpr": "831.75",
+ "cntg_vol": "6946",
+ "acml_tr_pbmn": "5093186"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "101000",
+ "bstp_nmix_prpr": "832.23",
+ "bstp_nmix_oprc": "831.36",
+ "bstp_nmix_hgpr": "832.23",
+ "bstp_nmix_lwpr": "831.35",
+ "cntg_vol": "6579",
+ "acml_tr_pbmn": "5011060"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "100800",
+ "bstp_nmix_prpr": "831.22",
+ "bstp_nmix_oprc": "831.05",
+ "bstp_nmix_hgpr": "831.22",
+ "bstp_nmix_lwpr": "830.55",
+ "cntg_vol": "6837",
+ "acml_tr_pbmn": "4928657"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "100600",
+ "bstp_nmix_prpr": "830.98",
+ "bstp_nmix_oprc": "831.46",
+ "bstp_nmix_hgpr": "831.54",
+ "bstp_nmix_lwpr": "830.98",
+ "cntg_vol": "6694",
+ "acml_tr_pbmn": "4854815"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "100400",
+ "bstp_nmix_prpr": "831.76",
+ "bstp_nmix_oprc": "830.79",
+ "bstp_nmix_hgpr": "831.76",
+ "bstp_nmix_lwpr": "830.79",
+ "cntg_vol": "6839",
+ "acml_tr_pbmn": "4781557"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "100200",
+ "bstp_nmix_prpr": "830.92",
+ "bstp_nmix_oprc": "831.17",
+ "bstp_nmix_hgpr": "831.21",
+ "bstp_nmix_lwpr": "830.71",
+ "cntg_vol": "9589",
+ "acml_tr_pbmn": "4724555"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "100000",
+ "bstp_nmix_prpr": "831.14",
+ "bstp_nmix_oprc": "831.32",
+ "bstp_nmix_hgpr": "831.52",
+ "bstp_nmix_lwpr": "830.90",
+ "cntg_vol": "8688",
+ "acml_tr_pbmn": "4652376"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "095800",
+ "bstp_nmix_prpr": "831.56",
+ "bstp_nmix_oprc": "831.32",
+ "bstp_nmix_hgpr": "831.76",
+ "bstp_nmix_lwpr": "831.32",
+ "cntg_vol": "6519",
+ "acml_tr_pbmn": "4568901"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "095600",
+ "bstp_nmix_prpr": "831.43",
+ "bstp_nmix_oprc": "830.68",
+ "bstp_nmix_hgpr": "831.43",
+ "bstp_nmix_lwpr": "830.52",
+ "cntg_vol": "7474",
+ "acml_tr_pbmn": "4497224"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "095400",
+ "bstp_nmix_prpr": "830.50",
+ "bstp_nmix_oprc": "831.46",
+ "bstp_nmix_hgpr": "831.46",
+ "bstp_nmix_lwpr": "830.50",
+ "cntg_vol": "9190",
+ "acml_tr_pbmn": "4423313"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "095200",
+ "bstp_nmix_prpr": "831.57",
+ "bstp_nmix_oprc": "831.45",
+ "bstp_nmix_hgpr": "831.59",
+ "bstp_nmix_lwpr": "831.38",
+ "cntg_vol": "7701",
+ "acml_tr_pbmn": "4324541"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "095000",
+ "bstp_nmix_prpr": "831.60",
+ "bstp_nmix_oprc": "831.45",
+ "bstp_nmix_hgpr": "831.82",
+ "bstp_nmix_lwpr": "831.39",
+ "cntg_vol": "7529",
+ "acml_tr_pbmn": "4247753"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "094800",
+ "bstp_nmix_prpr": "831.57",
+ "bstp_nmix_oprc": "831.71",
+ "bstp_nmix_hgpr": "831.76",
+ "bstp_nmix_lwpr": "831.47",
+ "cntg_vol": "7754",
+ "acml_tr_pbmn": "4165554"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "094600",
+ "bstp_nmix_prpr": "831.77",
+ "bstp_nmix_oprc": "830.50",
+ "bstp_nmix_hgpr": "831.91",
+ "bstp_nmix_lwpr": "830.44",
+ "cntg_vol": "9213",
+ "acml_tr_pbmn": "4076635"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "094400",
+ "bstp_nmix_prpr": "830.26",
+ "bstp_nmix_oprc": "830.57",
+ "bstp_nmix_hgpr": "830.67",
+ "bstp_nmix_lwpr": "830.09",
+ "cntg_vol": "7201",
+ "acml_tr_pbmn": "3971601"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "094200",
+ "bstp_nmix_prpr": "830.53",
+ "bstp_nmix_oprc": "831.03",
+ "bstp_nmix_hgpr": "831.21",
+ "bstp_nmix_lwpr": "830.48",
+ "cntg_vol": "7992",
+ "acml_tr_pbmn": "3886154"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "094000",
+ "bstp_nmix_prpr": "830.98",
+ "bstp_nmix_oprc": "831.26",
+ "bstp_nmix_hgpr": "831.26",
+ "bstp_nmix_lwpr": "830.32",
+ "cntg_vol": "9912",
+ "acml_tr_pbmn": "3790733"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "093800",
+ "bstp_nmix_prpr": "831.32",
+ "bstp_nmix_oprc": "832.07",
+ "bstp_nmix_hgpr": "832.07",
+ "bstp_nmix_lwpr": "831.27",
+ "cntg_vol": "9575",
+ "acml_tr_pbmn": "3663618"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "093600",
+ "bstp_nmix_prpr": "832.24",
+ "bstp_nmix_oprc": "831.34",
+ "bstp_nmix_hgpr": "832.30",
+ "bstp_nmix_lwpr": "831.34",
+ "cntg_vol": "10164",
+ "acml_tr_pbmn": "3561037"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "093400",
+ "bstp_nmix_prpr": "831.44",
+ "bstp_nmix_oprc": "832.64",
+ "bstp_nmix_hgpr": "832.64",
+ "bstp_nmix_lwpr": "831.44",
+ "cntg_vol": "11415",
+ "acml_tr_pbmn": "3447235"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "093200",
+ "bstp_nmix_prpr": "832.53",
+ "bstp_nmix_oprc": "833.45",
+ "bstp_nmix_hgpr": "833.66",
+ "bstp_nmix_lwpr": "832.53",
+ "cntg_vol": "11522",
+ "acml_tr_pbmn": "3316543"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "093000",
+ "bstp_nmix_prpr": "833.58",
+ "bstp_nmix_oprc": "833.59",
+ "bstp_nmix_hgpr": "834.05",
+ "bstp_nmix_lwpr": "833.36",
+ "cntg_vol": "11105",
+ "acml_tr_pbmn": "3203362"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "092800",
+ "bstp_nmix_prpr": "833.97",
+ "bstp_nmix_oprc": "832.91",
+ "bstp_nmix_hgpr": "833.97",
+ "bstp_nmix_lwpr": "832.36",
+ "cntg_vol": "15502",
+ "acml_tr_pbmn": "3071005"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "092600",
+ "bstp_nmix_prpr": "833.08",
+ "bstp_nmix_oprc": "835.04",
+ "bstp_nmix_hgpr": "835.04",
+ "bstp_nmix_lwpr": "833.00",
+ "cntg_vol": "15656",
+ "acml_tr_pbmn": "2928429"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "092400",
+ "bstp_nmix_prpr": "834.63",
+ "bstp_nmix_oprc": "833.51",
+ "bstp_nmix_hgpr": "834.98",
+ "bstp_nmix_lwpr": "833.51",
+ "cntg_vol": "16851",
+ "acml_tr_pbmn": "2747155"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "092200",
+ "bstp_nmix_prpr": "833.45",
+ "bstp_nmix_oprc": "835.50",
+ "bstp_nmix_hgpr": "835.50",
+ "bstp_nmix_lwpr": "833.45",
+ "cntg_vol": "16696",
+ "acml_tr_pbmn": "2583365"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "092000",
+ "bstp_nmix_prpr": "835.91",
+ "bstp_nmix_oprc": "835.96",
+ "bstp_nmix_hgpr": "836.14",
+ "bstp_nmix_lwpr": "835.76",
+ "cntg_vol": "16008",
+ "acml_tr_pbmn": "2424467"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "091800",
+ "bstp_nmix_prpr": "836.05",
+ "bstp_nmix_oprc": "838.39",
+ "bstp_nmix_hgpr": "838.39",
+ "bstp_nmix_lwpr": "835.98",
+ "cntg_vol": "16778",
+ "acml_tr_pbmn": "2260216"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "091600",
+ "bstp_nmix_prpr": "838.24",
+ "bstp_nmix_oprc": "837.19",
+ "bstp_nmix_hgpr": "838.70",
+ "bstp_nmix_lwpr": "837.19",
+ "cntg_vol": "17379",
+ "acml_tr_pbmn": "2098721"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "091400",
+ "bstp_nmix_prpr": "836.82",
+ "bstp_nmix_oprc": "836.88",
+ "bstp_nmix_hgpr": "837.94",
+ "bstp_nmix_lwpr": "836.48",
+ "cntg_vol": "19020",
+ "acml_tr_pbmn": "1934637"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "091200",
+ "bstp_nmix_prpr": "836.73",
+ "bstp_nmix_oprc": "837.87",
+ "bstp_nmix_hgpr": "838.34",
+ "bstp_nmix_lwpr": "836.73",
+ "cntg_vol": "27881",
+ "acml_tr_pbmn": "1781817"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "091000",
+ "bstp_nmix_prpr": "837.70",
+ "bstp_nmix_oprc": "837.68",
+ "bstp_nmix_hgpr": "837.72",
+ "bstp_nmix_lwpr": "837.38",
+ "cntg_vol": "16983",
+ "acml_tr_pbmn": "1606668"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "090800",
+ "bstp_nmix_prpr": "837.87",
+ "bstp_nmix_oprc": "840.59",
+ "bstp_nmix_hgpr": "840.59",
+ "bstp_nmix_lwpr": "837.87",
+ "cntg_vol": "21991",
+ "acml_tr_pbmn": "1441148"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "090600",
+ "bstp_nmix_prpr": "840.98",
+ "bstp_nmix_oprc": "839.46",
+ "bstp_nmix_hgpr": "841.17",
+ "bstp_nmix_lwpr": "839.46",
+ "cntg_vol": "20366",
+ "acml_tr_pbmn": "1234692"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "090400",
+ "bstp_nmix_prpr": "839.42",
+ "bstp_nmix_oprc": "836.70",
+ "bstp_nmix_hgpr": "839.42",
+ "bstp_nmix_lwpr": "836.70",
+ "cntg_vol": "27395",
+ "acml_tr_pbmn": "1007681"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "090200",
+ "bstp_nmix_prpr": "836.69",
+ "bstp_nmix_oprc": "838.54",
+ "bstp_nmix_hgpr": "838.54",
+ "bstp_nmix_lwpr": "835.19",
+ "cntg_vol": "31941",
+ "acml_tr_pbmn": "754939"
+ },
+ {
+ "stck_bsop_date": "20240129",
+ "stck_cntg_hour": "090000",
+ "bstp_nmix_prpr": "838.62",
+ "bstp_nmix_oprc": "841.21",
+ "bstp_nmix_hgpr": "841.21",
+ "bstp_nmix_lwpr": "838.42",
+ "cntg_vol": "33919",
+ "acml_tr_pbmn": "422108"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "999999",
+ "bstp_nmix_prpr": "837.24",
+ "bstp_nmix_oprc": "837.24",
+ "bstp_nmix_hgpr": "837.24",
+ "bstp_nmix_lwpr": "837.24",
+ "cntg_vol": "21566",
+ "acml_tr_pbmn": "11242548"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "888888",
+ "bstp_nmix_prpr": "837.24",
+ "bstp_nmix_oprc": "837.24",
+ "bstp_nmix_hgpr": "837.24",
+ "bstp_nmix_lwpr": "837.24",
+ "cntg_vol": "42",
+ "acml_tr_pbmn": "11058431"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "153200",
+ "bstp_nmix_prpr": "837.20",
+ "bstp_nmix_oprc": "837.19",
+ "bstp_nmix_hgpr": "837.20",
+ "bstp_nmix_lwpr": "837.19",
+ "cntg_vol": "126",
+ "acml_tr_pbmn": "11057509"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "153000",
+ "bstp_nmix_prpr": "837.19",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "837.25",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "17043",
+ "acml_tr_pbmn": "11056788"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "152800",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.97",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "10792443"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "152600",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.97",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "10792443"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "152400",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.97",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "10792443"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "152200",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.97",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "0",
+ "acml_tr_pbmn": "10792443"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "152000",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.97",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "1000",
+ "acml_tr_pbmn": "10792443"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "151800",
+ "bstp_nmix_prpr": "837.01",
+ "bstp_nmix_oprc": "836.79",
+ "bstp_nmix_hgpr": "837.05",
+ "bstp_nmix_lwpr": "836.49",
+ "cntg_vol": "8328",
+ "acml_tr_pbmn": "10784186"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "151600",
+ "bstp_nmix_prpr": "836.90",
+ "bstp_nmix_oprc": "836.72",
+ "bstp_nmix_hgpr": "836.93",
+ "bstp_nmix_lwpr": "836.64",
+ "cntg_vol": "6227",
+ "acml_tr_pbmn": "10699895"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "151400",
+ "bstp_nmix_prpr": "836.86",
+ "bstp_nmix_oprc": "836.63",
+ "bstp_nmix_hgpr": "836.96",
+ "bstp_nmix_lwpr": "836.57",
+ "cntg_vol": "5728",
+ "acml_tr_pbmn": "10633883"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "151200",
+ "bstp_nmix_prpr": "836.70",
+ "bstp_nmix_oprc": "836.71",
+ "bstp_nmix_hgpr": "836.84",
+ "bstp_nmix_lwpr": "836.44",
+ "cntg_vol": "6163",
+ "acml_tr_pbmn": "10578452"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "151000",
+ "bstp_nmix_prpr": "836.83",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "836.98",
+ "bstp_nmix_lwpr": "836.69",
+ "cntg_vol": "4617",
+ "acml_tr_pbmn": "10523064"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "150800",
+ "bstp_nmix_prpr": "836.92",
+ "bstp_nmix_oprc": "836.97",
+ "bstp_nmix_hgpr": "837.02",
+ "bstp_nmix_lwpr": "836.70",
+ "cntg_vol": "4728",
+ "acml_tr_pbmn": "10472083"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "150600",
+ "bstp_nmix_prpr": "836.97",
+ "bstp_nmix_oprc": "836.70",
+ "bstp_nmix_hgpr": "837.06",
+ "bstp_nmix_lwpr": "836.70",
+ "cntg_vol": "4719",
+ "acml_tr_pbmn": "10420811"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "150400",
+ "bstp_nmix_prpr": "836.66",
+ "bstp_nmix_oprc": "836.19",
+ "bstp_nmix_hgpr": "836.92",
+ "bstp_nmix_lwpr": "836.19",
+ "cntg_vol": "4377",
+ "acml_tr_pbmn": "10372366"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "150200",
+ "bstp_nmix_prpr": "836.29",
+ "bstp_nmix_oprc": "836.18",
+ "bstp_nmix_hgpr": "836.38",
+ "bstp_nmix_lwpr": "836.18",
+ "cntg_vol": "4261",
+ "acml_tr_pbmn": "10320188"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "150000",
+ "bstp_nmix_prpr": "836.28",
+ "bstp_nmix_oprc": "836.24",
+ "bstp_nmix_hgpr": "836.44",
+ "bstp_nmix_lwpr": "836.20",
+ "cntg_vol": "4420",
+ "acml_tr_pbmn": "10273218"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "145800",
+ "bstp_nmix_prpr": "836.43",
+ "bstp_nmix_oprc": "837.13",
+ "bstp_nmix_hgpr": "837.18",
+ "bstp_nmix_lwpr": "836.43",
+ "cntg_vol": "4215",
+ "acml_tr_pbmn": "10218137"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "145600",
+ "bstp_nmix_prpr": "837.23",
+ "bstp_nmix_oprc": "837.95",
+ "bstp_nmix_hgpr": "838.01",
+ "bstp_nmix_lwpr": "837.23",
+ "cntg_vol": "4978",
+ "acml_tr_pbmn": "10166106"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "145400",
+ "bstp_nmix_prpr": "837.89",
+ "bstp_nmix_oprc": "837.66",
+ "bstp_nmix_hgpr": "837.96",
+ "bstp_nmix_lwpr": "837.66",
+ "cntg_vol": "5102",
+ "acml_tr_pbmn": "10110923"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "145200",
+ "bstp_nmix_prpr": "837.66",
+ "bstp_nmix_oprc": "837.41",
+ "bstp_nmix_hgpr": "837.66",
+ "bstp_nmix_lwpr": "837.22",
+ "cntg_vol": "3840",
+ "acml_tr_pbmn": "10055054"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "145000",
+ "bstp_nmix_prpr": "837.58",
+ "bstp_nmix_oprc": "837.24",
+ "bstp_nmix_hgpr": "837.71",
+ "bstp_nmix_lwpr": "837.24",
+ "cntg_vol": "4172",
+ "acml_tr_pbmn": "10008690"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "144800",
+ "bstp_nmix_prpr": "837.37",
+ "bstp_nmix_oprc": "837.80",
+ "bstp_nmix_hgpr": "837.80",
+ "bstp_nmix_lwpr": "837.23",
+ "cntg_vol": "4593",
+ "acml_tr_pbmn": "9966720"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "144600",
+ "bstp_nmix_prpr": "837.66",
+ "bstp_nmix_oprc": "837.72",
+ "bstp_nmix_hgpr": "837.89",
+ "bstp_nmix_lwpr": "837.61",
+ "cntg_vol": "5105",
+ "acml_tr_pbmn": "9916624"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "144400",
+ "bstp_nmix_prpr": "837.72",
+ "bstp_nmix_oprc": "837.55",
+ "bstp_nmix_hgpr": "837.72",
+ "bstp_nmix_lwpr": "837.42",
+ "cntg_vol": "4214",
+ "acml_tr_pbmn": "9861241"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "144200",
+ "bstp_nmix_prpr": "837.50",
+ "bstp_nmix_oprc": "837.55",
+ "bstp_nmix_hgpr": "837.68",
+ "bstp_nmix_lwpr": "837.35",
+ "cntg_vol": "3357",
+ "acml_tr_pbmn": "9819268"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "144000",
+ "bstp_nmix_prpr": "837.56",
+ "bstp_nmix_oprc": "837.93",
+ "bstp_nmix_hgpr": "838.04",
+ "bstp_nmix_lwpr": "837.56",
+ "cntg_vol": "3515",
+ "acml_tr_pbmn": "9783824"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "143800",
+ "bstp_nmix_prpr": "837.96",
+ "bstp_nmix_oprc": "837.49",
+ "bstp_nmix_hgpr": "837.96",
+ "bstp_nmix_lwpr": "837.49",
+ "cntg_vol": "4026",
+ "acml_tr_pbmn": "9745091"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "143600",
+ "bstp_nmix_prpr": "837.50",
+ "bstp_nmix_oprc": "837.47",
+ "bstp_nmix_hgpr": "837.59",
+ "bstp_nmix_lwpr": "837.25",
+ "cntg_vol": "4327",
+ "acml_tr_pbmn": "9702397"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "143400",
+ "bstp_nmix_prpr": "837.44",
+ "bstp_nmix_oprc": "837.19",
+ "bstp_nmix_hgpr": "837.44",
+ "bstp_nmix_lwpr": "836.97",
+ "cntg_vol": "3352",
+ "acml_tr_pbmn": "9664056"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "143200",
+ "bstp_nmix_prpr": "837.19",
+ "bstp_nmix_oprc": "837.00",
+ "bstp_nmix_hgpr": "837.19",
+ "bstp_nmix_lwpr": "836.85",
+ "cntg_vol": "3969",
+ "acml_tr_pbmn": "9626091"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "143000",
+ "bstp_nmix_prpr": "836.85",
+ "bstp_nmix_oprc": "836.27",
+ "bstp_nmix_hgpr": "836.85",
+ "bstp_nmix_lwpr": "836.10",
+ "cntg_vol": "4263",
+ "acml_tr_pbmn": "9584077"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "142800",
+ "bstp_nmix_prpr": "836.18",
+ "bstp_nmix_oprc": "835.52",
+ "bstp_nmix_hgpr": "836.24",
+ "bstp_nmix_lwpr": "835.52",
+ "cntg_vol": "4294",
+ "acml_tr_pbmn": "9542286"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "142600",
+ "bstp_nmix_prpr": "835.62",
+ "bstp_nmix_oprc": "835.41",
+ "bstp_nmix_hgpr": "835.66",
+ "bstp_nmix_lwpr": "835.41",
+ "cntg_vol": "3538",
+ "acml_tr_pbmn": "9501271"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "142400",
+ "bstp_nmix_prpr": "835.44",
+ "bstp_nmix_oprc": "835.54",
+ "bstp_nmix_hgpr": "835.68",
+ "bstp_nmix_lwpr": "835.37",
+ "cntg_vol": "3291",
+ "acml_tr_pbmn": "9469724"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "142200",
+ "bstp_nmix_prpr": "835.48",
+ "bstp_nmix_oprc": "835.60",
+ "bstp_nmix_hgpr": "835.60",
+ "bstp_nmix_lwpr": "835.28",
+ "cntg_vol": "3640",
+ "acml_tr_pbmn": "9433016"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "142000",
+ "bstp_nmix_prpr": "835.70",
+ "bstp_nmix_oprc": "835.57",
+ "bstp_nmix_hgpr": "835.72",
+ "bstp_nmix_lwpr": "835.51",
+ "cntg_vol": "4522",
+ "acml_tr_pbmn": "9401939"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "141800",
+ "bstp_nmix_prpr": "835.54",
+ "bstp_nmix_oprc": "835.99",
+ "bstp_nmix_hgpr": "836.00",
+ "bstp_nmix_lwpr": "835.34",
+ "cntg_vol": "3266",
+ "acml_tr_pbmn": "9365741"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "141600",
+ "bstp_nmix_prpr": "835.98",
+ "bstp_nmix_oprc": "836.29",
+ "bstp_nmix_hgpr": "836.37",
+ "bstp_nmix_lwpr": "835.98",
+ "cntg_vol": "4813",
+ "acml_tr_pbmn": "9334612"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "141400",
+ "bstp_nmix_prpr": "836.34",
+ "bstp_nmix_oprc": "835.77",
+ "bstp_nmix_hgpr": "836.34",
+ "bstp_nmix_lwpr": "835.77",
+ "cntg_vol": "4714",
+ "acml_tr_pbmn": "9284831"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "141200",
+ "bstp_nmix_prpr": "835.79",
+ "bstp_nmix_oprc": "835.74",
+ "bstp_nmix_hgpr": "835.98",
+ "bstp_nmix_lwpr": "835.58",
+ "cntg_vol": "4125",
+ "acml_tr_pbmn": "9238577"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "141000",
+ "bstp_nmix_prpr": "835.74",
+ "bstp_nmix_oprc": "835.45",
+ "bstp_nmix_hgpr": "835.74",
+ "bstp_nmix_lwpr": "835.45",
+ "cntg_vol": "4232",
+ "acml_tr_pbmn": "9193950"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "140800",
+ "bstp_nmix_prpr": "835.10",
+ "bstp_nmix_oprc": "835.07",
+ "bstp_nmix_hgpr": "835.32",
+ "bstp_nmix_lwpr": "835.00",
+ "cntg_vol": "3639",
+ "acml_tr_pbmn": "9151925"
+ },
+ {
+ "stck_bsop_date": "20240126",
+ "stck_cntg_hour": "140600",
+ "bstp_nmix_prpr": "835.10",
+ "bstp_nmix_oprc": "835.09",
+ "bstp_nmix_hgpr": "835.23",
+ "bstp_nmix_lwpr": "834.96",
+ "cntg_vol": "4277",
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/075_국내주식-040_국내휴장일조회.md b/docs/broker/kis/rest/국내주식/업종/기타/075_국내주식-040_국내휴장일조회.md
new file mode 100644
index 0000000..b32ddac
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/075_국내주식-040_국내휴장일조회.md
@@ -0,0 +1,293 @@
+# 국내휴장일조회
+
+- 원본 시트명: 국내휴장일조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-040
+- HTTP Method: GET
+- 실전 TR_ID: CTCA0903R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/chk-holiday
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(★중요) 국내휴장일조회(TCA0903R) 서비스는 당사 원장서비스와 연관되어 있어
+단시간 내 다수 호출시 서비스에 영향을 줄 수 있어 가급적 1일 1회 호출 부탁드립니다.
+
+국내휴장일조회 API입니다.
+영업일, 거래일, 개장일, 결제일 여부를 조회할 수 있습니다.
+주문을 넣을 수 있는지 확인하고자 하실 경우 개장일여부(opnd_yn)을 사용하시면 됩니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTCA0903R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| BASS_DT | 기준일자 | string | Y | 8 | 기준일자(YYYYMMDD) |
+| CTX_AREA_NK | 연속조회키 | string | Y | 20 | 공백으로 입력 |
+| CTX_AREA_FK | 연속조회검색조건 | string | Y | 20 | 공백으로 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| bass_dt | 기준일자 | string | Y | 8 | 기준일자(YYYYMMDD) |
+| wday_dvsn_cd | 요일구분코드 | string | Y | 2 | 01:일요일, 02:월요일, 03:화요일, 04:수요일, 05:목요일, 06:금요일, 07:토요일 |
+| bzdy_yn | 영업일여부 | string | Y | 1 | Y/N
금융기관이 업무를 하는 날 |
+| tr_day_yn | 거래일여부 | string | Y | 1 | Y/N
증권 업무가 가능한 날(입출금, 이체 등의 업무 포함) |
+| opnd_yn | 개장일여부 | string | Y | 1 | Y/N
주식시장이 개장되는 날
* 주문을 넣고자 할 경우 개장일여부(opnd_yn)를 사용 |
+| sttl_day_yn | 결제일여부 | string | Y | 1 | Y/N
주식 거래에서 실제로 주식을 인수하고 돈을 지불하는 날 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "BASS_DT":"20221227",
+ "CTX_AREA_NK":"",
+ "CTX_AREA_FK":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk": "20230119 ",
+ "ctx_area_fk": "20221227 ",
+ "output": [
+ {
+ "bass_dt": "20221227",
+ "wday_dvsn_cd": "03",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20221228",
+ "wday_dvsn_cd": "04",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20221229",
+ "wday_dvsn_cd": "05",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20221230",
+ "wday_dvsn_cd": "06",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20221231",
+ "wday_dvsn_cd": "07",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230101",
+ "wday_dvsn_cd": "01",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230102",
+ "wday_dvsn_cd": "02",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230103",
+ "wday_dvsn_cd": "03",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230104",
+ "wday_dvsn_cd": "04",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230105",
+ "wday_dvsn_cd": "05",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230106",
+ "wday_dvsn_cd": "06",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230107",
+ "wday_dvsn_cd": "07",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230108",
+ "wday_dvsn_cd": "01",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230109",
+ "wday_dvsn_cd": "02",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230110",
+ "wday_dvsn_cd": "03",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230111",
+ "wday_dvsn_cd": "04",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230112",
+ "wday_dvsn_cd": "05",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230113",
+ "wday_dvsn_cd": "06",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230114",
+ "wday_dvsn_cd": "07",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230115",
+ "wday_dvsn_cd": "01",
+ "bzdy_yn": "N",
+ "tr_day_yn": "Y",
+ "opnd_yn": "N",
+ "sttl_day_yn": "N"
+ },
+ {
+ "bass_dt": "20230116",
+ "wday_dvsn_cd": "02",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230117",
+ "wday_dvsn_cd": "03",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230118",
+ "wday_dvsn_cd": "04",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ },
+ {
+ "bass_dt": "20230119",
+ "wday_dvsn_cd": "05",
+ "bzdy_yn": "Y",
+ "tr_day_yn": "Y",
+ "opnd_yn": "Y",
+ "sttl_day_yn": "Y"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0500",
+ "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오. "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/076_국내주식-122_국내주식-예상체결-전체지수.md b/docs/broker/kis/rest/국내주식/업종/기타/076_국내주식-122_국내주식-예상체결-전체지수.md
new file mode 100644
index 0000000..29f9dc4
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/076_국내주식-122_국내주식-예상체결-전체지수.md
@@ -0,0 +1,448 @@
+# 국내주식 예상체결 전체지수
+
+- 원본 시트명: 국내주식 예상체결 전체지수
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-122
+- HTTP Method: GET
+- 실전 TR_ID: FHKUP11750000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/exp-total-index
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예상체결 전체지수 API입니다.
+한국투자 HTS(eFriend Plus) > [0185] 예상체결 전체지수 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKUP11750000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_mrkt_cls_code | 시장 구분 코드 | string | Y | 2 | 0:전체 K:거래소 Q:코스닥 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11175) |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_mkop_cls_code | 장운영 구분 코드 | string | Y | 2 | 1:장시작전, 2:장마감 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 7 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 7 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 7 | |
+| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| nmix_sdpr | 지수 기준가 | string | Y | 112 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 7 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 7 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 7 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"U",
+"fid_cond_scr_div_code":"11175",
+"fid_input_iscd":"1001",
+"fid_mkop_cls_code":"1",
+"fid_mrkt_cls_code":"K"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "bstp_nmix_prpr": "883.03",
+ "bstp_nmix_prdy_vrss": "2.57",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.29",
+ "acml_vol": "10611",
+ "ascn_issu_cnt": "513",
+ "down_issu_cnt": "571",
+ "stnr_issu_cnt": "498"
+ },
+ "output2": [
+ {
+ "bstp_cls_code": "0001",
+ "hts_kor_isnm": "종합",
+ "bstp_nmix_prpr": "2676.62",
+ "bstp_nmix_prdy_vrss": "9.78",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.37",
+ "acml_vol": "5151",
+ "nmix_sdpr": "2666.84",
+ "ascn_issu_cnt": "409",
+ "stnr_issu_cnt": "249",
+ "down_issu_cnt": "225"
+ },
+ {
+ "bstp_cls_code": "2001",
+ "hts_kor_isnm": "KOSPI200",
+ "bstp_nmix_prpr": "360.44",
+ "bstp_nmix_prdy_vrss": "1.05",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.29",
+ "acml_vol": "1687",
+ "nmix_sdpr": "359.39",
+ "ascn_issu_cnt": "148",
+ "stnr_issu_cnt": "35",
+ "down_issu_cnt": "17"
+ },
+ {
+ "bstp_cls_code": "2039",
+ "hts_kor_isnm": "K커뮤니케이션서비스",
+ "bstp_nmix_prpr": "1766.78",
+ "bstp_nmix_prdy_vrss": "9.03",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.51",
+ "acml_vol": "42",
+ "nmix_sdpr": "1757.75",
+ "ascn_issu_cnt": "7",
+ "stnr_issu_cnt": "2",
+ "down_issu_cnt": "1"
+ },
+ {
+ "bstp_cls_code": "2009",
+ "hts_kor_isnm": "K건설",
+ "bstp_nmix_prpr": "320.87",
+ "bstp_nmix_prdy_vrss": "0.09",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.03",
+ "acml_vol": "76",
+ "nmix_sdpr": "320.78",
+ "ascn_issu_cnt": "3",
+ "stnr_issu_cnt": "6",
+ "down_issu_cnt": "1"
+ },
+ {
+ "bstp_cls_code": "2010",
+ "hts_kor_isnm": "K중공업",
+ "bstp_nmix_prpr": "366.27",
+ "bstp_nmix_prdy_vrss": "5.35",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.48",
+ "acml_vol": "457",
+ "nmix_sdpr": "360.92",
+ "ascn_issu_cnt": "12",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "1"
+ },
+ {
+ "bstp_cls_code": "2011",
+ "hts_kor_isnm": "K철강소재",
+ "bstp_nmix_prpr": "857.19",
+ "bstp_nmix_prdy_vrss": "6.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.75",
+ "acml_vol": "45",
+ "nmix_sdpr": "850.85",
+ "ascn_issu_cnt": "7",
+ "stnr_issu_cnt": "3",
+ "down_issu_cnt": "1"
+ },
+ {
+ "bstp_cls_code": "2012",
+ "hts_kor_isnm": "K에너지화학",
+ "bstp_nmix_prpr": "1349.16",
+ "bstp_nmix_prdy_vrss": "8.62",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.64",
+ "acml_vol": "33",
+ "nmix_sdpr": "1340.54",
+ "ascn_issu_cnt": "22",
+ "stnr_issu_cnt": "4",
+ "down_issu_cnt": "2"
+ },
+ {
+ "bstp_cls_code": "2013",
+ "hts_kor_isnm": "K정보기술",
+ "bstp_nmix_prpr": "3334.19",
+ "bstp_nmix_prdy_vrss": "3.80",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.11",
+ "acml_vol": "546",
+ "nmix_sdpr": "3330.39",
+ "ascn_issu_cnt": "8",
+ "stnr_issu_cnt": "3",
+ "down_issu_cnt": "2"
+ },
+ {
+ "bstp_cls_code": "2014",
+ "hts_kor_isnm": "K금융",
+ "bstp_nmix_prpr": "832.71",
+ "bstp_nmix_prdy_vrss": "-2.77",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-0.33",
+ "acml_vol": "208",
+ "nmix_sdpr": "835.48",
+ "ascn_issu_cnt": "12",
+ "stnr_issu_cnt": "7",
+ "down_issu_cnt": "3"
+ },
+ {
+ "bstp_cls_code": "2015",
+ "hts_kor_isnm": "K생활소비재",
+ "bstp_nmix_prpr": "807.22",
+ "bstp_nmix_prdy_vrss": "5.94",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.74",
+ "acml_vol": "39",
+ "nmix_sdpr": "801.28",
+ "ascn_issu_cnt": "20",
+ "stnr_issu_cnt": "3",
+ "down_issu_cnt": "1"
+ },
+ {
+ "bstp_cls_code": "2016",
+ "hts_kor_isnm": "K경기소비재",
+ "bstp_nmix_prpr": "1771.78",
+ "bstp_nmix_prdy_vrss": "9.87",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.56",
+ "acml_vol": "71",
+ "nmix_sdpr": "1761.91",
+ "ascn_issu_cnt": "26",
+ "stnr_issu_cnt": "4",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2017",
+ "hts_kor_isnm": "K산업재",
+ "bstp_nmix_prpr": "638.85",
+ "bstp_nmix_prdy_vrss": "3.52",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.55",
+ "acml_vol": "144",
+ "nmix_sdpr": "635.33",
+ "ascn_issu_cnt": "19",
+ "stnr_issu_cnt": "1",
+ "down_issu_cnt": "3"
+ },
+ {
+ "bstp_cls_code": "2018",
+ "hts_kor_isnm": "K헬스케어",
+ "bstp_nmix_prpr": "1880.59",
+ "bstp_nmix_prdy_vrss": "7.50",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.40",
+ "acml_vol": "25",
+ "nmix_sdpr": "1873.09",
+ "ascn_issu_cnt": "12",
+ "stnr_issu_cnt": "2",
+ "down_issu_cnt": "2"
+ },
+ {
+ "bstp_cls_code": "0163",
+ "hts_kor_isnm": "고배당50",
+ "bstp_nmix_prpr": "3012.54",
+ "bstp_nmix_prdy_vrss": "2.40",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.08",
+ "acml_vol": "654",
+ "nmix_sdpr": "3010.14",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "0164",
+ "hts_kor_isnm": "배당성장50",
+ "bstp_nmix_prpr": "3697.71",
+ "bstp_nmix_prdy_vrss": "14.09",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.38",
+ "acml_vol": "557",
+ "nmix_sdpr": "3683.62",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "0165",
+ "hts_kor_isnm": "우선주",
+ "bstp_nmix_prpr": "3159.80",
+ "bstp_nmix_prdy_vrss": "3.00",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.10",
+ "acml_vol": "27",
+ "nmix_sdpr": "3156.80",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2180",
+ "hts_kor_isnm": "코스피 200 ESG 지수",
+ "bstp_nmix_prpr": "408.37",
+ "bstp_nmix_prdy_vrss": "0.89",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.22",
+ "acml_vol": "1068",
+ "nmix_sdpr": "407.48",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2040",
+ "hts_kor_isnm": "코스피200 초대형 제외지수",
+ "bstp_nmix_prpr": "261.99",
+ "bstp_nmix_prdy_vrss": "0.79",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.30",
+ "acml_vol": "1276",
+ "nmix_sdpr": "261.20",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2037",
+ "hts_kor_isnm": "코스피200 예측 고배당 50",
+ "bstp_nmix_prpr": "2034.64",
+ "bstp_nmix_prdy_vrss": "7.50",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.37",
+ "acml_vol": "227",
+ "nmix_sdpr": "2027.14",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2038",
+ "hts_kor_isnm": "코스피200 예측 배당성장 50",
+ "bstp_nmix_prpr": "1710.41",
+ "bstp_nmix_prdy_vrss": "9.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.53",
+ "acml_vol": "581",
+ "nmix_sdpr": "1701.33",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2224",
+ "hts_kor_isnm": "K200 비중상한 30%",
+ "bstp_nmix_prpr": "360.08",
+ "bstp_nmix_prdy_vrss": "1.06",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.30",
+ "acml_vol": "1687",
+ "nmix_sdpr": "359.02",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2227",
+ "hts_kor_isnm": "K200 비중상한 25%",
+ "bstp_nmix_prpr": "356.69",
+ "bstp_nmix_prdy_vrss": "1.04",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.29",
+ "acml_vol": "1687",
+ "nmix_sdpr": "355.65",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2232",
+ "hts_kor_isnm": "K200 비중상한 20%",
+ "bstp_nmix_prpr": "346.65",
+ "bstp_nmix_prdy_vrss": "1.02",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.30",
+ "acml_vol": "1687",
+ "nmix_sdpr": "345.63",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "0244",
+ "hts_kor_isnm": "코스피200제외 코스피지수",
+ "bstp_nmix_prpr": "3337.06",
+ "bstp_nmix_prdy_vrss": "10.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.31",
+ "acml_vol": "3373",
+ "nmix_sdpr": "3326.72",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ },
+ {
+ "bstp_cls_code": "2283",
+ "hts_kor_isnm": "코스피 200 기후변화지수",
+ "bstp_nmix_prpr": "1580.49",
+ "bstp_nmix_prdy_vrss": "4.56",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "0.29",
+ "acml_vol": "1639",
+ "nmix_sdpr": "1575.93",
+ "ascn_issu_cnt": "0",
+ "stnr_issu_cnt": "0",
+ "down_issu_cnt": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/077_v1_국내주식-063_국내업종-현재지수.md b/docs/broker/kis/rest/국내주식/업종/기타/077_v1_국내주식-063_국내업종-현재지수.md
new file mode 100644
index 0000000..2646cec
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/077_v1_국내주식-063_국내업종-현재지수.md
@@ -0,0 +1,159 @@
+# 국내업종 현재지수
+
+- 원본 시트명: 국내업종 현재지수
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-063
+- HTTP Method: GET
+- 실전 TR_ID: FHPUP02100000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-index-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 현재지수 API입니다.
+한국투자 HTS(eFriend Plus) > [0210] 업종 현재지수 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPUP02100000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | 업종(U) |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 코스피(0001), 코스닥(1001), 코스피200(2001)
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| prdy_tr_pbmn | 전일 거래 대금 | string | Y | 18 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| prdy_nmix_vrss_nmix_oprc | 전일 지수 대비 지수 시가2 | string | Y | 112 | |
+| oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | string | Y | 1 | |
+| bstp_nmix_oprc_prdy_ctrt | 업종 지수 시가2 전일 대비율 | string | Y | 82 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| prdy_nmix_vrss_nmix_hgpr | 전일 지수 대비 지수 최고가 | string | Y | 112 | |
+| hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | string | Y | 1 | |
+| bstp_nmix_hgpr_prdy_ctrt | 업종 지수 최고가 전일 대비율 | string | Y | 82 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| prdy_clpr_vrss_lwpr | 전일 종가 대비 최저가 | string | Y | 10 | |
+| lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | string | Y | 1 | |
+| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 84 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 7 | |
+| uplm_issu_cnt | 상한 종목 수 | string | Y | 7 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 7 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 7 | |
+| lslm_issu_cnt | 하한 종목 수 | string | Y | 7 | |
+| dryy_bstp_nmix_hgpr | 연중업종지수최고가 | string | Y | 112 | |
+| dryy_hgpr_vrss_prpr_rate | 연중 최고가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_bstp_nmix_hgpr_date | 연중업종지수최고가일자 | string | Y | 8 | |
+| dryy_bstp_nmix_lwpr | 연중업종지수최저가 | string | Y | 112 | |
+| dryy_lwpr_vrss_prpr_rate | 연중 최저가 대비 현재가 비율 | string | Y | 84 | |
+| dryy_bstp_nmix_lwpr_date | 연중업종지수최저가일자 | string | Y | 8 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| seln_rsqn_rate | 매도 잔량 비율 | string | Y | 84 | |
+| shnu_rsqn_rate | 매수2 잔량 비율 | string | Y | 84 | |
+| ntby_rsqn | 순매수 잔량 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"U"
+"fid_input_iscd":"1001"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "bstp_nmix_prpr": "857.60",
+ "bstp_nmix_prdy_vrss": "-1.61",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_ctrt": "-0.19",
+ "acml_vol": "1312496",
+ "prdy_vol": "1222188",
+ "acml_tr_pbmn": "11507962",
+ "prdy_tr_pbmn": "11203385",
+ "bstp_nmix_oprc": "863.69",
+ "prdy_nmix_vrss_nmix_oprc": "4.48",
+ "oprc_vrss_prpr_sign": "2",
+ "bstp_nmix_oprc_prdy_ctrt": "0.52",
+ "bstp_nmix_hgpr": "864.24",
+ "prdy_nmix_vrss_nmix_hgpr": "5.03",
+ "hgpr_vrss_prpr_sign": "2",
+ "bstp_nmix_hgpr_prdy_ctrt": "0.59",
+ "bstp_nmix_lwpr": "854.72",
+ "prdy_clpr_vrss_lwpr": "-4.49",
+ "lwpr_vrss_prpr_sign": "5",
+ "prdy_clpr_vrss_lwpr_rate": "-0.52",
+ "ascn_issu_cnt": "828",
+ "uplm_issu_cnt": "5",
+ "stnr_issu_cnt": "94",
+ "down_issu_cnt": "716",
+ "lslm_issu_cnt": "1",
+ "dryy_bstp_nmix_hgpr": "890.06",
+ "dryy_hgpr_vrss_prpr_rate": "3.65",
+ "dryy_bstp_nmix_hgpr_date": "20240109",
+ "dryy_bstp_nmix_lwpr": "786.28",
+ "dryy_lwpr_vrss_prpr_rate": "-9.07",
+ "dryy_bstp_nmix_lwpr_date": "20240201",
+ "total_askp_rsqn": "24146999",
+ "total_bidp_rsqn": "40450437",
+ "seln_rsqn_rate": "37.38",
+ "shnu_rsqn_rate": "62.62",
+ "ntby_rsqn": "16303438"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/078_국내주식-160_국내선물-영업일조회.md b/docs/broker/kis/rest/국내주식/업종/기타/078_국내주식-160_국내선물-영업일조회.md
new file mode 100644
index 0000000..0a36c2d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/078_국내주식-160_국내선물-영업일조회.md
@@ -0,0 +1,100 @@
+# 국내선물 영업일조회
+
+- 원본 시트명: 국내선물 영업일조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-160
+- HTTP Method: GET
+- 실전 TR_ID: HHMCM000002C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/market-time
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내선물 영업일조회 API입니다.
+한국투자 HTS(eFriend Plus) > [1938] 시가총액순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+API호출 시 body 혹은 params로 입력하는 사항이 없습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHMCM000002C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+없음
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| date1 | 영업일1 | string | Y | 8 | |
+| date2 | 영업일2 | string | Y | 8 | |
+| date3 | 영업일3 | string | Y | 8 | 영업일 당일 |
+| date4 | 영업일4 | string | Y | 8 | |
+| date5 | 영업일5 | string | Y | 8 | |
+| today | 오늘일자 | string | Y | 8 | |
+| time | 현재시간 | string | Y | 6 | |
+| s_time | 장시작시간 | string | Y | 6 | |
+| e_time | 장마감시간 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+없음
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "date1": "20240909",
+ "date2": "20240910",
+ "date3": "20240911",
+ "date4": "20240912",
+ "date5": "20240913",
+ "today": "20240911",
+ "time": "083523",
+ "s_time": "084500",
+ "e_time": "154500"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/079_국내주식-064_국내업종-시간별지수초.md b/docs/broker/kis/rest/국내주식/업종/기타/079_국내주식-064_국내업종-시간별지수초.md
new file mode 100644
index 0000000..97da70b
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/079_국내주식-064_국내업종-시간별지수초.md
@@ -0,0 +1,1054 @@
+# 국내업종 시간별지수(초)
+
+- 원본 시트명: 국내업종 시간별지수(초)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-064
+- HTTP Method: GET
+- 실전 TR_ID: FHPUP02110100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-index-tickprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 시간별지수(초) API입니다.
+한국투자 HTS(eFriend Plus) > [0211] 업종 시간별지수 화면에서 우측 '10초' 선택 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPUP02110100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0001:거래소, 1001:코스닥, 2001:코스피200, 3003:KSQ150 |
+| FID_COND_MRKT_DIV_CODE | 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+fid_cond_mrkt_div_code:U
+fid_input_iscd:1001
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "100520",
+ "bstp_nmix_prpr": "916.59",
+ "bstp_nmix_prdy_vrss": "11.09",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.22",
+ "acml_tr_pbmn": "3818437",
+ "acml_vol": "311514",
+ "cntg_vol": "378"
+ },
+ {
+ "stck_cntg_hour": "100510",
+ "bstp_nmix_prpr": "916.56",
+ "bstp_nmix_prdy_vrss": "11.06",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.22",
+ "acml_tr_pbmn": "3814862",
+ "acml_vol": "311136",
+ "cntg_vol": "389"
+ },
+ {
+ "stck_cntg_hour": "100500",
+ "bstp_nmix_prpr": "916.60",
+ "bstp_nmix_prdy_vrss": "11.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3811191",
+ "acml_vol": "310747",
+ "cntg_vol": "460"
+ },
+ {
+ "stck_cntg_hour": "100450",
+ "bstp_nmix_prpr": "916.71",
+ "bstp_nmix_prdy_vrss": "11.21",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3806215",
+ "acml_vol": "310287",
+ "cntg_vol": "347"
+ },
+ {
+ "stck_cntg_hour": "100440",
+ "bstp_nmix_prpr": "916.71",
+ "bstp_nmix_prdy_vrss": "11.21",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3802603",
+ "acml_vol": "309940",
+ "cntg_vol": "378"
+ },
+ {
+ "stck_cntg_hour": "100430",
+ "bstp_nmix_prpr": "916.87",
+ "bstp_nmix_prdy_vrss": "11.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3798885",
+ "acml_vol": "309562",
+ "cntg_vol": "390"
+ },
+ {
+ "stck_cntg_hour": "100420",
+ "bstp_nmix_prpr": "916.87",
+ "bstp_nmix_prdy_vrss": "11.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3793980",
+ "acml_vol": "309172",
+ "cntg_vol": "331"
+ },
+ {
+ "stck_cntg_hour": "100410",
+ "bstp_nmix_prpr": "916.69",
+ "bstp_nmix_prdy_vrss": "11.19",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3789649",
+ "acml_vol": "308841",
+ "cntg_vol": "387"
+ },
+ {
+ "stck_cntg_hour": "100400",
+ "bstp_nmix_prpr": "916.47",
+ "bstp_nmix_prdy_vrss": "10.97",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3784355",
+ "acml_vol": "308454",
+ "cntg_vol": "302"
+ },
+ {
+ "stck_cntg_hour": "100350",
+ "bstp_nmix_prpr": "916.69",
+ "bstp_nmix_prdy_vrss": "11.19",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3779730",
+ "acml_vol": "308152",
+ "cntg_vol": "389"
+ },
+ {
+ "stck_cntg_hour": "100340",
+ "bstp_nmix_prpr": "916.64",
+ "bstp_nmix_prdy_vrss": "11.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3774584",
+ "acml_vol": "307763",
+ "cntg_vol": "359"
+ },
+ {
+ "stck_cntg_hour": "100330",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3769289",
+ "acml_vol": "307404",
+ "cntg_vol": "590"
+ },
+ {
+ "stck_cntg_hour": "100320",
+ "bstp_nmix_prpr": "916.86",
+ "bstp_nmix_prdy_vrss": "11.36",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3764728",
+ "acml_vol": "306814",
+ "cntg_vol": "395"
+ },
+ {
+ "stck_cntg_hour": "100310",
+ "bstp_nmix_prpr": "916.76",
+ "bstp_nmix_prdy_vrss": "11.26",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3758157",
+ "acml_vol": "306419",
+ "cntg_vol": "414"
+ },
+ {
+ "stck_cntg_hour": "100300",
+ "bstp_nmix_prpr": "917.03",
+ "bstp_nmix_prdy_vrss": "11.53",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3753915",
+ "acml_vol": "306005",
+ "cntg_vol": "351"
+ },
+ {
+ "stck_cntg_hour": "100250",
+ "bstp_nmix_prpr": "917.08",
+ "bstp_nmix_prdy_vrss": "11.58",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+ "acml_tr_pbmn": "3749232",
+ "acml_vol": "305654",
+ "cntg_vol": "440"
+ },
+ {
+ "stck_cntg_hour": "100240",
+ "bstp_nmix_prpr": "917.18",
+ "bstp_nmix_prdy_vrss": "11.68",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.29",
+ "acml_tr_pbmn": "3741905",
+ "acml_vol": "305214",
+ "cntg_vol": "324"
+ },
+ {
+ "stck_cntg_hour": "100230",
+ "bstp_nmix_prpr": "917.27",
+ "bstp_nmix_prdy_vrss": "11.77",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.30",
+ "acml_tr_pbmn": "3737983",
+ "acml_vol": "304890",
+ "cntg_vol": "449"
+ },
+ {
+ "stck_cntg_hour": "100220",
+ "bstp_nmix_prpr": "917.31",
+ "bstp_nmix_prdy_vrss": "11.81",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.30",
+ "acml_tr_pbmn": "3732890",
+ "acml_vol": "304441",
+ "cntg_vol": "459"
+ },
+ {
+ "stck_cntg_hour": "100210",
+ "bstp_nmix_prpr": "916.61",
+ "bstp_nmix_prdy_vrss": "11.11",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3725485",
+ "acml_vol": "303982",
+ "cntg_vol": "424"
+ },
+ {
+ "stck_cntg_hour": "100200",
+ "bstp_nmix_prpr": "916.64",
+ "bstp_nmix_prdy_vrss": "11.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3720969",
+ "acml_vol": "303558",
+ "cntg_vol": "365"
+ },
+ {
+ "stck_cntg_hour": "100150",
+ "bstp_nmix_prpr": "916.76",
+ "bstp_nmix_prdy_vrss": "11.26",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3716791",
+ "acml_vol": "303193",
+ "cntg_vol": "377"
+ },
+ {
+ "stck_cntg_hour": "100140",
+ "bstp_nmix_prpr": "916.49",
+ "bstp_nmix_prdy_vrss": "10.99",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3712492",
+ "acml_vol": "302816",
+ "cntg_vol": "392"
+ },
+ {
+ "stck_cntg_hour": "100130",
+ "bstp_nmix_prpr": "916.49",
+ "bstp_nmix_prdy_vrss": "10.99",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3707273",
+ "acml_vol": "302424",
+ "cntg_vol": "324"
+ },
+ {
+ "stck_cntg_hour": "100120",
+ "bstp_nmix_prpr": "916.60",
+ "bstp_nmix_prdy_vrss": "11.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3702465",
+ "acml_vol": "302100",
+ "cntg_vol": "430"
+ },
+ {
+ "stck_cntg_hour": "100110",
+ "bstp_nmix_prpr": "916.55",
+ "bstp_nmix_prdy_vrss": "11.05",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.22",
+ "acml_tr_pbmn": "3698004",
+ "acml_vol": "301670",
+ "cntg_vol": "387"
+ },
+ {
+ "stck_cntg_hour": "100100",
+ "bstp_nmix_prpr": "916.33",
+ "bstp_nmix_prdy_vrss": "10.83",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.20",
+ "acml_tr_pbmn": "3692560",
+ "acml_vol": "301283",
+ "cntg_vol": "428"
+ },
+ {
+ "stck_cntg_hour": "100050",
+ "bstp_nmix_prpr": "916.43",
+ "bstp_nmix_prdy_vrss": "10.93",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3687275",
+ "acml_vol": "300855",
+ "cntg_vol": "437"
+ },
+ {
+ "stck_cntg_hour": "100040",
+ "bstp_nmix_prpr": "916.79",
+ "bstp_nmix_prdy_vrss": "11.29",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3681346",
+ "acml_vol": "300418",
+ "cntg_vol": "465"
+ },
+ {
+ "stck_cntg_hour": "100030",
+ "bstp_nmix_prpr": "917.01",
+ "bstp_nmix_prdy_vrss": "11.51",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3676019",
+ "acml_vol": "299953",
+ "cntg_vol": "453"
+ },
+ {
+ "stck_cntg_hour": "100020",
+ "bstp_nmix_prpr": "916.77",
+ "bstp_nmix_prdy_vrss": "11.27",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3669136",
+ "acml_vol": "299500",
+ "cntg_vol": "443"
+ },
+ {
+ "stck_cntg_hour": "100010",
+ "bstp_nmix_prpr": "916.76",
+ "bstp_nmix_prdy_vrss": "11.26",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3663148",
+ "acml_vol": "299057",
+ "cntg_vol": "523"
+ },
+ {
+ "stck_cntg_hour": "100000",
+ "bstp_nmix_prpr": "916.49",
+ "bstp_nmix_prdy_vrss": "10.99",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3656614",
+ "acml_vol": "298534",
+ "cntg_vol": "444"
+ },
+ {
+ "stck_cntg_hour": "095950",
+ "bstp_nmix_prpr": "916.60",
+ "bstp_nmix_prdy_vrss": "11.10",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3651490",
+ "acml_vol": "298090",
+ "cntg_vol": "388"
+ },
+ {
+ "stck_cntg_hour": "095940",
+ "bstp_nmix_prpr": "916.84",
+ "bstp_nmix_prdy_vrss": "11.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3646864",
+ "acml_vol": "297702",
+ "cntg_vol": "446"
+ },
+ {
+ "stck_cntg_hour": "095930",
+ "bstp_nmix_prpr": "916.90",
+ "bstp_nmix_prdy_vrss": "11.40",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3642503",
+ "acml_vol": "297256",
+ "cntg_vol": "426"
+ },
+ {
+ "stck_cntg_hour": "095920",
+ "bstp_nmix_prpr": "917.04",
+ "bstp_nmix_prdy_vrss": "11.54",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3638580",
+ "acml_vol": "296830",
+ "cntg_vol": "493"
+ },
+ {
+ "stck_cntg_hour": "095910",
+ "bstp_nmix_prpr": "916.99",
+ "bstp_nmix_prdy_vrss": "11.49",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3634479",
+ "acml_vol": "296337",
+ "cntg_vol": "456"
+ },
+ {
+ "stck_cntg_hour": "095900",
+ "bstp_nmix_prpr": "917.02",
+ "bstp_nmix_prdy_vrss": "11.52",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3629148",
+ "acml_vol": "295881",
+ "cntg_vol": "602"
+ },
+ {
+ "stck_cntg_hour": "095850",
+ "bstp_nmix_prpr": "917.16",
+ "bstp_nmix_prdy_vrss": "11.66",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.29",
+ "acml_tr_pbmn": "3621794",
+ "acml_vol": "295279",
+ "cntg_vol": "652"
+ },
+ {
+ "stck_cntg_hour": "095840",
+ "bstp_nmix_prpr": "917.35",
+ "bstp_nmix_prdy_vrss": "11.85",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3616303",
+ "acml_vol": "294627",
+ "cntg_vol": "361"
+ },
+ {
+ "stck_cntg_hour": "095830",
+ "bstp_nmix_prpr": "917.33",
+ "bstp_nmix_prdy_vrss": "11.83",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3612169",
+ "acml_vol": "294266",
+ "cntg_vol": "454"
+ },
+ {
+ "stck_cntg_hour": "095820",
+ "bstp_nmix_prpr": "917.37",
+ "bstp_nmix_prdy_vrss": "11.87",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3607064",
+ "acml_vol": "293812",
+ "cntg_vol": "515"
+ },
+ {
+ "stck_cntg_hour": "095810",
+ "bstp_nmix_prpr": "917.32",
+ "bstp_nmix_prdy_vrss": "11.82",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3601548",
+ "acml_vol": "293297",
+ "cntg_vol": "545"
+ },
+ {
+ "stck_cntg_hour": "095800",
+ "bstp_nmix_prpr": "917.20",
+ "bstp_nmix_prdy_vrss": "11.70",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.29",
+ "acml_tr_pbmn": "3594204",
+ "acml_vol": "292752",
+ "cntg_vol": "394"
+ },
+ {
+ "stck_cntg_hour": "095750",
+ "bstp_nmix_prpr": "917.37",
+ "bstp_nmix_prdy_vrss": "11.87",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.31",
+ "acml_tr_pbmn": "3588380",
+ "acml_vol": "292358",
+ "cntg_vol": "392"
+ },
+ {
+ "stck_cntg_hour": "095740",
+ "bstp_nmix_prpr": "917.29",
+ "bstp_nmix_prdy_vrss": "11.79",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.30",
+ "acml_tr_pbmn": "3583543",
+ "acml_vol": "291966",
+ "cntg_vol": "383"
+ },
+ {
+ "stck_cntg_hour": "095730",
+ "bstp_nmix_prpr": "917.16",
+ "bstp_nmix_prdy_vrss": "11.66",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.29",
+ "acml_tr_pbmn": "3578536",
+ "acml_vol": "291583",
+ "cntg_vol": "372"
+ },
+ {
+ "stck_cntg_hour": "095720",
+ "bstp_nmix_prpr": "917.09",
+ "bstp_nmix_prdy_vrss": "11.59",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+ "acml_tr_pbmn": "3573648",
+ "acml_vol": "291211",
+ "cntg_vol": "387"
+ },
+ {
+ "stck_cntg_hour": "095710",
+ "bstp_nmix_prpr": "917.12",
+ "bstp_nmix_prdy_vrss": "11.62",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+ "acml_tr_pbmn": "3568052",
+ "acml_vol": "290824",
+ "cntg_vol": "481"
+ },
+ {
+ "stck_cntg_hour": "095700",
+ "bstp_nmix_prpr": "916.83",
+ "bstp_nmix_prdy_vrss": "11.33",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3562707",
+ "acml_vol": "290343",
+ "cntg_vol": "376"
+ },
+ {
+ "stck_cntg_hour": "095650",
+ "bstp_nmix_prpr": "916.72",
+ "bstp_nmix_prdy_vrss": "11.22",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3558237",
+ "acml_vol": "289967",
+ "cntg_vol": "457"
+ },
+ {
+ "stck_cntg_hour": "095640",
+ "bstp_nmix_prpr": "916.76",
+ "bstp_nmix_prdy_vrss": "11.26",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3552581",
+ "acml_vol": "289510",
+ "cntg_vol": "596"
+ },
+ {
+ "stck_cntg_hour": "095630",
+ "bstp_nmix_prpr": "917.30",
+ "bstp_nmix_prdy_vrss": "11.80",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.30",
+ "acml_tr_pbmn": "3544456",
+ "acml_vol": "288914",
+ "cntg_vol": "406"
+ },
+ {
+ "stck_cntg_hour": "095620",
+ "bstp_nmix_prpr": "917.51",
+ "bstp_nmix_prdy_vrss": "12.01",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.33",
+ "acml_tr_pbmn": "3538246",
+ "acml_vol": "288508",
+ "cntg_vol": "579"
+ },
+ {
+ "stck_cntg_hour": "095610",
+ "bstp_nmix_prpr": "917.52",
+ "bstp_nmix_prdy_vrss": "12.02",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.33",
+ "acml_tr_pbmn": "3532214",
+ "acml_vol": "287929",
+ "cntg_vol": "495"
+ },
+ {
+ "stck_cntg_hour": "095600",
+ "bstp_nmix_prpr": "917.61",
+ "bstp_nmix_prdy_vrss": "12.11",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_tr_pbmn": "3526666",
+ "acml_vol": "287434",
+ "cntg_vol": "407"
+ },
+ {
+ "stck_cntg_hour": "095550",
+ "bstp_nmix_prpr": "917.64",
+ "bstp_nmix_prdy_vrss": "12.14",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_tr_pbmn": "3521010",
+ "acml_vol": "287027",
+ "cntg_vol": "614"
+ },
+ {
+ "stck_cntg_hour": "095540",
+ "bstp_nmix_prpr": "917.58",
+ "bstp_nmix_prdy_vrss": "12.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.33",
+ "acml_tr_pbmn": "3514113",
+ "acml_vol": "286413",
+ "cntg_vol": "414"
+ },
+ {
+ "stck_cntg_hour": "095530",
+ "bstp_nmix_prpr": "917.70",
+ "bstp_nmix_prdy_vrss": "12.20",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.35",
+ "acml_tr_pbmn": "3507645",
+ "acml_vol": "285999",
+ "cntg_vol": "527"
+ },
+ {
+ "stck_cntg_hour": "095520",
+ "bstp_nmix_prpr": "917.44",
+ "bstp_nmix_prdy_vrss": "11.94",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.32",
+ "acml_tr_pbmn": "3501459",
+ "acml_vol": "285472",
+ "cntg_vol": "556"
+ },
+ {
+ "stck_cntg_hour": "095510",
+ "bstp_nmix_prpr": "917.61",
+ "bstp_nmix_prdy_vrss": "12.11",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_tr_pbmn": "3495215",
+ "acml_vol": "284916",
+ "cntg_vol": "584"
+ },
+ {
+ "stck_cntg_hour": "095500",
+ "bstp_nmix_prpr": "917.09",
+ "bstp_nmix_prdy_vrss": "11.59",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+ "acml_tr_pbmn": "3485132",
+ "acml_vol": "284332",
+ "cntg_vol": "657"
+ },
+ {
+ "stck_cntg_hour": "095450",
+ "bstp_nmix_prpr": "916.99",
+ "bstp_nmix_prdy_vrss": "11.49",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3478768",
+ "acml_vol": "283675",
+ "cntg_vol": "708"
+ },
+ {
+ "stck_cntg_hour": "095440",
+ "bstp_nmix_prpr": "916.84",
+ "bstp_nmix_prdy_vrss": "11.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3473716",
+ "acml_vol": "282967",
+ "cntg_vol": "477"
+ },
+ {
+ "stck_cntg_hour": "095430",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3468638",
+ "acml_vol": "282490",
+ "cntg_vol": "538"
+ },
+ {
+ "stck_cntg_hour": "095420",
+ "bstp_nmix_prpr": "916.65",
+ "bstp_nmix_prdy_vrss": "11.15",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3463123",
+ "acml_vol": "281952",
+ "cntg_vol": "644"
+ },
+ {
+ "stck_cntg_hour": "095410",
+ "bstp_nmix_prpr": "916.52",
+ "bstp_nmix_prdy_vrss": "11.02",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.22",
+ "acml_tr_pbmn": "3456930",
+ "acml_vol": "281308",
+ "cntg_vol": "557"
+ },
+ {
+ "stck_cntg_hour": "095400",
+ "bstp_nmix_prpr": "916.28",
+ "bstp_nmix_prdy_vrss": "10.78",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.19",
+ "acml_tr_pbmn": "3451089",
+ "acml_vol": "280751",
+ "cntg_vol": "551"
+ },
+ {
+ "stck_cntg_hour": "095350",
+ "bstp_nmix_prpr": "916.31",
+ "bstp_nmix_prdy_vrss": "10.81",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.19",
+ "acml_tr_pbmn": "3445942",
+ "acml_vol": "280200",
+ "cntg_vol": "825"
+ },
+ {
+ "stck_cntg_hour": "095340",
+ "bstp_nmix_prpr": "916.25",
+ "bstp_nmix_prdy_vrss": "10.75",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.19",
+ "acml_tr_pbmn": "3440251",
+ "acml_vol": "279375",
+ "cntg_vol": "594"
+ },
+ {
+ "stck_cntg_hour": "095330",
+ "bstp_nmix_prpr": "916.47",
+ "bstp_nmix_prdy_vrss": "10.97",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.21",
+ "acml_tr_pbmn": "3433966",
+ "acml_vol": "278781",
+ "cntg_vol": "896"
+ },
+ {
+ "stck_cntg_hour": "095320",
+ "bstp_nmix_prpr": "916.56",
+ "bstp_nmix_prdy_vrss": "11.06",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.22",
+ "acml_tr_pbmn": "3423815",
+ "acml_vol": "277885",
+ "cntg_vol": "670"
+ },
+ {
+ "stck_cntg_hour": "095310",
+ "bstp_nmix_prpr": "916.81",
+ "bstp_nmix_prdy_vrss": "11.31",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3416973",
+ "acml_vol": "277215",
+ "cntg_vol": "818"
+ },
+ {
+ "stck_cntg_hour": "095300",
+ "bstp_nmix_prpr": "916.85",
+ "bstp_nmix_prdy_vrss": "11.35",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3409854",
+ "acml_vol": "276397",
+ "cntg_vol": "777"
+ },
+ {
+ "stck_cntg_hour": "095250",
+ "bstp_nmix_prpr": "917.09",
+ "bstp_nmix_prdy_vrss": "11.59",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+ "acml_tr_pbmn": "3404203",
+ "acml_vol": "275620",
+ "cntg_vol": "474"
+ },
+ {
+ "stck_cntg_hour": "095240",
+ "bstp_nmix_prpr": "916.99",
+ "bstp_nmix_prdy_vrss": "11.49",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3398691",
+ "acml_vol": "275146",
+ "cntg_vol": "457"
+ },
+ {
+ "stck_cntg_hour": "095230",
+ "bstp_nmix_prpr": "916.96",
+ "bstp_nmix_prdy_vrss": "11.46",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3392384",
+ "acml_vol": "274689",
+ "cntg_vol": "315"
+ },
+ {
+ "stck_cntg_hour": "095220",
+ "bstp_nmix_prpr": "916.84",
+ "bstp_nmix_prdy_vrss": "11.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3387938",
+ "acml_vol": "274374",
+ "cntg_vol": "391"
+ },
+ {
+ "stck_cntg_hour": "095210",
+ "bstp_nmix_prpr": "916.96",
+ "bstp_nmix_prdy_vrss": "11.46",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3383576",
+ "acml_vol": "273983",
+ "cntg_vol": "543"
+ },
+ {
+ "stck_cntg_hour": "095200",
+ "bstp_nmix_prpr": "917.01",
+ "bstp_nmix_prdy_vrss": "11.51",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3377596",
+ "acml_vol": "273440",
+ "cntg_vol": "503"
+ },
+ {
+ "stck_cntg_hour": "095150",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3373037",
+ "acml_vol": "272937",
+ "cntg_vol": "407"
+ },
+ {
+ "stck_cntg_hour": "095140",
+ "bstp_nmix_prpr": "916.73",
+ "bstp_nmix_prdy_vrss": "11.23",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3365439",
+ "acml_vol": "272530",
+ "cntg_vol": "487"
+ },
+ {
+ "stck_cntg_hour": "095130",
+ "bstp_nmix_prpr": "916.63",
+ "bstp_nmix_prdy_vrss": "11.13",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "acml_tr_pbmn": "3359798",
+ "acml_vol": "272043",
+ "cntg_vol": "418"
+ },
+ {
+ "stck_cntg_hour": "095120",
+ "bstp_nmix_prpr": "916.74",
+ "bstp_nmix_prdy_vrss": "11.24",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3354130",
+ "acml_vol": "271625",
+ "cntg_vol": "439"
+ },
+ {
+ "stck_cntg_hour": "095110",
+ "bstp_nmix_prpr": "916.73",
+ "bstp_nmix_prdy_vrss": "11.23",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.24",
+ "acml_tr_pbmn": "3347725",
+ "acml_vol": "271186",
+ "cntg_vol": "459"
+ },
+ {
+ "stck_cntg_hour": "095100",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3340647",
+ "acml_vol": "270727",
+ "cntg_vol": "393"
+ },
+ {
+ "stck_cntg_hour": "095050",
+ "bstp_nmix_prpr": "916.85",
+ "bstp_nmix_prdy_vrss": "11.35",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3335589",
+ "acml_vol": "270334",
+ "cntg_vol": "358"
+ },
+ {
+ "stck_cntg_hour": "095040",
+ "bstp_nmix_prpr": "916.85",
+ "bstp_nmix_prdy_vrss": "11.35",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3330288",
+ "acml_vol": "269976",
+ "cntg_vol": "390"
+ },
+ {
+ "stck_cntg_hour": "095030",
+ "bstp_nmix_prpr": "916.88",
+ "bstp_nmix_prdy_vrss": "11.38",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3325139",
+ "acml_vol": "269586",
+ "cntg_vol": "399"
+ },
+ {
+ "stck_cntg_hour": "095020",
+ "bstp_nmix_prpr": "916.94",
+ "bstp_nmix_prdy_vrss": "11.44",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3320375",
+ "acml_vol": "269187",
+ "cntg_vol": "463"
+ },
+ {
+ "stck_cntg_hour": "095010",
+ "bstp_nmix_prpr": "916.95",
+ "bstp_nmix_prdy_vrss": "11.45",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.26",
+ "acml_tr_pbmn": "3315297",
+ "acml_vol": "268724",
+ "cntg_vol": "416"
+ },
+ {
+ "stck_cntg_hour": "095000",
+ "bstp_nmix_prpr": "916.97",
+ "bstp_nmix_prdy_vrss": "11.47",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3310129",
+ "acml_vol": "268308",
+ "cntg_vol": "411"
+ },
+ {
+ "stck_cntg_hour": "094950",
+ "bstp_nmix_prpr": "916.82",
+ "bstp_nmix_prdy_vrss": "11.32",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.25",
+ "acml_tr_pbmn": "3304716",
+ "acml_vol": "267897",
+ "cntg_vol": "505"
+ },
+ {
+ "stck_cntg_hour": "094940",
+ "bstp_nmix_prpr": "917.01",
+ "bstp_nmix_prdy_vrss": "11.51",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.27",
+ "acml_tr_pbmn": "3299470",
+ "acml_vol": "267392",
+ "cntg_vol": "432"
+ },
+ {
+ "stck_cntg_hour": "094930",
+ "bstp_nmix_prpr": "917.16",
+ "bstp_nmix_prdy_vrss": "11.66",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.29",
+ "acml_tr_pbmn": "3294030",
+ "acml_vol": "266960",
+ "cntg_vol": "416"
+ },
+ {
+ "stck_cntg_hour": "094920",
+ "bstp_nmix_prpr": "917.05",
+ "bstp_nmix_prdy_vrss": "11.55",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.28",
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/080_v1_국내주식-065_국내업종-일자별지수.md b/docs/broker/kis/rest/국내주식/업종/기타/080_v1_국내주식-065_국내업종-일자별지수.md
new file mode 100644
index 0000000..7ec2e55
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/080_v1_국내주식-065_국내업종-일자별지수.md
@@ -0,0 +1,1010 @@
+# 국내업종 일자별지수
+
+- 원본 시트명: 국내업종 일자별지수
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-065
+- HTTP Method: GET
+- 실전 TR_ID: FHPUP02120000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-index-daily-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내업종 일자별지수 API입니다. 한 번의 조회에 100건까지 확인 가능합니다.
+한국투자 HTS(eFriend Plus) > [0212] 업종 일자별지수 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPUP02120000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_PERIOD_DIV_CODE | FID 기간 분류 코드 | string | Y | 32 | 일/주/월 구분코드 ( D:일별 , W:주별, M:월별 ) |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (업종 U) |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 코스피(0001), 코스닥(1001), 코스피200(2001)
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조) |
+| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | 입력 날짜(ex. 20240223) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | Y | | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| prdy_vol | 전일 거래량 | string | Y | 18 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 7 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 7 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 7 | |
+| uplm_issu_cnt | 상한 종목 수 | string | Y | 7 | |
+| lslm_issu_cnt | 하한 종목 수 | string | Y | 7 | |
+| prdy_tr_pbmn | 전일 거래 대금 | string | Y | 18 | |
+| dryy_bstp_nmix_hgpr_date | 연중업종지수최고가일자 | string | Y | 8 | |
+| dryy_bstp_nmix_hgpr | 연중업종지수최고가 | string | Y | 112 | |
+| dryy_bstp_nmix_lwpr | 연중업종지수최저가 | string | Y | 112 | |
+| dryy_bstp_nmix_lwpr_date | 연중업종지수최저가일자 | string | Y | 8 | |
+| output2 | 응답상세2 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
+| bstp_nmix_prpr | 업종 지수 현재가 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 112 | |
+| bstp_nmix_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
+| bstp_nmix_oprc | 업종 지수 시가2 | string | Y | 112 | |
+| bstp_nmix_hgpr | 업종 지수 최고가 | string | Y | 112 | |
+| bstp_nmix_lwpr | 업종 지수 최저가 | string | Y | 112 | |
+| acml_vol_rlim | 누적 거래량 비중 | string | Y | 72 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
+| invt_new_psdg | 투자 신 심리도 | string | Y | 112 | |
+| d20_dsrt | 20일 이격도 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"U"
+"fid_input_iscd":"0001"
+"fid_input_date_1":"20240125"
+"fid_period_div_code":"D"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "bstp_nmix_prpr": "2648.76",
+ "bstp_nmix_prdy_vrss": "34.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "acml_vol": "593842",
+ "acml_tr_pbmn": "10221804",
+ "bstp_nmix_oprc": "2635.63",
+ "bstp_nmix_hgpr": "2648.76",
+ "bstp_nmix_lwpr": "2625.01",
+ "prdy_vol": "621363",
+ "ascn_issu_cnt": "628",
+ "down_issu_cnt": "250",
+ "stnr_issu_cnt": "58",
+ "uplm_issu_cnt": "0",
+ "lslm_issu_cnt": "0",
+ "prdy_tr_pbmn": "10691024",
+ "dryy_bstp_nmix_hgpr_date": "20240102",
+ "dryy_bstp_nmix_hgpr": "2675.80",
+ "dryy_bstp_nmix_lwpr": "2429.12",
+ "dryy_bstp_nmix_lwpr_date": "20240118"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240125",
+ "bstp_nmix_prpr": "2470.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "0.65",
+ "bstp_nmix_prdy_ctrt": "0.03",
+ "bstp_nmix_oprc": "2467.73",
+ "bstp_nmix_hgpr": "2474.01",
+ "bstp_nmix_lwpr": "2452.36",
+ "acml_vol_rlim": "166.23",
+ "acml_vol": "357234",
+ "acml_tr_pbmn": "8124338",
+ "invt_new_psdg": "-19.94",
+ "d20_dsrt": "97.44"
+ },
+ {
+ "stck_bsop_date": "20240124",
+ "bstp_nmix_prpr": "2469.69",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-8.92",
+ "bstp_nmix_prdy_ctrt": "-0.36",
+ "bstp_nmix_oprc": "2476.22",
+ "bstp_nmix_hgpr": "2476.22",
+ "bstp_nmix_lwpr": "2454.34",
+ "acml_vol_rlim": "150.16",
+ "acml_vol": "395464",
+ "acml_tr_pbmn": "7446527",
+ "invt_new_psdg": "-30.49",
+ "d20_dsrt": "97.17"
+ },
+ {
+ "stck_bsop_date": "20240123",
+ "bstp_nmix_prpr": "2478.61",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "14.26",
+ "bstp_nmix_prdy_ctrt": "0.58",
+ "bstp_nmix_oprc": "2478.32",
+ "bstp_nmix_hgpr": "2482.84",
+ "bstp_nmix_lwpr": "2464.24",
+ "acml_vol_rlim": "125.74",
+ "acml_vol": "472284",
+ "acml_tr_pbmn": "8029400",
+ "invt_new_psdg": "-32.13",
+ "d20_dsrt": "97.27"
+ },
+ {
+ "stck_bsop_date": "20240122",
+ "bstp_nmix_prpr": "2464.35",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-8.39",
+ "bstp_nmix_prdy_ctrt": "-0.34",
+ "bstp_nmix_oprc": "2489.57",
+ "bstp_nmix_hgpr": "2490.69",
+ "bstp_nmix_lwpr": "2464.35",
+ "acml_vol_rlim": "153.03",
+ "acml_vol": "388046",
+ "acml_tr_pbmn": "8419916",
+ "invt_new_psdg": "-48.90",
+ "d20_dsrt": "96.48"
+ },
+ {
+ "stck_bsop_date": "20240119",
+ "bstp_nmix_prpr": "2472.74",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "32.70",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "bstp_nmix_oprc": "2468.43",
+ "bstp_nmix_hgpr": "2479.00",
+ "bstp_nmix_lwpr": "2455.50",
+ "acml_vol_rlim": "114.46",
+ "acml_vol": "518807",
+ "acml_tr_pbmn": "9174537",
+ "invt_new_psdg": "-49.12",
+ "d20_dsrt": "96.52"
+ },
+ {
+ "stck_bsop_date": "20240118",
+ "bstp_nmix_prpr": "2440.04",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "4.14",
+ "bstp_nmix_prdy_ctrt": "0.17",
+ "bstp_nmix_oprc": "2439.96",
+ "bstp_nmix_hgpr": "2453.97",
+ "bstp_nmix_lwpr": "2429.12",
+ "acml_vol_rlim": "103.91",
+ "acml_vol": "571508",
+ "acml_tr_pbmn": "8300178",
+ "invt_new_psdg": "-76.77",
+ "d20_dsrt": "95.07"
+ },
+ {
+ "stck_bsop_date": "20240117",
+ "bstp_nmix_prpr": "2435.90",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-61.69",
+ "bstp_nmix_prdy_ctrt": "-2.47",
+ "bstp_nmix_oprc": "2501.23",
+ "bstp_nmix_hgpr": "2503.91",
+ "bstp_nmix_lwpr": "2435.34",
+ "acml_vol_rlim": "61.50",
+ "acml_vol": "965595",
+ "acml_tr_pbmn": "11281598",
+ "invt_new_psdg": "-89.46",
+ "d20_dsrt": "94.67"
+ },
+ {
+ "stck_bsop_date": "20240116",
+ "bstp_nmix_prpr": "2497.59",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-28.40",
+ "bstp_nmix_prdy_ctrt": "-1.12",
+ "bstp_nmix_oprc": "2516.27",
+ "bstp_nmix_hgpr": "2524.35",
+ "bstp_nmix_lwpr": "2491.13",
+ "acml_vol_rlim": "90.03",
+ "acml_vol": "659579",
+ "acml_tr_pbmn": "8828509",
+ "invt_new_psdg": "-89.46",
+ "d20_dsrt": "96.83"
+ },
+ {
+ "stck_bsop_date": "20240115",
+ "bstp_nmix_prpr": "2525.99",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "0.94",
+ "bstp_nmix_prdy_ctrt": "0.04",
+ "bstp_nmix_oprc": "2525.69",
+ "bstp_nmix_hgpr": "2536.06",
+ "bstp_nmix_lwpr": "2515.84",
+ "acml_vol_rlim": "74.04",
+ "acml_vol": "802102",
+ "acml_tr_pbmn": "8182707",
+ "invt_new_psdg": "-70.35",
+ "d20_dsrt": "97.84"
+ },
+ {
+ "stck_bsop_date": "20240112",
+ "bstp_nmix_prpr": "2525.05",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-15.22",
+ "bstp_nmix_prdy_ctrt": "-0.60",
+ "bstp_nmix_oprc": "2536.55",
+ "bstp_nmix_hgpr": "2543.83",
+ "bstp_nmix_lwpr": "2517.76",
+ "acml_vol_rlim": "75.15",
+ "acml_vol": "790177",
+ "acml_tr_pbmn": "8368766",
+ "invt_new_psdg": "-51.99",
+ "d20_dsrt": "97.84"
+ },
+ {
+ "stck_bsop_date": "20240111",
+ "bstp_nmix_prpr": "2540.27",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-1.71",
+ "bstp_nmix_prdy_ctrt": "-0.07",
+ "bstp_nmix_oprc": "2543.03",
+ "bstp_nmix_hgpr": "2557.30",
+ "bstp_nmix_lwpr": "2540.27",
+ "acml_vol_rlim": "75.32",
+ "acml_vol": "788423",
+ "acml_tr_pbmn": "13669890",
+ "invt_new_psdg": "-35.84",
+ "d20_dsrt": "98.41"
+ },
+ {
+ "stck_bsop_date": "20240110",
+ "bstp_nmix_prpr": "2541.98",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-19.26",
+ "bstp_nmix_prdy_ctrt": "-0.75",
+ "bstp_nmix_oprc": "2563.97",
+ "bstp_nmix_hgpr": "2568.19",
+ "bstp_nmix_lwpr": "2539.82",
+ "acml_vol_rlim": "104.18",
+ "acml_vol": "570021",
+ "acml_tr_pbmn": "8795835",
+ "invt_new_psdg": "-24.52",
+ "d20_dsrt": "98.50"
+ },
+ {
+ "stck_bsop_date": "20240109",
+ "bstp_nmix_prpr": "2561.24",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-6.58",
+ "bstp_nmix_prdy_ctrt": "-0.26",
+ "bstp_nmix_oprc": "2598.31",
+ "bstp_nmix_hgpr": "2599.37",
+ "bstp_nmix_lwpr": "2556.00",
+ "acml_vol_rlim": "75.05",
+ "acml_vol": "791214",
+ "acml_tr_pbmn": "8896714",
+ "invt_new_psdg": "-20.81",
+ "d20_dsrt": "99.29"
+ },
+ {
+ "stck_bsop_date": "20240108",
+ "bstp_nmix_prpr": "2567.82",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-10.26",
+ "bstp_nmix_prdy_ctrt": "-0.40",
+ "bstp_nmix_oprc": "2584.23",
+ "bstp_nmix_hgpr": "2591.68",
+ "bstp_nmix_lwpr": "2566.34",
+ "acml_vol_rlim": "185.49",
+ "acml_vol": "320144",
+ "acml_tr_pbmn": "6763632",
+ "invt_new_psdg": "-22.42",
+ "d20_dsrt": "99.68"
+ },
+ {
+ "stck_bsop_date": "20240105",
+ "bstp_nmix_prpr": "2578.08",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-8.94",
+ "bstp_nmix_prdy_ctrt": "-0.35",
+ "bstp_nmix_oprc": "2586.89",
+ "bstp_nmix_hgpr": "2592.29",
+ "bstp_nmix_lwpr": "2572.60",
+ "acml_vol_rlim": "113.70",
+ "acml_vol": "522290",
+ "acml_tr_pbmn": "8384473",
+ "invt_new_psdg": "2.14",
+ "d20_dsrt": "100.22"
+ },
+ {
+ "stck_bsop_date": "20240104",
+ "bstp_nmix_prpr": "2587.02",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-20.29",
+ "bstp_nmix_prdy_ctrt": "-0.78",
+ "bstp_nmix_oprc": "2592.44",
+ "bstp_nmix_hgpr": "2602.64",
+ "bstp_nmix_lwpr": "2580.09",
+ "acml_vol_rlim": "77.10",
+ "acml_vol": "770176",
+ "acml_tr_pbmn": "8992274",
+ "invt_new_psdg": "14.68",
+ "d20_dsrt": "100.73"
+ },
+ {
+ "stck_bsop_date": "20240103",
+ "bstp_nmix_prpr": "2607.31",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-62.50",
+ "bstp_nmix_prdy_ctrt": "-2.34",
+ "bstp_nmix_oprc": "2643.54",
+ "bstp_nmix_hgpr": "2643.72",
+ "bstp_nmix_lwpr": "2607.31",
+ "acml_vol_rlim": "128.22",
+ "acml_vol": "463132",
+ "acml_tr_pbmn": "10121578",
+ "invt_new_psdg": "31.03",
+ "d20_dsrt": "101.67"
+ },
+ {
+ "stck_bsop_date": "20240102",
+ "bstp_nmix_prpr": "2669.81",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "14.53",
+ "bstp_nmix_prdy_ctrt": "0.55",
+ "bstp_nmix_oprc": "2645.47",
+ "bstp_nmix_hgpr": "2675.80",
+ "bstp_nmix_lwpr": "2641.88",
+ "acml_vol_rlim": "144.88",
+ "acml_vol": "409872",
+ "acml_tr_pbmn": "9628190",
+ "invt_new_psdg": "70.47",
+ "d20_dsrt": "104.31"
+ },
+ {
+ "stck_bsop_date": "20231228",
+ "bstp_nmix_prpr": "2655.28",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "41.78",
+ "bstp_nmix_prdy_ctrt": "1.60",
+ "bstp_nmix_oprc": "2616.27",
+ "bstp_nmix_hgpr": "2655.28",
+ "bstp_nmix_lwpr": "2611.72",
+ "acml_vol_rlim": "129.07",
+ "acml_vol": "460087",
+ "acml_tr_pbmn": "9418930",
+ "invt_new_psdg": "71.51",
+ "d20_dsrt": "104.02"
+ },
+ {
+ "stck_bsop_date": "20231227",
+ "bstp_nmix_prpr": "2613.50",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "10.91",
+ "bstp_nmix_prdy_ctrt": "0.42",
+ "bstp_nmix_oprc": "2599.35",
+ "bstp_nmix_hgpr": "2613.50",
+ "bstp_nmix_lwpr": "2590.08",
+ "acml_vol_rlim": "169.80",
+ "acml_vol": "349733",
+ "acml_tr_pbmn": "10359764",
+ "invt_new_psdg": "44.91",
+ "d20_dsrt": "102.65"
+ },
+ {
+ "stck_bsop_date": "20231226",
+ "bstp_nmix_prpr": "2602.59",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "3.08",
+ "bstp_nmix_prdy_ctrt": "0.12",
+ "bstp_nmix_oprc": "2609.44",
+ "bstp_nmix_hgpr": "2612.14",
+ "bstp_nmix_lwpr": "2594.65",
+ "acml_vol_rlim": "134.83",
+ "acml_vol": "440428",
+ "acml_tr_pbmn": "9582766",
+ "invt_new_psdg": "44.75",
+ "d20_dsrt": "102.41"
+ },
+ {
+ "stck_bsop_date": "20231222",
+ "bstp_nmix_prpr": "2599.51",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-0.51",
+ "bstp_nmix_prdy_ctrt": "-0.02",
+ "bstp_nmix_oprc": "2617.72",
+ "bstp_nmix_hgpr": "2621.37",
+ "bstp_nmix_lwpr": "2599.51",
+ "acml_vol_rlim": "127.44",
+ "acml_vol": "465967",
+ "acml_tr_pbmn": "8848288",
+ "invt_new_psdg": "45.45",
+ "d20_dsrt": "102.50"
+ },
+ {
+ "stck_bsop_date": "20231221",
+ "bstp_nmix_prpr": "2600.02",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-14.28",
+ "bstp_nmix_prdy_ctrt": "-0.55",
+ "bstp_nmix_oprc": "2598.37",
+ "bstp_nmix_hgpr": "2610.81",
+ "bstp_nmix_lwpr": "2587.16",
+ "acml_vol_rlim": "102.68",
+ "acml_vol": "578335",
+ "acml_tr_pbmn": "9467809",
+ "invt_new_psdg": "59.06",
+ "d20_dsrt": "102.73"
+ },
+ {
+ "stck_bsop_date": "20231220",
+ "bstp_nmix_prpr": "2614.30",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "45.75",
+ "bstp_nmix_prdy_ctrt": "1.78",
+ "bstp_nmix_oprc": "2586.99",
+ "bstp_nmix_hgpr": "2615.38",
+ "bstp_nmix_lwpr": "2584.85",
+ "acml_vol_rlim": "104.11",
+ "acml_vol": "570423",
+ "acml_tr_pbmn": "11202543",
+ "invt_new_psdg": "64.02",
+ "d20_dsrt": "103.47"
+ },
+ {
+ "stck_bsop_date": "20231219",
+ "bstp_nmix_prpr": "2568.55",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "1.69",
+ "bstp_nmix_prdy_ctrt": "0.07",
+ "bstp_nmix_oprc": "2564.81",
+ "bstp_nmix_hgpr": "2570.06",
+ "bstp_nmix_lwpr": "2556.52",
+ "acml_vol_rlim": "151.30",
+ "acml_vol": "392497",
+ "acml_tr_pbmn": "8418111",
+ "invt_new_psdg": "58.54",
+ "d20_dsrt": "101.87"
+ },
+ {
+ "stck_bsop_date": "20231218",
+ "bstp_nmix_prpr": "2566.86",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "3.30",
+ "bstp_nmix_prdy_ctrt": "0.13",
+ "bstp_nmix_oprc": "2568.77",
+ "bstp_nmix_hgpr": "2573.13",
+ "bstp_nmix_lwpr": "2556.05",
+ "acml_vol_rlim": "154.31",
+ "acml_vol": "384828",
+ "acml_tr_pbmn": "10181568",
+ "invt_new_psdg": "37.41",
+ "d20_dsrt": "101.92"
+ },
+ {
+ "stck_bsop_date": "20231215",
+ "bstp_nmix_prpr": "2563.56",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "19.38",
+ "bstp_nmix_prdy_ctrt": "0.76",
+ "bstp_nmix_oprc": "2558.44",
+ "bstp_nmix_hgpr": "2574.23",
+ "bstp_nmix_lwpr": "2555.30",
+ "acml_vol_rlim": "127.62",
+ "acml_vol": "465314",
+ "acml_tr_pbmn": "12873295",
+ "invt_new_psdg": "38.80",
+ "d20_dsrt": "101.94"
+ },
+ {
+ "stck_bsop_date": "20231214",
+ "bstp_nmix_prpr": "2544.18",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "33.52",
+ "bstp_nmix_prdy_ctrt": "1.34",
+ "bstp_nmix_oprc": "2547.74",
+ "bstp_nmix_hgpr": "2549.65",
+ "bstp_nmix_lwpr": "2532.16",
+ "acml_vol_rlim": "112.02",
+ "acml_vol": "530124",
+ "acml_tr_pbmn": "12960671",
+ "invt_new_psdg": "12.67",
+ "d20_dsrt": "101.36"
+ },
+ {
+ "stck_bsop_date": "20231213",
+ "bstp_nmix_prpr": "2510.66",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-24.61",
+ "bstp_nmix_prdy_ctrt": "-0.97",
+ "bstp_nmix_oprc": "2531.23",
+ "bstp_nmix_hgpr": "2531.23",
+ "bstp_nmix_lwpr": "2509.89",
+ "acml_vol_rlim": "157.13",
+ "acml_vol": "377934",
+ "acml_tr_pbmn": "7513617",
+ "invt_new_psdg": "6.92",
+ "d20_dsrt": "100.13"
+ },
+ {
+ "stck_bsop_date": "20231212",
+ "bstp_nmix_prpr": "2535.27",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "9.91",
+ "bstp_nmix_prdy_ctrt": "0.39",
+ "bstp_nmix_oprc": "2535.11",
+ "bstp_nmix_hgpr": "2543.06",
+ "bstp_nmix_lwpr": "2529.74",
+ "acml_vol_rlim": "157.09",
+ "acml_vol": "378034",
+ "acml_tr_pbmn": "7732530",
+ "invt_new_psdg": "15.36",
+ "d20_dsrt": "101.16"
+ },
+ {
+ "stck_bsop_date": "20231211",
+ "bstp_nmix_prpr": "2525.36",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "7.51",
+ "bstp_nmix_prdy_ctrt": "0.30",
+ "bstp_nmix_oprc": "2524.79",
+ "bstp_nmix_hgpr": "2528.89",
+ "bstp_nmix_lwpr": "2512.45",
+ "acml_vol_rlim": "136.51",
+ "acml_vol": "435004",
+ "acml_tr_pbmn": "8260508",
+ "invt_new_psdg": "20.45",
+ "d20_dsrt": "100.97"
+ },
+ {
+ "stck_bsop_date": "20231208",
+ "bstp_nmix_prpr": "2517.85",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "25.78",
+ "bstp_nmix_prdy_ctrt": "1.03",
+ "bstp_nmix_oprc": "2510.24",
+ "bstp_nmix_hgpr": "2521.58",
+ "bstp_nmix_lwpr": "2507.14",
+ "acml_vol_rlim": "137.53",
+ "acml_vol": "431797",
+ "acml_tr_pbmn": "7916793",
+ "invt_new_psdg": "7.83",
+ "d20_dsrt": "100.92"
+ },
+ {
+ "stck_bsop_date": "20231207",
+ "bstp_nmix_prpr": "2492.07",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-3.31",
+ "bstp_nmix_prdy_ctrt": "-0.13",
+ "bstp_nmix_oprc": "2493.14",
+ "bstp_nmix_hgpr": "2499.73",
+ "bstp_nmix_lwpr": "2481.00",
+ "acml_vol_rlim": "132.89",
+ "acml_vol": "446877",
+ "acml_tr_pbmn": "8127636",
+ "invt_new_psdg": "-18.93",
+ "d20_dsrt": "100.10"
+ },
+ {
+ "stck_bsop_date": "20231206",
+ "bstp_nmix_prpr": "2495.38",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "1.10",
+ "bstp_nmix_prdy_ctrt": "0.04",
+ "bstp_nmix_oprc": "2503.57",
+ "bstp_nmix_hgpr": "2509.67",
+ "bstp_nmix_lwpr": "2495.38",
+ "acml_vol_rlim": "151.88",
+ "acml_vol": "390989",
+ "acml_tr_pbmn": "7685320",
+ "invt_new_psdg": "-6.37",
+ "d20_dsrt": "100.37"
+ },
+ {
+ "stck_bsop_date": "20231205",
+ "bstp_nmix_prpr": "2494.28",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-20.67",
+ "bstp_nmix_prdy_ctrt": "-0.82",
+ "bstp_nmix_oprc": "2507.45",
+ "bstp_nmix_hgpr": "2509.74",
+ "bstp_nmix_lwpr": "2492.55",
+ "acml_vol_rlim": "139.05",
+ "acml_vol": "427067",
+ "acml_tr_pbmn": "8300522",
+ "invt_new_psdg": "-6.29",
+ "d20_dsrt": "100.47"
+ },
+ {
+ "stck_bsop_date": "20231204",
+ "bstp_nmix_prpr": "2514.95",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "9.94",
+ "bstp_nmix_prdy_ctrt": "0.40",
+ "bstp_nmix_oprc": "2522.22",
+ "bstp_nmix_hgpr": "2525.63",
+ "bstp_nmix_lwpr": "2510.52",
+ "acml_vol_rlim": "119.04",
+ "acml_vol": "498861",
+ "acml_tr_pbmn": "8772367",
+ "invt_new_psdg": "19.36",
+ "d20_dsrt": "101.41"
+ },
+ {
+ "stck_bsop_date": "20231201",
+ "bstp_nmix_prpr": "2505.01",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-30.28",
+ "bstp_nmix_prdy_ctrt": "-1.19",
+ "bstp_nmix_oprc": "2520.49",
+ "bstp_nmix_hgpr": "2520.49",
+ "bstp_nmix_lwpr": "2504.06",
+ "acml_vol_rlim": "114.95",
+ "acml_vol": "516596",
+ "acml_tr_pbmn": "8837750",
+ "invt_new_psdg": "22.72",
+ "d20_dsrt": "101.03"
+ },
+ {
+ "stck_bsop_date": "20231130",
+ "bstp_nmix_prpr": "2535.29",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "15.48",
+ "bstp_nmix_prdy_ctrt": "0.61",
+ "bstp_nmix_oprc": "2512.11",
+ "bstp_nmix_hgpr": "2535.29",
+ "bstp_nmix_lwpr": "2507.80",
+ "acml_vol_rlim": "89.40",
+ "acml_vol": "664284",
+ "acml_tr_pbmn": "11992488",
+ "invt_new_psdg": "28.65",
+ "d20_dsrt": "102.54"
+ },
+ {
+ "stck_bsop_date": "20231129",
+ "bstp_nmix_prpr": "2519.81",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-1.95",
+ "bstp_nmix_prdy_ctrt": "-0.08",
+ "bstp_nmix_oprc": "2518.80",
+ "bstp_nmix_hgpr": "2523.98",
+ "bstp_nmix_lwpr": "2501.44",
+ "acml_vol_rlim": "102.52",
+ "acml_vol": "579271",
+ "acml_tr_pbmn": "9428200",
+ "invt_new_psdg": "24.76",
+ "d20_dsrt": "102.31"
+ },
+ {
+ "stck_bsop_date": "20231128",
+ "bstp_nmix_prpr": "2521.76",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "26.10",
+ "bstp_nmix_prdy_ctrt": "1.05",
+ "bstp_nmix_oprc": "2506.14",
+ "bstp_nmix_hgpr": "2522.45",
+ "bstp_nmix_lwpr": "2502.26",
+ "acml_vol_rlim": "134.02",
+ "acml_vol": "443090",
+ "acml_tr_pbmn": "8753424",
+ "invt_new_psdg": "47.02",
+ "d20_dsrt": "102.84"
+ },
+ {
+ "stck_bsop_date": "20231127",
+ "bstp_nmix_prpr": "2495.66",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-0.97",
+ "bstp_nmix_prdy_ctrt": "-0.04",
+ "bstp_nmix_oprc": "2501.83",
+ "bstp_nmix_hgpr": "2511.37",
+ "bstp_nmix_lwpr": "2489.18",
+ "acml_vol_rlim": "162.81",
+ "acml_vol": "364744",
+ "acml_tr_pbmn": "8376476",
+ "invt_new_psdg": "47.49",
+ "d20_dsrt": "102.29"
+ },
+ {
+ "stck_bsop_date": "20231124",
+ "bstp_nmix_prpr": "2496.63",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-18.33",
+ "bstp_nmix_prdy_ctrt": "-0.73",
+ "bstp_nmix_oprc": "2517.88",
+ "bstp_nmix_hgpr": "2521.56",
+ "bstp_nmix_lwpr": "2496.63",
+ "acml_vol_rlim": "165.24",
+ "acml_vol": "359383",
+ "acml_tr_pbmn": "6537961",
+ "invt_new_psdg": "45.27",
+ "d20_dsrt": "102.71"
+ },
+ {
+ "stck_bsop_date": "20231123",
+ "bstp_nmix_prpr": "2514.96",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "3.26",
+ "bstp_nmix_prdy_ctrt": "0.13",
+ "bstp_nmix_oprc": "2515.83",
+ "bstp_nmix_hgpr": "2522.20",
+ "bstp_nmix_lwpr": "2507.30",
+ "acml_vol_rlim": "164.56",
+ "acml_vol": "360874",
+ "acml_tr_pbmn": "6577868",
+ "invt_new_psdg": "45.67",
+ "d20_dsrt": "103.88"
+ },
+ {
+ "stck_bsop_date": "20231122",
+ "bstp_nmix_prpr": "2511.70",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "1.28",
+ "bstp_nmix_prdy_ctrt": "0.05",
+ "bstp_nmix_oprc": "2493.17",
+ "bstp_nmix_hgpr": "2516.72",
+ "bstp_nmix_lwpr": "2490.43",
+ "acml_vol_rlim": "135.12",
+ "acml_vol": "439486",
+ "acml_tr_pbmn": "7755316",
+ "invt_new_psdg": "45.98",
+ "d20_dsrt": "104.21"
+ },
+ {
+ "stck_bsop_date": "20231121",
+ "bstp_nmix_prpr": "2510.42",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "19.22",
+ "bstp_nmix_prdy_ctrt": "0.77",
+ "bstp_nmix_oprc": "2504.70",
+ "bstp_nmix_hgpr": "2517.74",
+ "bstp_nmix_lwpr": "2500.91",
+ "acml_vol_rlim": "172.10",
+ "acml_vol": "345055",
+ "acml_tr_pbmn": "7713377",
+ "invt_new_psdg": "27.09",
+ "d20_dsrt": "104.48"
+ },
+ {
+ "stck_bsop_date": "20231120",
+ "bstp_nmix_prpr": "2491.20",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "21.35",
+ "bstp_nmix_prdy_ctrt": "0.86",
+ "bstp_nmix_oprc": "2464.72",
+ "bstp_nmix_hgpr": "2499.75",
+ "bstp_nmix_lwpr": "2464.04",
+ "acml_vol_rlim": "183.39",
+ "acml_vol": "323806",
+ "acml_tr_pbmn": "6586445",
+ "invt_new_psdg": "-2.39",
+ "d20_dsrt": "103.96"
+ },
+ {
+ "stck_bsop_date": "20231117",
+ "bstp_nmix_prpr": "2469.85",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-18.33",
+ "bstp_nmix_prdy_ctrt": "-0.74",
+ "bstp_nmix_oprc": "2477.43",
+ "bstp_nmix_hgpr": "2481.10",
+ "bstp_nmix_lwpr": "2463.59",
+ "acml_vol_rlim": "152.67",
+ "acml_vol": "388974",
+ "acml_tr_pbmn": "8129523",
+ "invt_new_psdg": "14.66",
+ "d20_dsrt": "103.35"
+ },
+ {
+ "stck_bsop_date": "20231116",
+ "bstp_nmix_prpr": "2488.18",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "1.51",
+ "bstp_nmix_prdy_ctrt": "0.06",
+ "bstp_nmix_oprc": "2483.48",
+ "bstp_nmix_hgpr": "2491.98",
+ "bstp_nmix_lwpr": "2472.69",
+ "acml_vol_rlim": "145.75",
+ "acml_vol": "407441",
+ "acml_tr_pbmn": "6806414",
+ "invt_new_psdg": "30.54",
+ "d20_dsrt": "104.33"
+ },
+ {
+ "stck_bsop_date": "20231115",
+ "bstp_nmix_prpr": "2486.67",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "53.42",
+ "bstp_nmix_prdy_ctrt": "2.20",
+ "bstp_nmix_oprc": "2482.21",
+ "bstp_nmix_hgpr": "2487.42",
+ "bstp_nmix_lwpr": "2468.43",
+ "acml_vol_rlim": "141.44",
+ "acml_vol": "419843",
+ "acml_tr_pbmn": "9328219",
+ "invt_new_psdg": "33.54",
+ "d20_dsrt": "104.42"
+ },
+ {
+ "stck_bsop_date": "20231114",
+ "bstp_nmix_prpr": "2433.25",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "29.49",
+ "bstp_nmix_prdy_ctrt": "1.23",
+ "bstp_nmix_oprc": "2424.93",
+ "bstp_nmix_hgpr": "2442.37",
+ "bstp_nmix_lwpr": "2422.97",
+ "acml_vol_rlim": "193.46",
+ "acml_vol": "306964",
+ "acml_tr_pbmn": "6382101",
+ "invt_new_psdg": "31.36",
+ "d20_dsrt": "102.23"
+ },
+ {
+ "stck_bsop_date": "20231113",
+ "bstp_nmix_prpr": "2403.76",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-5.90",
+ "bstp_nmix_prdy_ctrt": "-0.24",
+ "bstp_nmix_oprc": "2431.24",
+ "bstp_nmix_hgpr": "2435.32",
+ "bstp_nmix_lwpr": "2399.04",
+ "acml_vol_rlim": "193.36",
+ "acml_vol": "307123",
+ "acml_tr_pbmn": "5934173",
+ "invt_new_psdg": "12.72",
+ "d20_dsrt": "100.94"
+ },
+ {
+ "stck_bsop_date": "20231110",
+ "bstp_nmix_prpr": "2409.66",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-17.42",
+ "bstp_nmix_prdy_ctrt": "-0.72",
+ "bstp_nmix_oprc": "2406.40",
+ "bstp_nmix_hgpr": "2413.62",
+ "bstp_nmix_lwpr": "2393.64",
+ "acml_vol_rlim": "190.05",
+ "acml_vol": "312468",
+ "acml_tr_pbmn": "5825602",
+ "invt_new_psdg": "24.51",
+ "d20_dsrt": "101.12"
+ },
+ {
+ "stck_bsop_date": "20231109",
+ "bstp_nmix_prpr": "2427.08",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "5.46",
+ "bstp_nmix_prdy_ctrt": "0.23",
+ "bstp_nmix_oprc": "2425.93",
+ "bstp_nmix_hgpr": "2437.90",
+ "bstp_nmix_lwpr": "2413.04",
+ "acml_vol_rlim": "150.33",
+ "acml_vol": "395031",
+ "acml_tr_pbmn": "7288448",
+ "invt_new_psdg": "38.05",
+ "d20_dsrt": "101.75"
+ },
+ {
+ "stck_bsop_date": "20231108",
+ "bstp_nmix_prpr": "2421.62",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-22.34",
+ "bstp_nmix_prdy_ctrt": "-0.91",
+ "bstp_nmix_oprc": "2460.22",
+ "bstp_nmix_hgpr": "2468.43",
+ "bstp_nmix_lwpr": "2418.14",
+ "acml_vol_rlim": "127.10",
+ "acml_vol": "467218",
+ "acml_tr_pbmn": "7667332",
+ "invt_new_psdg": "17.07",
+ "d20_dsrt": "101.41"
+ },
+ {
+ "stck_bsop_date": "20231107",
+ "bstp_nmix_prpr": "2443.96",
+ "prdy_vrss_sign": "5",
+ "bstp_nmix_prdy_vrss": "-58.41",
+ "bstp_nmix_prdy_ctrt": "-2.33",
+ "bstp_nmix_oprc": "2476.35",
+ "bstp_nmix_hgpr": "2476.35",
+ "bstp_nmix_lwpr": "2418.74",
+ "acml_vol_rlim": "129.75",
+ "acml_vol": "457676",
+ "acml_tr_pbmn": "12086570",
+ "invt_new_psdg": "17.35",
+ "d20_dsrt": "102.28"
+ },
+ {
+ "stck_bsop_date": "20231106",
+ "bstp_nmix_prpr": "2502.37",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "134.03",
+ "bstp_nmix_prdy_ctrt": "5.66",
+ "bstp_nmix_oprc": "2399.80",
+ "bstp_nmix_hgpr": "2502.37",
+ "bstp_nmix_lwpr": "2395.03",
+ "acml_vol_rlim": "112.35",
+ "acml_vol": "528585",
+ "acml_tr_pbmn": "15225480",
+ "invt_new_psdg": "39.16",
+ "d20_dsrt": "104.82"
+ },
+ {
+ "stck_bsop_date": "20231103",
+ "bstp_nmix_prpr": "2368.34",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "25.22",
+ "bstp_nmix_prdy_ctrt": "1.08",
+ "bstp_nmix_oprc": "2365.59",
+ "bstp_nmix_hgpr": "2370.28",
+ "bstp_nmix_lwpr": "2351.83",
+ "acml_vol_rlim": "102.62",
+ "acml_vol": "578662",
+ "acml_tr_pbmn": "8040958",
+ "invt_new_psdg": "8.74",
+ "d20_dsrt": "99.40"
+ },
+ {
+ "stck_bsop_date": "20231102",
+ "bstp_nmix_prpr": "2343.12",
+ "prdy_vrss_sign": "2",
+ "bstp_nmix_prdy_vrss": "41.56",
+ "bstp_nmix_prdy_ctrt": "1.81",
+ "bstp_nmix_oprc": "2334.96",
+ "bstp_nmix_hgpr": "2351.91",
+ "bstp_nmix_lwpr": "2333.41",
+ "acml_vol_rlim": "157.33",
+ "acml_vol": "377462",
+ "acml_tr_pbmn": "7679305",
+ "invt_new_psdg": "-13.03",
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/081_국내주식-155_금리-종합국내채권_금리.md b/docs/broker/kis/rest/국내주식/업종/기타/081_국내주식-155_금리-종합국내채권_금리.md
new file mode 100644
index 0000000..08006e1
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/081_국내주식-155_금리-종합국내채권_금리.md
@@ -0,0 +1,342 @@
+# 금리 종합(국내채권_금리)
+
+- 원본 시트명: 금리 종합(국내채권_금리)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-155
+- HTTP Method: GET
+- 실전 TR_ID: FHPST07020000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/comp-interest
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+금리 종합(국내채권/금리) API입니다.
+한국투자 HTS(eFriend Plus) > [0702] 금리 종합 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 11:30 이후에 신규데이터가 수신되는 점 참고하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST07020000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | Unique key(I) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | Unique key(20702) |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 1: 해외금리지표 |
+| FID_DIV_CLS_CODE1 | 분류구분코드 | string | Y | 2 | 공백 : 전체 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | array |
+| bcdt_code | 자료코드 | string | Y | 5 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| bond_mnrt_prpr | 채권금리현재가 | string | Y | 114 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| bond_mnrt_prdy_vrss | 채권금리전일대비 | string | Y | 114 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| output2 | 응답상세 | object array | Y | | array |
+| bcdt_code | 자료코드 | string | Y | 5 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| bond_mnrt_prpr | 채권금리현재가 | string | Y | 114 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| bond_mnrt_prdy_vrss | 채권금리전일대비 | string | Y | 114 | |
+| bstp_nmix_prdy_ctrt | 업종지수전일대비율 | string | Y | 82 | |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:I
+FID_COND_SCR_DIV_CODE:20702
+FID_DIV_CLS_CODE:1
+FID_DIV_CLS_CODE1:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "bcdt_code": "Y0201",
+ "hts_kor_isnm": "미국 30년T-BOND",
+ "bond_mnrt_prpr": "4.6500",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0100",
+ "prdy_ctrt": "0.22",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0202",
+ "hts_kor_isnm": "미국 10년T-NOTE 수익률",
+ "bond_mnrt_prpr": "4.5600",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0100",
+ "prdy_ctrt": "0.22",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0203",
+ "hts_kor_isnm": "미국 1년T-BILL",
+ "bond_mnrt_prpr": "5.1700",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0200",
+ "prdy_ctrt": "-0.39",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0204",
+ "hts_kor_isnm": "미국 연방기금금리(콜)",
+ "bond_mnrt_prpr": "5.3300",
+ "prdy_vrss_sign": "3",
+ "bond_mnrt_prdy_vrss": "0.0000",
+ "prdy_ctrt": "0.00",
+ "stck_bsop_date": "20240410"
+ },
+ {
+ "bcdt_code": "Y0205",
+ "hts_kor_isnm": "미국 재할인률",
+ "bond_mnrt_prpr": "5.5000",
+ "prdy_vrss_sign": "3",
+ "bond_mnrt_prdy_vrss": "0.0000",
+ "prdy_ctrt": "0.00",
+ "stck_bsop_date": "20240410"
+ },
+ {
+ "bcdt_code": "Y0206",
+ "hts_kor_isnm": "미국 단기우대금리",
+ "bond_mnrt_prpr": "8.5000",
+ "prdy_vrss_sign": "3",
+ "bond_mnrt_prdy_vrss": "0.0000",
+ "prdy_ctrt": "0.00",
+ "stck_bsop_date": "20240410"
+ },
+ {
+ "bcdt_code": "Y0207",
+ "hts_kor_isnm": "일본 10년 국채수익률",
+ "bond_mnrt_prpr": "0.8540",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0530",
+ "prdy_ctrt": "6.62",
+ "stck_bsop_date": "20240411"
+ }
+ ],
+ "output2": [
+ {
+ "bcdt_code": "Y0101",
+ "hts_kor_isnm": "국고채 3년",
+ "bond_mnrt_prpr": "3.4080",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0580",
+ "bstp_nmix_prdy_ctrt": "-1.67",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0102",
+ "hts_kor_isnm": "회사채 무보증 3년AA-",
+ "bond_mnrt_prpr": "3.9630",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0530",
+ "bstp_nmix_prdy_ctrt": "-1.32",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0103",
+ "hts_kor_isnm": "회사채 3년 BBB-",
+ "bond_mnrt_prpr": "10.1690",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0510",
+ "bstp_nmix_prdy_ctrt": "-0.50",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0104",
+ "hts_kor_isnm": "국고채 1년",
+ "bond_mnrt_prpr": "3.4360",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0220",
+ "bstp_nmix_prdy_ctrt": "-0.64",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0105",
+ "hts_kor_isnm": "국고채 5년",
+ "bond_mnrt_prpr": "3.4690",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0420",
+ "bstp_nmix_prdy_ctrt": "-1.20",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0106",
+ "hts_kor_isnm": "국고채 10년",
+ "bond_mnrt_prpr": "3.5460",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0390",
+ "bstp_nmix_prdy_ctrt": "-1.09",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0107",
+ "hts_kor_isnm": "국민주택1종 (5년)",
+ "bond_mnrt_prpr": "3.6010",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0390",
+ "bstp_nmix_prdy_ctrt": "-1.07",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0108",
+ "hts_kor_isnm": "한전채(3년)",
+ "bond_mnrt_prpr": "3.7120",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0490",
+ "bstp_nmix_prdy_ctrt": "-1.30",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0109",
+ "hts_kor_isnm": "통안증권(364일)",
+ "bond_mnrt_prpr": "3.3710",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0250",
+ "bstp_nmix_prdy_ctrt": "-0.74",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0110",
+ "hts_kor_isnm": "통안증권(2년)",
+ "bond_mnrt_prpr": "3.4190",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0500",
+ "bstp_nmix_prdy_ctrt": "-1.44",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0111",
+ "hts_kor_isnm": "산금채(1년)",
+ "bond_mnrt_prpr": "3.5560",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0280",
+ "bstp_nmix_prdy_ctrt": "-0.78",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0112",
+ "hts_kor_isnm": "C D (91일)",
+ "bond_mnrt_prpr": "3.5600",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0100",
+ "bstp_nmix_prdy_ctrt": "-0.28",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0113",
+ "hts_kor_isnm": "C P (91일)",
+ "bond_mnrt_prpr": "4.1800",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0100",
+ "bstp_nmix_prdy_ctrt": "-0.24",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0114",
+ "hts_kor_isnm": "콜 (1일)",
+ "bond_mnrt_prpr": "3.5000",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0400",
+ "bstp_nmix_prdy_ctrt": "1.16",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0115",
+ "hts_kor_isnm": "종합채권지수",
+ "bond_mnrt_prpr": "102.8100",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.3400",
+ "bstp_nmix_prdy_ctrt": "-0.33",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0116",
+ "hts_kor_isnm": "국고채 20년",
+ "bond_mnrt_prpr": "3.4640",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0310",
+ "bstp_nmix_prdy_ctrt": "-0.89",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0117",
+ "hts_kor_isnm": "국고채 30년",
+ "bond_mnrt_prpr": "3.3640",
+ "prdy_vrss_sign": "5",
+ "bond_mnrt_prdy_vrss": "-0.0240",
+ "bstp_nmix_prdy_ctrt": "-0.71",
+ "stck_bsop_date": "20240412"
+ },
+ {
+ "bcdt_code": "Y0198",
+ "hts_kor_isnm": "Call 지수",
+ "bond_mnrt_prpr": "190.2051",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0185",
+ "bstp_nmix_prdy_ctrt": "0.01",
+ "stck_bsop_date": "20240411"
+ },
+ {
+ "bcdt_code": "Y0199",
+ "hts_kor_isnm": "CD AAA 3개월(13주)",
+ "bond_mnrt_prpr": "203.2972",
+ "prdy_vrss_sign": "2",
+ "bond_mnrt_prdy_vrss": "0.0198",
+ "bstp_nmix_prdy_ctrt": "0.01",
+ "stck_bsop_date": "20240411"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/082_v1_국내주식-055_변동성완화장치VI-현황.md b/docs/broker/kis/rest/국내주식/업종/기타/082_v1_국내주식-055_변동성완화장치VI-현황.md
new file mode 100644
index 0000000..a440d46
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/082_v1_국내주식-055_변동성완화장치VI-현황.md
@@ -0,0 +1,563 @@
+# 변동성완화장치(VI) 현황
+
+- 원본 시트명: 변동성완화장치(VI) 현황
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: v1_국내주식-055
+- HTTP Method: GET
+- 실전 TR_ID: FHPST01390000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/inquire-vi-status
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+HTS(eFriend Plus) [0139] 변동성 완화장치(VI) 현황 데이터를 확인할 수 있는 API입니다.
+
+최근 30건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST01390000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_DIV_CLS_CODE | FID 분류 구분 코드 | string | Y | 2 | 0:전체 1:상승 2:하락 |
+| FID_COND_SCR_DIV_CODE | FID 조건 화면 분류 코드 | string | Y | 5 | 20139 |
+| FID_MRKT_CLS_CODE | FID 시장 구분 코드 | string | Y | 2 | 0:전체 K:거래소 Q:코스닥 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | |
+| FID_RANK_SORT_CLS_CODE | FID 순위 정렬 구분 코드 | string | Y | 2 | 0:전체1:정적2:동적3:정적&동적 |
+| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | 영업일 |
+| FID_TRGT_CLS_CODE | FID 대상 구분 코드 | string | Y | 32 | |
+| FID_TRGT_EXLS_CLS_CODE | FID 대상 제외 구분 코드 | string | Y | 32 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| mksc_shrn_iscd | 유가증권 단축 종목코드 | string | Y | 9 | |
+| vi_cls_code | VI발동상태 | string | Y | 1 | Y: 발동 / N: 해제 |
+| bsop_date | 영업 일자 | string | Y | 8 | |
+| cntg_vi_hour | VI발동시간 | string | Y | 6 | VI발동시간 |
+| vi_cncl_hour | VI해제시간 | string | Y | 6 | VI해제시간 |
+| vi_kind_code | VI종류코드 | string | Y | 1 | 1:정적 2:동적 3:정적&동적 |
+| vi_prc | VI발동가격 | string | Y | 10 | |
+| vi_stnd_prc | 정적VI발동기준가격 | string | Y | 10 | |
+| vi_dprt | 정적VI발동괴리율 | string | Y | 82 | % |
+| vi_dmc_stnd_prc | 동적VI발동기준가격 | string | Y | 10 | |
+| vi_dmc_dprt | 동적VI발동괴리율 | string | Y | 82 | % |
+| vi_count | VI발동횟수 | string | Y | 7 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "fid_cond_scr_div_code":"20139",
+ "fid_mrkt_cls_code":"0",
+ "fid_input_iscd":"",
+ "fid_rank_sort_cls_code":"0",
+ "fid_input_date_1":"20240126",
+ "fid_trgt_cls_code":"",
+ "fid_trgt_exls_cls_code":"",
+ "fid_div_cls_code":"0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "hts_kor_isnm": "KODEX Fn멀티팩터",
+ "mksc_shrn_iscd": "337120",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "174012",
+ "vi_cncl_hour": "174212",
+ "vi_kind_code": "2",
+ "vi_prc": "12135",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "13275",
+ "vi_dmc_dprt": "-8.59",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "루멘스",
+ "mksc_shrn_iscd": "038060",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "174008",
+ "vi_cncl_hour": "174210",
+ "vi_kind_code": "2",
+ "vi_prc": "1337",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "1241",
+ "vi_dmc_dprt": "7.74",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "DL건설",
+ "mksc_shrn_iscd": "001880",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "173030",
+ "vi_cncl_hour": "173234",
+ "vi_kind_code": "2",
+ "vi_prc": "14000",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "14990",
+ "vi_dmc_dprt": "-6.60",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "성창기업지주",
+ "mksc_shrn_iscd": "000180",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "173030",
+ "vi_cncl_hour": "173224",
+ "vi_kind_code": "2",
+ "vi_prc": "1860",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "1992",
+ "vi_dmc_dprt": "-6.63",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "성창기업지주",
+ "mksc_shrn_iscd": "000180",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "172030",
+ "vi_cncl_hour": "172204",
+ "vi_kind_code": "2",
+ "vi_prc": "1992",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "1857",
+ "vi_dmc_dprt": "7.27",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "유아이디",
+ "mksc_shrn_iscd": "069330",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "172030",
+ "vi_cncl_hour": "172234",
+ "vi_kind_code": "2",
+ "vi_prc": "1640",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "1490",
+ "vi_dmc_dprt": "10.07",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "뷰웍스",
+ "mksc_shrn_iscd": "100120",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "172010",
+ "vi_cncl_hour": "172208",
+ "vi_kind_code": "2",
+ "vi_prc": "27700",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "29700",
+ "vi_dmc_dprt": "-6.73",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "TIGER 미국배당+3%프리미엄다우존스",
+ "mksc_shrn_iscd": "458750",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "171030",
+ "vi_cncl_hour": "171212",
+ "vi_kind_code": "2",
+ "vi_prc": "11700",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "10675",
+ "vi_dmc_dprt": "9.60",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "아스타",
+ "mksc_shrn_iscd": "246720",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "171030",
+ "vi_cncl_hour": "171253",
+ "vi_kind_code": "2",
+ "vi_prc": "5100",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "5490",
+ "vi_dmc_dprt": "-7.10",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "제일전기공업",
+ "mksc_shrn_iscd": "199820",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "170030",
+ "vi_cncl_hour": "170232",
+ "vi_kind_code": "2",
+ "vi_prc": "10050",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "9350",
+ "vi_dmc_dprt": "7.49",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "파인디지털",
+ "mksc_shrn_iscd": "038950",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "170030",
+ "vi_cncl_hour": "170244",
+ "vi_kind_code": "2",
+ "vi_prc": "5200",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "4800",
+ "vi_dmc_dprt": "8.33",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "엔시트론",
+ "mksc_shrn_iscd": "101400",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "170013",
+ "vi_cncl_hour": "170218",
+ "vi_kind_code": "2",
+ "vi_prc": "644",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "604",
+ "vi_dmc_dprt": "6.62",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "TIGER 2차전지TOP10",
+ "mksc_shrn_iscd": "364980",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "165030",
+ "vi_cncl_hour": "165250",
+ "vi_kind_code": "2",
+ "vi_prc": "12450",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "13740",
+ "vi_dmc_dprt": "-9.39",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "지니너스",
+ "mksc_shrn_iscd": "389030",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "165030",
+ "vi_cncl_hour": "165222",
+ "vi_kind_code": "2",
+ "vi_prc": "2270",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "2125",
+ "vi_dmc_dprt": "6.82",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "패션플랫폼",
+ "mksc_shrn_iscd": "225590",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "165030",
+ "vi_cncl_hour": "165228",
+ "vi_kind_code": "2",
+ "vi_prc": "1263",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "1153",
+ "vi_dmc_dprt": "9.54",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "씨엔플러스",
+ "mksc_shrn_iscd": "115530",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "165030",
+ "vi_cncl_hour": "165240",
+ "vi_kind_code": "2",
+ "vi_prc": "344",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "368",
+ "vi_dmc_dprt": "-6.52",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "케이비제22호스팩",
+ "mksc_shrn_iscd": "436530",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "164030",
+ "vi_cncl_hour": "164208",
+ "vi_kind_code": "2",
+ "vi_prc": "4455",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "4795",
+ "vi_dmc_dprt": "-7.09",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "제너셈",
+ "mksc_shrn_iscd": "217190",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "164030",
+ "vi_cncl_hour": "164230",
+ "vi_kind_code": "2",
+ "vi_prc": "14980",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "15990",
+ "vi_dmc_dprt": "-6.32",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "아스타",
+ "mksc_shrn_iscd": "246720",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "163030",
+ "vi_cncl_hour": "163220",
+ "vi_kind_code": "2",
+ "vi_prc": "5550",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "5090",
+ "vi_dmc_dprt": "9.04",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "세니젠",
+ "mksc_shrn_iscd": "188260",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "163030",
+ "vi_cncl_hour": "163252",
+ "vi_kind_code": "2",
+ "vi_prc": "3955",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "4230",
+ "vi_dmc_dprt": "-6.50",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "KODEX Fn멀티팩터",
+ "mksc_shrn_iscd": "337120",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "163024",
+ "vi_cncl_hour": "163250",
+ "vi_kind_code": "2",
+ "vi_prc": "13280",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "12075",
+ "vi_dmc_dprt": "9.98",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "ES큐브",
+ "mksc_shrn_iscd": "050120",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "163017",
+ "vi_cncl_hour": "163228",
+ "vi_kind_code": "2",
+ "vi_prc": "3055",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "2860",
+ "vi_dmc_dprt": "6.82",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "무학",
+ "mksc_shrn_iscd": "033920",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162241",
+ "vi_kind_code": "2",
+ "vi_prc": "5220",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "4880",
+ "vi_dmc_dprt": "6.97",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "아이씨에이치",
+ "mksc_shrn_iscd": "368600",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162210",
+ "vi_kind_code": "2",
+ "vi_prc": "5860",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "5460",
+ "vi_dmc_dprt": "7.33",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "KBSTAR 2차전지TOP10",
+ "mksc_shrn_iscd": "465330",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162217",
+ "vi_kind_code": "2",
+ "vi_prc": "14475",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "13485",
+ "vi_dmc_dprt": "7.34",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "제너셈",
+ "mksc_shrn_iscd": "217190",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162232",
+ "vi_kind_code": "2",
+ "vi_prc": "15990",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "14910",
+ "vi_dmc_dprt": "7.24",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "알엔투테크놀로지",
+ "mksc_shrn_iscd": "148250",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162212",
+ "vi_kind_code": "2",
+ "vi_prc": "5390",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "4915",
+ "vi_dmc_dprt": "9.66",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "엑서지21",
+ "mksc_shrn_iscd": "043090",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162030",
+ "vi_cncl_hour": "162206",
+ "vi_kind_code": "2",
+ "vi_prc": "463",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "507",
+ "vi_dmc_dprt": "-8.68",
+ "vi_count": "2"
+ },
+ {
+ "hts_kor_isnm": "DL건설",
+ "mksc_shrn_iscd": "001880",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162028",
+ "vi_cncl_hour": "162214",
+ "vi_kind_code": "2",
+ "vi_prc": "15010",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "14000",
+ "vi_dmc_dprt": "7.21",
+ "vi_count": "1"
+ },
+ {
+ "hts_kor_isnm": "뷰웍스",
+ "mksc_shrn_iscd": "100120",
+ "vi_cls_code": "N",
+ "bsop_date": "20240126",
+ "cntg_vi_hour": "162015",
+ "vi_cncl_hour": "162207",
+ "vi_kind_code": "2",
+ "vi_prc": "27600",
+ "vi_stnd_prc": "0",
+ "vi_dprt": "0.00",
+ "vi_dmc_stnd_prc": "29700",
+ "vi_dmc_dprt": "-7.07",
+ "vi_count": "1"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/업종/기타/083_국내주식-141_종합-시황_공시제목.md b/docs/broker/kis/rest/국내주식/업종/기타/083_국내주식-141_종합-시황_공시제목.md
new file mode 100644
index 0000000..50f7ac8
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/업종/기타/083_국내주식-141_종합-시황_공시제목.md
@@ -0,0 +1,283 @@
+# 종합 시황_공시(제목)
+
+- 원본 시트명: 종합 시황_공시(제목)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 업종/기타
+- API ID: 국내주식-141
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01011800
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/news-title
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+종합 시황/공시(제목) API입니다.
+한국투자 HTS(eFriend Plus) > [0601] 종합 시황/공시 화면의 "우측 상단 리스트" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01011800 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_NEWS_OFER_ENTP_CODE | 뉴스 제공 업체 코드 | string | Y | 40 | 공백 필수 입력 |
+| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백 필수 입력 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 공백: 전체, 종목코드 : 해당코드가 등록된 뉴스 |
+| FID_TITL_CNTT | 제목 내용 | string | Y | 132 | 공백 필수 입력 |
+| FID_INPUT_DATE_1 | 입력 날짜 | string | Y | 10 | 공백: 현재기준, 조회일자(ex 00YYYYMMDD) |
+| FID_INPUT_HOUR_1 | 입력 시간 | string | Y | 10 | 공백: 현재기준, 조회시간(ex 0000HHMMSS) |
+| FID_RANK_SORT_CLS_CODE | 순위 정렬 구분 코드 | string | Y | 2 | 공백 필수 입력 |
+| FID_INPUT_SRNO | 입력 일련번호 | string | Y | 20 | 공백 필수 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | 200 | |
+| cntt_usiq_srno | 내용 조회용 일련번호 | string | Y | 20 | |
+| news_ofer_entp_code | 뉴스 제공 업체 코드 | string | Y | 1 | '2' /* 한경 news */
'3' /* 사용안함 */
'4' /* 이데일리 */
'5' /* 머니투데이 */
'6' /* 연합뉴스 */
'7' /* 인포스탁 */
'8' /* 아시아경제 */
'9' /* 뉴스핌 */
'A' /* 매일경제 */
'B' /* 헤럴드경제 */
'C' /* 파이낸셜 */
'D' /* 이투데이 */
'F' /* 장내공시 */
'G' /* 코스닥공시 */
'H' /* 프리보드공시*/
'I' /* 기타공시 */
'N' /* 코넥스공시 */
'J' /* 동향 */ /* 'L' 리서치 */
'K' /* 청약안내 전송 */
'M' /* 타사 추천종목 */
'O' /* edaily fx */
'U' /* 서울 경제 */
'V' /* 조선 경제 */
'X' /* CEO스코어 */
'Y' /* 이프렌드 Air 뉴스 */
'Z' /* 인베스트조선 */
'd' /* NSP통신 */ |
+| data_dt | 작성일자 | string | Y | 8 | |
+| data_tm | 작성시간 | string | Y | 6 | |
+| hts_pbnt_titl_cntt | HTS 공시 제목 내용 | string | Y | 400 | |
+| news_lrdv_code | 뉴스 대구분 | string | Y | 8 | 1:0:종합
1:FGHIN:공시
2:F:거래소
3:01:수시공시
3:02:공정공시
3:03:시장조치
3:04:신고사항
3:05:정기공시
3:06:특수공시
3:07:발행공시
3:08:지분공시
3:09:워런트공시
3:10:의결권행사공시
3:11:공정위공시
3:12:선물시장공시
3:A1:시장조치안내
3:A2:상장안내
3:A3:안내사항
3:A4:투자유의사항
3:A5:수익증권
3:A6:투자자참고사항
3:A7:뮤츄얼펀드
2:G:코스닥
3:01:수시공시
3:02:공정공시
3:03:시장조치
3:04:신고사항
3:05:정기공시
3:06:특수공시
3:07:발행공시
3:08:지분공시
3:09:워런트공시
3:10:의결권행사공시
3:11:공정위공시
3:12:선물시장공시
3:A1:시장조치안내
3:A2:상장안내
3:A3:안내사항
3:A4:투자유의사항
3:A5:수익증권
3:A6:투자자참고사항
3:A7:뮤츄얼펀드
2:N:코넥스
3:01:수시공시
3:02:공정공시
3:03:시장조치
3:04:신고사항
3:05:정기공시
3:06:특수공시
3:07:발행공시
3:08:지분공시
3:09:워런트공시
3:10:의결권행사공시
3:11:공정위공시
3:12:선물시장공시
3:A1:시장조치안내
3:A2:상장안내
3:A3:안내사항
3:A4:투자유의사항
3:A5:수익증권
3:A6:투자자참고사항
3:A7:뮤츄얼펀드
2:H:K-OTC
2:I:기타
1:6:연합뉴스
3:01:정치
3:02:경제
3:03:증권/금융
3:04:산업
3:05:사회
3:06:사건사고
3:07:문화
3:08:생활건강
3:09:IT. 과학
3:10:북한
3:11:국제
3:12:스포츠
3:13:기타
1:2:한경
3:01:증권
3:04:경제
3:03:부동산
3:07:IT/과학
3:08:정치
3:09:국제
3:10:사회
3:11:생활/문화
3:00:오피니언
3:12:스포츠
3:20:연예
3:18:보도자료
1:A:매경
3:01:경제
3:02:금융
3:03:산업/기업
3:04:중기/벤쳐/과기
3:05:증권
3:06:부동산
3:07:정치
3:08:사회
3:09:인물/동정
3:10:국제
3:11:문화
3:12:레저/스포츠
3:13:사설/칼럼
3:14:기획/분석
3:15:섹션
3:16:English News
3:17:매경이코노미
3:18:mbn
3:90:기타
1:4:이데일리
3:B1:채권시황
3:B2:신종채권
3:F1:외환시황
3:G1:보도자료
3:H1:정책뉴스
3:H2:금융뉴스
3:H3:금융금리/수익율
3:I1:IPO뉴스
3:J1:뉴욕
3:J2:아시아/유럽
3:J3:월드마켓
3:J4:국제기업/산업
3:J5:경제흐름
3:L1:기업뉴스
3:L2:IT
3:L3:벤처
3:L4:e3비즈월드
3:S1:주식시황
3:S2:거래소
3:S3:코스닥&장외
3:S4:루머
3:S5:증권가
1:5:머니투데이
3:A01:주식
3:A02:선물옵션
3:A05:해외증시
3:A06:외환
3:A07:채권
3:A08:펀드
3:B01:경제
3:B02:산업
3:B03:정보과학
3:B04:국제
3:B05:금융보험
3:B07:부동산
3:B08:성공학
3:B09:재테크
3:B10:바이오
1:9:뉴스핌
3:01:주식
3:02:채권
3:03:외환
3:04:국제
3:05:금융/제테크
3:06:산업
3:07:경제
3:08:광장
3:09:전문가기고
3:90:기타
1:8:아시아경제
3:A0:증권
3:B0:금융
3:C0:부동산
3:D0:산업
3:E0:경제
3:F0:정치,사회
3:G0:사설,칼럼
3:H0:인사,동정,부고
3:I0:루머&팩트
3:J0:국내뉴스
3:K0:아시아시각
3:L0:골프
3:M0:모닝브리핑
3:N0:연예
3:10:국제
3:20:중국
3:30:인도
3:40:일본
3:50:이머징마켓
1:B:헤럴드경제
3:01:뉴스
3:02:기업
3:03:재테크
3:04:스타
3:05:문화
3:90:기타
1:C:파이낸셜
3:01:증권
3:02:금융
3:03:부동산
3:04:산업
3:05:경제
3:06:정보과학
3:07:유통
3:08:국제
3:09:정치
3:10:전국/사회
3:11:문화
3:12:스포츠
3:13:교육
3:14:피플
3:15:사설/컬럼
3:16:기획/연재
3:17:fn재테크
3:18:광고
3:90:기타
1:D:이투데이
3:21:증권
3:51:금융
3:22:정치/정책
3:31:글로벌
3:23:산업
3:24:부동산
3:26:라이프
3:25:칼럼/인물
3:41:연예/스포츠
3:90:기타
1:U:서울경제
3:31:증권
3:32:부동산
3:33:경제/금융
3:34:산업/기업
3:35:IT/과학
3:36:정치
3:37:사회
3:38:국제
3:39:칼럼
3:3A:인사/동정/부음
3:3B:문화/건강/레저
3:3C:골프/스포츠
1:V:조선경제i
3:1:뉴스
3:2:Market
3:4:부동산
3:6:글로벌경제
3:8:위클리비즈
3:B:자동차
3:C:녹색BIZ
1:7:인포스탁
3:01:거래소종목
3:02:코스닥종목
3:03:해외증시
3:04:선물동향
3:00:기타
1:X:CEO스코어
3:01:경제
3:02:산업
3:03:금융
3:04:공기업
3:05:전자
3:06:통신
3:07:게임,인터넷
3:08:자동차
3:09:조선,철강
3:10:식음료
3:11:유통
3:12:건설
3:13:제약
3:14:화학,에너지
3:15:생활산업
3:16:기타
1:S:컨슈머타임스
3:01:종합
3:02:파이낸셜컨슈머
3:03:컨슈머리뷰
3:04:정치,사회
3:05:스포츠,연예
3:06:컨슈머뷰티
3:07:오피니언
3:09:기타
1:Z:인베스트조선
3:01:증권/금융
1:d:NSP통신
3:11:IT/과학
3:12:금융/증권
3:13:부동산
3:14:자동차
3:15:연예/문화
3:16:생활경제
3:17:물류/유통
3:18:인사/동정
3:19:정치/사회
3:20:기업
3:21:의학/건강
3:23:신상품/리뷰
3:24:해명/반론
1:a:IRGO
3:10:IR정보
3:20:IR일정
3:50:IR FOCUS
1:Y:eFriend Air
3:01:종목상담
3:02:VOD
1:J:동향
1:L:한투리서치 |
+| dorg | 자료원 | string | Y | 20 | |
+| iscd1 | 종목 코드1 | string | Y | 9 | |
+| iscd2 | 종목 코드2 | string | Y | 9 | |
+| iscd3 | 종목 코드3 | string | Y | 9 | |
+| iscd4 | 종목 코드4 | string | Y | 9 | |
+| iscd5 | 종목 코드5 | string | Y | 9 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_NEWS_OFER_ENTP_CODE:
+FID_COND_MRKT_CLS_CODE:
+FID_INPUT_ISCD:
+FID_TITL_CNTT:
+FID_INPUT_DATE_1:
+FID_INPUT_HOUR_1:
+FID_RANK_SORT_CLS_CODE:
+FID_INPUT_SRNO:
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "cntt_usiq_srno": "2024041217173779111",
+ "news_ofer_entp_code": "9",
+ "data_dt": "20240412",
+ "data_tm": "171737",
+ "hts_pbnt_titl_cntt": "금융투자협회, 인도 기프트 시티 규제당국 IFSCA와 라운드테이블",
+ "news_lrdv_code": "10",
+ "dorg": "뉴스핌",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024041217173438610",
+ "news_ofer_entp_code": "5",
+ "data_dt": "20240412",
+ "data_tm": "171734",
+ "hts_pbnt_titl_cntt": "미국 매출 90% 껑충…BBQ, 지난해 4730억원 사상최대 매출",
+ "news_lrdv_code": "B02",
+ "dorg": "머니투데이",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024041217172998812",
+ "news_ofer_entp_code": "9",
+ "data_dt": "20240412",
+ "data_tm": "171729",
+ "hts_pbnt_titl_cntt": "한미-한국여자의사회 제정 '젊은의학자학술상'에 정선재 부교수",
+ "news_lrdv_code": "10",
+ "dorg": "뉴스핌",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024041217165428809",
+ "news_ofer_entp_code": "6",
+ "data_dt": "20240412",
+ "data_tm": "171654",
+ "hts_pbnt_titl_cntt": "[亞증시-종합] 강달러 속 혼조",
+ "news_lrdv_code": "03",
+ "dorg": "연합뉴스",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024041217161911807",
+ "news_ofer_entp_code": "5",
+ "data_dt": "20240412",
+ "data_tm": "171619",
+ "hts_pbnt_titl_cntt": "골드팡, 'Hello Spring' 진행..최대 61% 할인 이벤트",
+ "news_lrdv_code": "B02",
+ "dorg": "머니투데이",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024041217161867008",
+ "news_ofer_entp_code": "7",
+ "data_dt": "20240412",
+ "data_tm": "171618",
+ "hts_pbnt_titl_cntt": "자람테크놀로지, 임원ㆍ주요주주 특정증권등 소유주식수 변동",
+ "news_lrdv_code": "02",
+ "dorg": "인포스탁",
+ "iscd1": "389020",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": "자람테크놀로지",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/084_v1_국내주식-029_상품기본조회.md b/docs/broker/kis/rest/국내주식/종목정보/084_v1_국내주식-029_상품기본조회.md
new file mode 100644
index 0000000..40b0168
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/084_v1_국내주식-029_상품기본조회.md
@@ -0,0 +1,126 @@
+# 상품기본조회
+
+- 원본 시트명: 상품기본조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-029
+- HTTP Method: GET
+- 실전 TR_ID: CTPF1604R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/search-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF1604R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PDNO | 상품번호 | string | Y | 12 | '주식(하이닉스) : 000660 (코드 : 300)
선물(101S12) : KR4101SC0009 (코드 : 301)
미국(AAPL) : AAPL (코드 : 512)' |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | '300 주식
301 선물옵션
302 채권
512 미국 나스닥 / 513 미국 뉴욕 / 529 미국 아멕스
515 일본
501 홍콩 / 543 홍콩CNY / 558 홍콩USD
507 베트남 하노이 / 508 베트남 호치민
551 중국 상해A / 552 중국 심천A' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_name120 | 상품명120 | string | Y | 120 | |
+| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
+| prdt_eng_name | 상품영문명 | string | Y | 60 | |
+| prdt_eng_name120 | 상품영문명120 | string | Y | 120 | |
+| prdt_eng_abrv_name | 상품영문약어명 | string | Y | 60 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | |
+| prdt_sale_stat_cd | 상품판매상태코드 | string | Y | 2 | |
+| prdt_risk_grad_cd | 상품위험등급코드 | string | Y | 2 | |
+| prdt_clsf_cd | 상품분류코드 | string | Y | 6 | |
+| prdt_clsf_name | 상품분류명 | string | Y | 60 | |
+| sale_strt_dt | 판매시작일자 | string | Y | 8 | |
+| sale_end_dt | 판매종료일자 | string | Y | 8 | |
+| wrap_asst_type_cd | 랩어카운트자산유형코드 | string | Y | 2 | |
+| ivst_prdt_type_cd | 투자상품유형코드 | string | Y | 4 | |
+| ivst_prdt_type_cd_name | 투자상품유형코드명 | string | Y | 60 | |
+| frst_erlm_dt | 최초등록일자 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "PDNO":"AAPL",
+ "PRDT_TYPE_CD":"512"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "pdno": "AAPL",
+ "prdt_type_cd": "512",
+ "prdt_name": "애플",
+ "prdt_name120": "애플",
+ "prdt_abrv_name": "애플",
+ "prdt_eng_name": "APPLE INC",
+ "prdt_eng_name120": "APPLE INC",
+ "prdt_eng_abrv_name": "APPLE INC",
+ "std_pdno": "US0378331005",
+ "shtn_pdno": "AAPL",
+ "prdt_sale_stat_cd": "",
+ "prdt_risk_grad_cd": "",
+ "prdt_clsf_cd": "101210",
+ "prdt_clsf_name": "해외주식",
+ "sale_strt_dt": "",
+ "sale_end_dt": "",
+ "wrap_asst_type_cd": "06",
+ "ivst_prdt_type_cd": "1012",
+ "ivst_prdt_type_cd_name": "해외주식",
+ "frst_erlm_dt": ""
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/085_국내주식-150_예탁원정보상장정보일정.md b/docs/broker/kis/rest/국내주식/종목정보/085_국내주식-150_예탁원정보상장정보일정.md
new file mode 100644
index 0000000..3f66843
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/085_국내주식-150_예탁원정보상장정보일정.md
@@ -0,0 +1,1072 @@
+# 예탁원정보(상장정보일정)
+
+- 원본 시트명: 예탁원정보(상장정보일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-150
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669107C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/list-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(상장정보일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0666] 상장정보 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669107C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| CTS | CTS | string | Y | 17 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| list_dt | 상장/등록일 | string | Y | 10 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| stk_kind | 주식종류 | string | Y | 10 | |
+| issue_type | 사유 | string | Y | 21 | |
+| issue_stk_qty | 상장주식수 | string | Y | 12 | |
+| tot_issue_stk_qty | 총발행주식수 | string | Y | 12 | |
+| issue_price | 발행가 | string | Y | 9 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "list_dt": "20240326",
+ "sht_cd": "034220",
+ "isin_name": "LG디스플레이",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 142184300",
+ "tot_issue_stk_qty": " 500000000",
+ "issue_price": " 9090"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "047560",
+ "isin_name": "이스트소프트",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 13000",
+ "tot_issue_stk_qty": " 11488232",
+ "issue_price": " 15000"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "054180",
+ "isin_name": "메디콕스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 2348484",
+ "tot_issue_stk_qty": " 57151168",
+ "issue_price": " 792"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "067310",
+ "isin_name": "하나마이크론",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 5500",
+ "tot_issue_stk_qty": " 52136475",
+ "issue_price": " 9275"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "146060",
+ "isin_name": "율촌",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 2391679",
+ "tot_issue_stk_qty": " 24015595",
+ "issue_price": " 1154"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "403490",
+ "isin_name": "우듬지팜",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 288000",
+ "tot_issue_stk_qty": " 45212464",
+ "issue_price": " 1000"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 1648000",
+ "tot_issue_stk_qty": " 14322012",
+ "issue_price": " 20000"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 692224",
+ "tot_issue_stk_qty": " 14322012",
+ "issue_price": " 2891"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_kind": "보통",
+ "issue_type": "통일교체",
+ "issue_stk_qty": " 8850720",
+ "tot_issue_stk_qty": " 14322012",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240326",
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 161120",
+ "tot_issue_stk_qty": " 14322012",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "007980",
+ "isin_name": "태평양물산",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 162337",
+ "tot_issue_stk_qty": " 51175130",
+ "issue_price": " 1848"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "119650",
+ "isin_name": "케이씨코트렐",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 12733857",
+ "tot_issue_stk_qty": " 63669287",
+ "issue_price": " 1380"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "123840",
+ "isin_name": "뉴온",
+ "stk_kind": "보통",
+ "issue_type": "합병",
+ "issue_stk_qty": " 175537376",
+ "tot_issue_stk_qty": " 277394122",
+ "issue_price": " 100"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "151910",
+ "isin_name": "에스비더블유생명과학",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 1700680",
+ "tot_issue_stk_qty": " 190071722",
+ "issue_price": " 294"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "192230",
+ "isin_name": "아리바이오",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 16500",
+ "tot_issue_stk_qty": " 23632031",
+ "issue_price": " 7500"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "192650",
+ "isin_name": "드림텍",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 45000",
+ "tot_issue_stk_qty": " 68852050",
+ "issue_price": " 4518"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "222080",
+ "isin_name": "씨아이에스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 350261",
+ "tot_issue_stk_qty": " 71440876",
+ "issue_price": " 9707"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "373200",
+ "isin_name": "하인크코리아",
+ "stk_kind": "보통",
+ "issue_type": "무상증자",
+ "issue_stk_qty": " 56778657",
+ "tot_issue_stk_qty": " 75705657",
+ "issue_price": " 100"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "420570",
+ "isin_name": "제이투케이바이오",
+ "stk_kind": "보통",
+ "issue_type": "통일교체",
+ "issue_stk_qty": " 5059840",
+ "tot_issue_stk_qty": " 5574115",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240325",
+ "sht_cd": "420570",
+ "isin_name": "제이투케이바이오",
+ "stk_kind": "보통",
+ "issue_type": "합병",
+ "issue_stk_qty": " 514275",
+ "tot_issue_stk_qty": " 5574115",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "005320",
+ "isin_name": "국동",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 144300",
+ "tot_issue_stk_qty": " 66750697",
+ "issue_price": " 693"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "005810",
+ "isin_name": "풍산홀딩스",
+ "stk_kind": "보통",
+ "issue_type": "무상증자",
+ "issue_stk_qty": " 4668764",
+ "tot_issue_stk_qty": " 14417292",
+ "issue_price": " 5000"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "012510",
+ "isin_name": "더존비즈온",
+ "stk_kind": "보통",
+ "issue_type": "합병",
+ "issue_stk_qty": " 9423939",
+ "tot_issue_stk_qty": " 30382784",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "024850",
+ "isin_name": "에이치엘비이노베이션",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 2681010",
+ "tot_issue_stk_qty": " 72378055",
+ "issue_price": " 1022"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "036180",
+ "isin_name": "지더블유바이텍",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 28911564",
+ "tot_issue_stk_qty": " 91464525",
+ "issue_price": " 588"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "038460",
+ "isin_name": "바이오스마트",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 140230",
+ "tot_issue_stk_qty": " 21437123",
+ "issue_price": " 3209"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "060280",
+ "isin_name": "큐렉소",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 5000",
+ "tot_issue_stk_qty": " 41084990",
+ "issue_price": " 9510"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "066970",
+ "isin_name": "엘앤에프",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 168",
+ "tot_issue_stk_qty": " 36255993",
+ "issue_price": " 71430"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "115450",
+ "isin_name": "에이치엘비테라퓨틱스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 15351",
+ "tot_issue_stk_qty": " 77948338",
+ "issue_price": " 3619"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "197140",
+ "isin_name": "디지캡",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 16000",
+ "tot_issue_stk_qty": " 9596854",
+ "issue_price": " 4098"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "199730",
+ "isin_name": "바이오인프라",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 37500",
+ "tot_issue_stk_qty": " 4834367",
+ "issue_price": " 6667"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "314930",
+ "isin_name": "바이오다인",
+ "stk_kind": "보통",
+ "issue_type": "무상증자",
+ "issue_stk_qty": " 23581408",
+ "tot_issue_stk_qty": " 29764103",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "403550",
+ "isin_name": "쏘카",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 3125",
+ "tot_issue_stk_qty": " 32791402",
+ "issue_price": " 16000"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "440110",
+ "isin_name": "파두",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 34520",
+ "tot_issue_stk_qty": " 49072322",
+ "issue_price": " 7107"
+ },
+ {
+ "list_dt": "20240322",
+ "sht_cd": "441270",
+ "isin_name": "파인엠텍",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 42313",
+ "tot_issue_stk_qty": " 36928663",
+ "issue_price": " 7090"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "023960",
+ "isin_name": "에쓰씨엔지니어링",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 23132",
+ "tot_issue_stk_qty": " 32861366",
+ "issue_price": " 1513"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "064520",
+ "isin_name": "테크엘",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 50124",
+ "tot_issue_stk_qty": " 22005961",
+ "issue_price": " 3990"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "065650",
+ "isin_name": "메디프론디비티",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 3814835",
+ "tot_issue_stk_qty": " 63153285",
+ "issue_price": " 983"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "114840",
+ "isin_name": "아이패밀리에스씨",
+ "stk_kind": "보통",
+ "issue_type": "무상증자",
+ "issue_stk_qty": " 8600972",
+ "tot_issue_stk_qty": " 17201944",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "199800",
+ "isin_name": "툴젠",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 2000",
+ "tot_issue_stk_qty": " 7930258",
+ "issue_price": " 32850"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "222080",
+ "isin_name": "씨아이에스",
+ "stk_kind": "보통",
+ "issue_type": "합병",
+ "issue_stk_qty": " 544552",
+ "tot_issue_stk_qty": " 71440876",
+ "issue_price": " 11116"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "245620",
+ "isin_name": "이원다이애그노믹스",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 17633408",
+ "tot_issue_stk_qty": " 138493951",
+ "issue_price": " 431"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "323410",
+ "isin_name": "카카오뱅크",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 5000",
+ "tot_issue_stk_qty": " 476921137",
+ "issue_price": " 5000"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "417010",
+ "isin_name": "나노팀",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 228000",
+ "tot_issue_stk_qty": " 19724328",
+ "issue_price": " 2631"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "437730",
+ "isin_name": "삼현",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 2033333",
+ "tot_issue_stk_qty": " 10569189",
+ "issue_price": " 30000"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "437730",
+ "isin_name": "삼현",
+ "stk_kind": "보통",
+ "issue_type": "통일교체",
+ "issue_stk_qty": " 8535856",
+ "tot_issue_stk_qty": " 10569189",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240321",
+ "sht_cd": "452300",
+ "isin_name": "캡스톤파트너스",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 66250",
+ "tot_issue_stk_qty": " 14060755",
+ "issue_price": " 560"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "001210",
+ "isin_name": "금호전기",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 260416",
+ "tot_issue_stk_qty": " 38069709",
+ "issue_price": " 768"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "011300",
+ "isin_name": "성안",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 1828152",
+ "tot_issue_stk_qty": " 70551785",
+ "issue_price": " 1094"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "031310",
+ "isin_name": "아이즈비전",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 61859",
+ "tot_issue_stk_qty": " 22843356",
+ "issue_price": " 2829"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "067630",
+ "isin_name": "에이치엘비생명과학",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 20990",
+ "tot_issue_stk_qty": " 107122760",
+ "issue_price": " 11434"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "170900",
+ "isin_name": "동아에스티",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 56",
+ "tot_issue_stk_qty": " 8834970",
+ "issue_price": " 72359"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "255220",
+ "isin_name": "에스지이",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 1692045",
+ "tot_issue_stk_qty": " 61173984",
+ "issue_price": " 1182"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "255220",
+ "isin_name": "에스지이",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 87918",
+ "tot_issue_stk_qty": " 61173984",
+ "issue_price": " 1125"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "321550",
+ "isin_name": "티움바이오",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 220001",
+ "tot_issue_stk_qty": " 25662498",
+ "issue_price": " 7500"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "355150",
+ "isin_name": "코스텍시스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 186000",
+ "tot_issue_stk_qty": " 7706770",
+ "issue_price": " 5000"
+ },
+ {
+ "list_dt": "20240320",
+ "sht_cd": "457190",
+ "isin_name": "이수스페셜티케미컬",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 1059",
+ "tot_issue_stk_qty": " 5599832",
+ "issue_price": " 18602"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "007280",
+ "isin_name": "한국특강",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 223713",
+ "tot_issue_stk_qty": " 60813311",
+ "issue_price": " 1788"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "032980",
+ "isin_name": "바이온",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 220264",
+ "tot_issue_stk_qty": " 40517904",
+ "issue_price": " 908"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "064800",
+ "isin_name": "젬백스링크",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 71123",
+ "tot_issue_stk_qty": " 107875617",
+ "issue_price": " 1406"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "073570",
+ "isin_name": "리튬포어스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 218575",
+ "tot_issue_stk_qty": " 35970918",
+ "issue_price": " 4575"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "082740",
+ "isin_name": "한화엔진 주식회사",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 11903148",
+ "tot_issue_stk_qty": " 83447142",
+ "issue_price": " 7520"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "174900",
+ "isin_name": "앱클론",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 130707",
+ "tot_issue_stk_qty": " 16423321",
+ "issue_price": " 10079"
+ },
+ {
+ "list_dt": "20240319",
+ "sht_cd": "367000",
+ "isin_name": "플래티어",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 21000",
+ "tot_issue_stk_qty": " 8388207",
+ "issue_price": " 4930"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "000040",
+ "isin_name": "케이알모터스",
+ "stk_kind": "보통",
+ "issue_type": "자본감소",
+ "issue_stk_qty": " 29132868",
+ "tot_issue_stk_qty": " 29132868",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "001720",
+ "isin_name": "신영증권",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 4950",
+ "tot_issue_stk_qty": " 9434532",
+ "issue_price": " 16233"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "114630",
+ "isin_name": "폴라리스우노",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 506512",
+ "tot_issue_stk_qty": " 77757548",
+ "issue_price": " 691"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "123840",
+ "isin_name": "뉴온",
+ "stk_kind": "보통",
+ "issue_type": "상호변경",
+ "issue_stk_qty": " 277394122",
+ "tot_issue_stk_qty": " 277394122",
+ "issue_price": " 100"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "214870",
+ "isin_name": "뉴지랩파마",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 13670000",
+ "tot_issue_stk_qty": " 46796106",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "217330",
+ "isin_name": "싸이토젠",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 3286",
+ "tot_issue_stk_qty": " 22423102",
+ "issue_price": " 15290"
+ },
+ {
+ "list_dt": "20240318",
+ "sht_cd": "311390",
+ "isin_name": "네오크레마",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 2922552",
+ "tot_issue_stk_qty": " 10979147",
+ "issue_price": " 6159"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "035720",
+ "isin_name": "카카오",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 154263",
+ "tot_issue_stk_qty": " 445243887",
+ "issue_price": " 28199"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "047920",
+ "isin_name": "에이치엘비제약",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 15000",
+ "tot_issue_stk_qty": " 31746701",
+ "issue_price": " 5608"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "059270",
+ "isin_name": "해성티피씨",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 33000",
+ "tot_issue_stk_qty": " 10797992",
+ "issue_price": " 3000"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "067630",
+ "isin_name": "에이치엘비생명과학",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 738038",
+ "tot_issue_stk_qty": " 107122760",
+ "issue_price": " 8889"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "079160",
+ "isin_name": "씨제이씨지브이",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 50",
+ "tot_issue_stk_qty": " 122432139",
+ "issue_price": " 17745"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "082740",
+ "isin_name": "한화엔진 주식회사",
+ "stk_kind": "보통",
+ "issue_type": "상호변경",
+ "issue_stk_qty": " 71543994",
+ "tot_issue_stk_qty": " 83447142",
+ "issue_price": " 1000"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "117670",
+ "isin_name": "알파홀딩스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 1645434",
+ "tot_issue_stk_qty": " 39641629",
+ "issue_price": " 942"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "139670",
+ "isin_name": "키네마스터",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 22899",
+ "tot_issue_stk_qty": " 14118810",
+ "issue_price": " 13100"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "140860",
+ "isin_name": "파크시스템스",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 2000",
+ "tot_issue_stk_qty": " 6970859",
+ "issue_price": " 25940"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "214330",
+ "isin_name": "금호에이치티",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 2384614",
+ "tot_issue_stk_qty": " 213914131",
+ "issue_price": " 650"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "261200",
+ "isin_name": "덴티스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 55358",
+ "tot_issue_stk_qty": " 15809700",
+ "issue_price": " 9032"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "272110",
+ "isin_name": "케이엔제이보통주",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 15000",
+ "tot_issue_stk_qty": " 7975395",
+ "issue_price": " 3000"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "282880",
+ "isin_name": "코윈테크",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 160365",
+ "tot_issue_stk_qty": " 10825983",
+ "issue_price": " 24943"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "288330",
+ "isin_name": "브릿지바이오테라퓨틱스",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 279328",
+ "tot_issue_stk_qty": " 24119154",
+ "issue_price": " 7160"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "348370",
+ "isin_name": "엔켐",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 2859",
+ "tot_issue_stk_qty": " 18694319",
+ "issue_price": " 78677"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "348370",
+ "isin_name": "엔켐",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 301947",
+ "tot_issue_stk_qty": " 18694319",
+ "issue_price": " 55648"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "384470",
+ "isin_name": "코어라인소프트",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 272453",
+ "tot_issue_stk_qty": " 12793664",
+ "issue_price": " 5322"
+ },
+ {
+ "list_dt": "20240315",
+ "sht_cd": "418620",
+ "isin_name": "이에이트",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 52000",
+ "tot_issue_stk_qty": " 9647677",
+ "issue_price": " 9761"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "052770",
+ "isin_name": "아이톡시",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 646825",
+ "tot_issue_stk_qty": " 43550918",
+ "issue_price": " 1260"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "084180",
+ "isin_name": "수성웹툰",
+ "stk_kind": "보통",
+ "issue_type": "상호변경",
+ "issue_stk_qty": " 115499325",
+ "tot_issue_stk_qty": " 115499325",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "091810",
+ "isin_name": "티웨이항공",
+ "stk_kind": "보통",
+ "issue_type": "주식전환",
+ "issue_stk_qty": " 14607425",
+ "tot_issue_stk_qty": " 215378976",
+ "issue_price": " 1643"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "139050",
+ "isin_name": "비에프랩스",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 19724",
+ "tot_issue_stk_qty": " 8644551",
+ "issue_price": " 10545"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "276240",
+ "isin_name": "엘리비젼",
+ "stk_kind": "보통",
+ "issue_type": "유상증자",
+ "issue_stk_qty": " 2360000",
+ "tot_issue_stk_qty": " 10413138",
+ "issue_price": " 500"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "311060",
+ "isin_name": "엘에이티",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 26000",
+ "tot_issue_stk_qty": " 7074134",
+ "issue_price": " 2063"
+ },
+ {
+ "list_dt": "20240314",
+ "sht_cd": "377300",
+ "isin_name": "카카오페이",
+ "stk_kind": "보통",
+ "issue_type": "STOCKOPTION행사",
+ "issue_stk_qty": " 2700",
+ "tot_issue_stk_qty": " 134470018",
+ "issue_price": " 34101"
+ },
+ {
+ "list_dt": "20240313",
+ "sht_cd": "000520",
+ "isin_name": "삼일제약",
+ "stk_kind": "보통",
+ "issue_type": "국내CB행사",
+ "issue_stk_qty": " 46474",
+ "tot_issue_stk_qty": " 19806074",
+ "issue_price": " 7531"
+ },
+ {
+ "list_dt": "20240313",
+ "sht_cd": "000520",
+ "isin_name": "삼일제약",
+ "stk_kind": "보통",
+ "issue_type": "국내BW행사",
+ "issue_stk_qty": " 1131380",
+ "tot_issue_stk_qty"
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/086_국내주식-151_예탁원정보공모주청약일정.md b/docs/broker/kis/rest/국내주식/종목정보/086_국내주식-151_예탁원정보공모주청약일정.md
new file mode 100644
index 0000000..317c43f
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/086_국내주식-151_예탁원정보공모주청약일정.md
@@ -0,0 +1,978 @@
+# 예탁원정보(공모주청약일정)
+
+- 원본 시트명: 예탁원정보(공모주청약일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-151
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669108C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/pub-offer
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(공모주청약일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0667] 공모주청약 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669108C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| fix_subscr_pri | 공모가 | string | Y | 12 | |
+| face_value | 액면가 | string | Y | 9 | |
+| subscr_dt | 청약기간 | string | Y | 23 | |
+| pay_dt | 납입일 | string | Y | 10 | |
+| refund_dt | 환불일 | string | Y | 10 | |
+| list_dt | 상장/등록일 | string | Y | 10 | |
+| lead_mgr | 주간사 | string | Y | 41 | |
+| pub_bf_cap | 공모전자본금 | string | Y | 12 | |
+| pub_af_cap | 공모후자본금 | string | Y | 12 | |
+| assign_stk_qty | 당사배정물량 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240325",
+ "sht_cd": "461030",
+ "isin_name": "아이엠비디엑스",
+ "fix_subscr_pri": " 13000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/03/25 ~ 2024/03/26",
+ "pay_dt": "2024/03/28",
+ "refund_dt": "2024/03/28",
+ "list_dt": "",
+ "lead_mgr": "미래에셋증권",
+ "pub_bf_cap": " 1141762",
+ "pub_af_cap": " 62500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240318",
+ "sht_cd": "475240",
+ "isin_name": "하나32호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/03/18 ~ 2024/03/19",
+ "pay_dt": "2024/03/21",
+ "refund_dt": "2024/03/21",
+ "list_dt": "2024/03/27",
+ "lead_mgr": "하나증권",
+ "pub_bf_cap": " 20000",
+ "pub_af_cap": " 75000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240314",
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "fix_subscr_pri": " 20000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "pay_dt": "2024/03/19",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/03/26",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 6648690",
+ "pub_af_cap": " 240000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240312",
+ "sht_cd": "437730",
+ "isin_name": "삼현",
+ "fix_subscr_pri": " 30000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/03/12 ~ 2024/03/13",
+ "pay_dt": "2024/03/15",
+ "refund_dt": "2024/03/15",
+ "list_dt": "2024/03/21",
+ "lead_mgr": "한국투자증권",
+ "pub_bf_cap": " 4267928",
+ "pub_af_cap": " 250000",
+ "assign_stk_qty": " 500000"
+ },
+ {
+ "record_date": "20240304",
+ "sht_cd": "036220",
+ "isin_name": "오상헬스케어",
+ "fix_subscr_pri": " 20000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/03/04 ~ 2024/03/05",
+ "pay_dt": "2024/03/07",
+ "refund_dt": "2024/03/07",
+ "list_dt": "",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 6542358",
+ "pub_af_cap": " 123750",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240226",
+ "sht_cd": "199430",
+ "isin_name": "케이엔알시스템",
+ "fix_subscr_pri": " 13500",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/26 ~ 2024/02/27",
+ "pay_dt": "2024/02/29",
+ "refund_dt": "2024/02/29",
+ "list_dt": "2024/03/07",
+ "lead_mgr": "DB금융투자",
+ "pub_bf_cap": " 870059",
+ "pub_af_cap": " 52600",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240222",
+ "sht_cd": "469900",
+ "isin_name": "하나31호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/22 ~ 2024/02/23",
+ "pay_dt": "2024/02/27",
+ "refund_dt": "2024/02/27",
+ "list_dt": "2024/03/05",
+ "lead_mgr": "하나증권",
+ "pub_bf_cap": " 60500",
+ "pub_af_cap": " 125000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240220",
+ "sht_cd": "472230",
+ "isin_name": "에스케이증권제11호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/20 ~ 2024/02/21",
+ "pay_dt": "2024/02/23",
+ "refund_dt": "2024/02/23",
+ "list_dt": "2024/03/04",
+ "lead_mgr": "SK증권",
+ "pub_bf_cap": " 15500",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240220",
+ "sht_cd": "473050",
+ "isin_name": "유안타제15호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/20 ~ 2024/02/21",
+ "pay_dt": "2024/02/23",
+ "refund_dt": "2024/02/23",
+ "list_dt": "2024/02/29",
+ "lead_mgr": "유안타증권",
+ "pub_bf_cap": " 51000",
+ "pub_af_cap": " 162500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240219",
+ "sht_cd": "468760",
+ "isin_name": "유진기업인수목적10호",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/19 ~ 2024/02/20",
+ "pay_dt": "2024/02/22",
+ "refund_dt": "2024/02/22",
+ "list_dt": "2024/02/29",
+ "lead_mgr": "유진투자증권",
+ "pub_bf_cap": " 24000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240219",
+ "sht_cd": "473370",
+ "isin_name": "비엔케이제2호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/02/19 ~ 2024/02/20",
+ "pay_dt": "2024/02/22",
+ "refund_dt": "2024/02/22",
+ "list_dt": "2024/03/05",
+ "lead_mgr": "비엔케이투자증권",
+ "pub_bf_cap": " 21000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "278470",
+ "isin_name": "에이피알",
+ "fix_subscr_pri": " 250000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/02/14 ~ 2024/02/15",
+ "pay_dt": "2024/02/19",
+ "refund_dt": "2024/02/19",
+ "list_dt": "2024/02/27",
+ "lead_mgr": "신한투자증권, 하나증권",
+ "pub_bf_cap": " 3637689",
+ "pub_af_cap": " 56850",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "068100",
+ "isin_name": "케이웨더",
+ "fix_subscr_pri": " 7000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/02/13 ~ 2024/02/14",
+ "pay_dt": "2024/02/16",
+ "refund_dt": "2024/02/16",
+ "list_dt": "2024/02/22",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 4454807",
+ "pub_af_cap": " 125000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "360350",
+ "isin_name": "코셈",
+ "fix_subscr_pri": " 16000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/02/13 ~ 2024/02/14",
+ "pay_dt": "2024/02/16",
+ "refund_dt": "2024/02/16",
+ "list_dt": "2024/02/23",
+ "lead_mgr": "키움증권",
+ "pub_bf_cap": " 2521985",
+ "pub_af_cap": " 75000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "418620",
+ "isin_name": "이에이트",
+ "fix_subscr_pri": " 20000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/02/13 ~ 2024/02/14",
+ "pay_dt": "2024/02/16",
+ "refund_dt": "2024/02/16",
+ "list_dt": "2024/02/23",
+ "lead_mgr": "한화투자증권",
+ "pub_bf_cap": " 4205888",
+ "pub_af_cap": " 141250",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240125",
+ "sht_cd": "415380",
+ "isin_name": "스튜디오삼익",
+ "fix_subscr_pri": " 18000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/25 ~ 2024/01/26",
+ "pay_dt": "2024/01/30",
+ "refund_dt": "2024/01/30",
+ "list_dt": "2024/02/06",
+ "lead_mgr": "DB금융투자",
+ "pub_bf_cap": " 1674999",
+ "pub_af_cap": " 106250",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240125",
+ "sht_cd": "472220",
+ "isin_name": "신영해피투모로우제10호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/01/25 ~ 2024/01/26",
+ "pay_dt": "2024/01/30",
+ "refund_dt": "2024/01/30",
+ "list_dt": "2024/02/06",
+ "lead_mgr": "신영증권",
+ "pub_bf_cap": " 11500",
+ "pub_af_cap": " 114375",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240123",
+ "sht_cd": "452400",
+ "isin_name": "이닉스",
+ "fix_subscr_pri": " 14000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/23 ~ 2024/01/24",
+ "pay_dt": "2024/01/26",
+ "refund_dt": "2024/01/26",
+ "list_dt": "2024/02/01",
+ "lead_mgr": "삼성증권㈜",
+ "pub_bf_cap": " 3000000",
+ "pub_af_cap": " 375000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240123",
+ "sht_cd": "469480",
+ "isin_name": "아이비케이에스제24호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/01/23 ~ 2024/01/24",
+ "pay_dt": "2024/01/26",
+ "refund_dt": "2024/01/26",
+ "list_dt": "",
+ "lead_mgr": "아이비케이투자증권㈜",
+ "pub_bf_cap": " 23000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240117",
+ "sht_cd": "105760",
+ "isin_name": "포스뱅크",
+ "fix_subscr_pri": " 18000",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/17 ~ 2024/01/18",
+ "pay_dt": "2024/01/22",
+ "refund_dt": "2024/01/22",
+ "list_dt": "2024/01/29",
+ "lead_mgr": "하나증권",
+ "pub_bf_cap": " 3905242",
+ "pub_af_cap": " 187500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240117",
+ "sht_cd": "460930",
+ "isin_name": "현대힘스",
+ "fix_subscr_pri": " 7300",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/17 ~ 2024/01/18",
+ "pay_dt": "2024/01/22",
+ "refund_dt": "2024/01/24",
+ "list_dt": "2024/01/26",
+ "lead_mgr": "미래에셋증권",
+ "pub_bf_cap": " 14800000",
+ "pub_af_cap": " 1306050",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240116",
+ "sht_cd": "440290",
+ "isin_name": "에이치비인베스트먼트",
+ "fix_subscr_pri": " 3400",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/16 ~ 2024/01/17",
+ "pay_dt": "2024/01/19",
+ "refund_dt": "2024/01/19",
+ "list_dt": "2024/01/25",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 10000000",
+ "pub_af_cap": " 833375",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240116",
+ "sht_cd": "457550",
+ "isin_name": "우진엔텍",
+ "fix_subscr_pri": " 5300",
+ "face_value": "000000500",
+ "subscr_dt": "2024/01/16 ~ 2024/01/17",
+ "pay_dt": "2024/01/19",
+ "refund_dt": "2024/01/19",
+ "list_dt": "2024/01/24",
+ "lead_mgr": "KB증권",
+ "pub_bf_cap": " 3574770",
+ "pub_af_cap": " 257500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20240115",
+ "sht_cd": "471050",
+ "isin_name": "대신밸런스제17호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2024/01/15 ~ 2024/01/16",
+ "pay_dt": "2024/01/18",
+ "refund_dt": "2024/01/18",
+ "list_dt": "2024/01/24",
+ "lead_mgr": "대신증권",
+ "pub_bf_cap": " 56000",
+ "pub_af_cap": " 137500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231214",
+ "sht_cd": "017860",
+ "isin_name": "디에스단석",
+ "fix_subscr_pri": " 100000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/12/14 ~ 2023/12/15",
+ "pay_dt": "2023/12/19",
+ "refund_dt": "2023/12/19",
+ "list_dt": "",
+ "lead_mgr": "KB증권,NH투자증권",
+ "pub_bf_cap": " 2530702",
+ "pub_af_cap": " 152500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231213",
+ "sht_cd": "469880",
+ "isin_name": "하나30호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/12/13 ~ 2023/12/14",
+ "pay_dt": "2023/12/18",
+ "refund_dt": "2023/12/18",
+ "list_dt": "2023/12/22",
+ "lead_mgr": "하나증권㈜",
+ "pub_bf_cap": " 30500",
+ "pub_af_cap": " 175000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231212",
+ "sht_cd": "467930",
+ "isin_name": "아이비케이에스제23호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/12/12 ~ 2023/12/13",
+ "pay_dt": "2023/12/15",
+ "refund_dt": "2023/12/15",
+ "list_dt": "2023/12/22",
+ "lead_mgr": "아이비케이투자증권",
+ "pub_bf_cap": " 23000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "439580",
+ "isin_name": "블루엠텍",
+ "fix_subscr_pri": " 19000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/12/04 ~ 2023/12/05",
+ "pay_dt": "2023/12/07",
+ "refund_dt": "2023/12/07",
+ "list_dt": "2023/12/13",
+ "lead_mgr": "하나증권,키움증권",
+ "pub_bf_cap": " 920819",
+ "pub_af_cap": " 35000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231201",
+ "sht_cd": "417200",
+ "isin_name": "엘에스머트리얼즈",
+ "fix_subscr_pri": " 6000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/12/01 ~ 2023/12/04",
+ "pay_dt": "2023/12/06",
+ "refund_dt": "2023/12/06",
+ "list_dt": "2023/12/12",
+ "lead_mgr": "키움증권,KB증권,이베스트투자증권,하이투",
+ "pub_bf_cap": " 29438830",
+ "pub_af_cap": " 1828125",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231127",
+ "sht_cd": "432470",
+ "isin_name": "케이엔에스",
+ "fix_subscr_pri": " 23000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/27 ~ 2023/11/28",
+ "pay_dt": "2023/11/30",
+ "refund_dt": "2023/11/30",
+ "list_dt": "2023/12/06",
+ "lead_mgr": "신영증권",
+ "pub_bf_cap": " 311106",
+ "pub_af_cap": " 18750",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231123",
+ "sht_cd": "338840",
+ "isin_name": "와이바이오로직스",
+ "fix_subscr_pri": " 9000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/23 ~ 2023/11/24",
+ "pay_dt": "2023/11/28",
+ "refund_dt": "2023/11/28",
+ "list_dt": "2023/12/05",
+ "lead_mgr": "유안타증권",
+ "pub_bf_cap": " 6639074",
+ "pub_af_cap": " 750000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231123",
+ "sht_cd": "465320",
+ "isin_name": "교보15호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/23 ~ 2023/11/24",
+ "pay_dt": "2023/11/28",
+ "refund_dt": "2023/11/28",
+ "list_dt": "",
+ "lead_mgr": "교보증권",
+ "pub_bf_cap": " 31000",
+ "pub_af_cap": " 350000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231123",
+ "sht_cd": "468510",
+ "isin_name": "삼성기업인수목적9호",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/23 ~ 2023/11/24",
+ "pay_dt": "2023/11/28",
+ "refund_dt": "2023/11/28",
+ "list_dt": "2023/12/04",
+ "lead_mgr": "삼성증권",
+ "pub_bf_cap": " 105000",
+ "pub_af_cap": " 1000000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231121",
+ "sht_cd": "355690",
+ "isin_name": "에이텀",
+ "fix_subscr_pri": " 18000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/21 ~ 2023/11/22",
+ "pay_dt": "2023/11/24",
+ "refund_dt": "2023/11/24",
+ "list_dt": "2023/12/01",
+ "lead_mgr": "하나증권",
+ "pub_bf_cap": " 2337840",
+ "pub_af_cap": " 81250",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231121",
+ "sht_cd": "466910",
+ "isin_name": "엔에이치기업인수목적30호",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/21 ~ 2023/11/22",
+ "pay_dt": "2023/11/24",
+ "refund_dt": "2023/11/24",
+ "list_dt": "2023/12/01",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 110000",
+ "pub_af_cap": " 200000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231116",
+ "sht_cd": "453860",
+ "isin_name": "에이에스텍",
+ "fix_subscr_pri": " 28000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/16 ~ 2023/11/17",
+ "pay_dt": "2023/11/21",
+ "refund_dt": "2023/11/21",
+ "list_dt": "2023/11/28",
+ "lead_mgr": "미래에셋증권",
+ "pub_bf_cap": " 2388750",
+ "pub_af_cap": " 175875",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231113",
+ "sht_cd": "402490",
+ "isin_name": "그린리소스",
+ "fix_subscr_pri": " 17000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/13 ~ 2023/11/14",
+ "pay_dt": "2023/11/16",
+ "refund_dt": "2023/11/16",
+ "list_dt": "2023/11/24",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 3247372",
+ "pub_af_cap": " 205000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231113",
+ "sht_cd": "452280",
+ "isin_name": "한선엔지니어링",
+ "fix_subscr_pri": " 7000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/13 ~ 2023/11/14",
+ "pay_dt": "2023/11/16",
+ "refund_dt": "2023/11/16",
+ "list_dt": "2023/11/24",
+ "lead_mgr": "대신증권",
+ "pub_bf_cap": " 6312500",
+ "pub_af_cap": " 531250",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231110",
+ "sht_cd": "448280",
+ "isin_name": "에코아이",
+ "fix_subscr_pri": " 34700",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/10 ~ 2023/11/13",
+ "pay_dt": "2023/11/15",
+ "refund_dt": "2023/11/15",
+ "list_dt": "2023/11/21",
+ "lead_mgr": "KB증권",
+ "pub_bf_cap": " 3884612",
+ "pub_af_cap": " 259875",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231109",
+ "sht_cd": "111380",
+ "isin_name": "동인기연",
+ "fix_subscr_pri": " 30000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/09 ~ 2023/11/10",
+ "pay_dt": "2023/11/14",
+ "refund_dt": "2023/11/14",
+ "list_dt": "2023/11/21",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 500000",
+ "pub_af_cap": " 44112",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231109",
+ "sht_cd": "352090",
+ "isin_name": "스톰테크",
+ "fix_subscr_pri": " 11000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/09 ~ 2023/11/10",
+ "pay_dt": "2023/11/14",
+ "refund_dt": "2023/11/14",
+ "list_dt": "2023/11/20",
+ "lead_mgr": "하이투자증권",
+ "pub_bf_cap": " 999559",
+ "pub_af_cap": " 83750",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231108",
+ "sht_cd": "450080",
+ "isin_name": "에코프로머티리얼즈",
+ "fix_subscr_pri": " 36200",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/08 ~ 2023/11/09",
+ "pay_dt": "2023/11/13",
+ "refund_dt": "2023/11/13",
+ "list_dt": "2023/11/17",
+ "lead_mgr": "미래에셋증권, NH투자증권, 하이투자증권",
+ "pub_bf_cap": " 28951079",
+ "pub_af_cap": " 1737120",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231106",
+ "sht_cd": "452300",
+ "isin_name": "캡스톤파트너스",
+ "fix_subscr_pri": " 4000",
+ "face_value": "000000200",
+ "subscr_dt": "2023/11/06 ~ 2023/11/07",
+ "pay_dt": "2023/11/09",
+ "refund_dt": "2023/11/09",
+ "list_dt": "2023/11/15",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 2340500",
+ "pub_af_cap": " 79800",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231102",
+ "sht_cd": "445090",
+ "isin_name": "에이직랜드",
+ "fix_subscr_pri": " 25000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/02 ~ 2023/11/03",
+ "pay_dt": "2023/11/07",
+ "refund_dt": "2023/11/07",
+ "list_dt": "2023/11/13",
+ "lead_mgr": "삼성증권",
+ "pub_bf_cap": " 3954495",
+ "pub_af_cap": " 329542",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231101",
+ "sht_cd": "365330",
+ "isin_name": "에스와이스틸텍",
+ "fix_subscr_pri": " 1800",
+ "face_value": "000000500",
+ "subscr_dt": "2023/11/01 ~ 2023/11/02",
+ "pay_dt": "2023/11/06",
+ "refund_dt": "2023/11/06",
+ "list_dt": "2023/11/13",
+ "lead_mgr": "KB증권",
+ "pub_bf_cap": " 11700000",
+ "pub_af_cap": " 875000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231101",
+ "sht_cd": "464440",
+ "isin_name": "한국제13호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/11/01 ~ 2023/11/02",
+ "pay_dt": "2023/11/06",
+ "refund_dt": "2023/11/06",
+ "list_dt": "2023/11/13",
+ "lead_mgr": "한국투자증권",
+ "pub_bf_cap": " 32000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 1000000"
+ },
+ {
+ "record_date": "20231031",
+ "sht_cd": "372320",
+ "isin_name": "큐로셀",
+ "fix_subscr_pri": " 20000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/31 ~ 2023/11/01",
+ "pay_dt": "2023/11/03",
+ "refund_dt": "2023/11/03",
+ "list_dt": "2023/11/09",
+ "lead_mgr": "삼성증권,미래에셋증권",
+ "pub_bf_cap": " 5982368",
+ "pub_af_cap": " 200000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231031",
+ "sht_cd": "413640",
+ "isin_name": "비아이매트릭스",
+ "fix_subscr_pri": " 13000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/31 ~ 2023/11/01",
+ "pay_dt": "2023/11/03",
+ "refund_dt": "2023/11/03",
+ "list_dt": "2023/11/09",
+ "lead_mgr": "아이비케이투자증권",
+ "pub_bf_cap": " 2985470",
+ "pub_af_cap": " 150000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231031",
+ "sht_cd": "446540",
+ "isin_name": "메가터치",
+ "fix_subscr_pri": " 4800",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/31 ~ 2023/11/01",
+ "pay_dt": "2023/11/03",
+ "refund_dt": "2023/11/03",
+ "list_dt": "2023/11/09",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 7707500",
+ "pub_af_cap": " 650000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231031",
+ "sht_cd": "451760",
+ "isin_name": "컨텍",
+ "fix_subscr_pri": " 22500",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/31 ~ 2023/11/01",
+ "pay_dt": "2023/11/03",
+ "refund_dt": "2023/11/03",
+ "list_dt": "2023/11/09",
+ "lead_mgr": "대신증권",
+ "pub_bf_cap": " 6169890",
+ "pub_af_cap": " 257500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231026",
+ "sht_cd": "088280",
+ "isin_name": "쏘닉스",
+ "fix_subscr_pri": " 7500",
+ "face_value": "000001000",
+ "subscr_dt": "2023/10/26 ~ 2023/10/27",
+ "pay_dt": "2023/10/31",
+ "refund_dt": "2023/10/31",
+ "list_dt": "2023/11/07",
+ "lead_mgr": "KB증권",
+ "pub_bf_cap": " 13598490",
+ "pub_af_cap": " 900000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231024",
+ "sht_cd": "464680",
+ "isin_name": "케이비제27호기업인수목적",
+ "fix_subscr_pri": " 2000",
+ "face_value": "000000100",
+ "subscr_dt": "2023/10/24 ~ 2023/10/25",
+ "pay_dt": "2023/10/27",
+ "refund_dt": "2023/10/27",
+ "list_dt": "2023/11/03",
+ "lead_mgr": "KB증권",
+ "pub_bf_cap": " 40500",
+ "pub_af_cap": " 312500",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231023",
+ "sht_cd": "221800",
+ "isin_name": "유투바이오",
+ "fix_subscr_pri": " 4400",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/23 ~ 2023/10/24",
+ "pay_dt": "2023/10/26",
+ "refund_dt": "2023/10/26",
+ "list_dt": "",
+ "lead_mgr": "신한투자증권",
+ "pub_bf_cap": " 5051020",
+ "pub_af_cap": " 141090",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231023",
+ "sht_cd": "240600",
+ "isin_name": "유진테크놀로지",
+ "fix_subscr_pri": " 17000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/23 ~ 2023/10/24",
+ "pay_dt": "2023/10/26",
+ "refund_dt": "2023/10/26",
+ "list_dt": "2023/11/02",
+ "lead_mgr": "NH투자증권",
+ "pub_bf_cap": " 2642734",
+ "pub_af_cap": " 131186",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231018",
+ "sht_cd": "432720",
+ "isin_name": "퀄리타스반도체",
+ "fix_subscr_pri": " 17000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/18 ~ 2023/10/19",
+ "pay_dt": "2023/10/23",
+ "refund_dt": "2023/10/23",
+ "list_dt": "2023/10/27",
+ "lead_mgr": "한국투자증권",
+ "pub_bf_cap": " 4476920",
+ "pub_af_cap": " 225000",
+ "assign_stk_qty": " 450000"
+ },
+ {
+ "record_date": "20231016",
+ "sht_cd": "396470",
+ "isin_name": "워트",
+ "fix_subscr_pri": " 6500",
+ "face_value": "000000100",
+ "subscr_dt": "2023/10/16 ~ 2023/10/17",
+ "pay_dt": "2023/10/19",
+ "refund_dt": "2023/10/19",
+ "list_dt": "2023/10/26",
+ "lead_mgr": "키움증권",
+ "pub_bf_cap": " 1200000",
+ "pub_af_cap": " 100000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231010",
+ "sht_cd": "246250",
+ "isin_name": "에스엘에스바이오",
+ "fix_subscr_pri": " 7000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/10 ~ 2023/10/11",
+ "pay_dt": "2023/10/13",
+ "refund_dt": "2023/10/13",
+ "list_dt": "2023/10/20",
+ "lead_mgr": "하나증권",
+ "pub_bf_cap": " 3432802",
+ "pub_af_cap": " 96250",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231010",
+ "sht_cd": "416180",
+ "isin_name": "신성에스티",
+ "fix_subscr_pri": " 26000",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/10 ~ 2023/10/11",
+ "pay_dt": "2023/10/13",
+ "refund_dt": "2023/10/13",
+ "list_dt": "2023/10/19",
+ "lead_mgr": "미래에셋증권",
+ "pub_bf_cap": " 3500658",
+ "pub_af_cap": " 250000",
+ "assign_stk_qty": " 0"
+ },
+ {
+ "record_date": "20231005",
+ "sht_cd": "445180",
+ "isin_name": "퓨릿",
+ "fix_subscr_pri": " 10700",
+ "face_value": "000000500",
+ "subscr_dt": "2023/10/05 ~ 2023/10/06",
+ "pay_dt": "2023/10/11",
+ "refu
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/087_v1_국내주식-080_국내주식-재무비율.md b/docs/broker/kis/rest/국내주식/종목정보/087_v1_국내주식-080_국내주식-재무비율.md
new file mode 100644
index 0000000..9602b62
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/087_v1_국내주식-080_국내주식-재무비율.md
@@ -0,0 +1,459 @@
+# 국내주식 재무비율
+
+- 원본 시트명: 국내주식 재무비율
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-080
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/financial-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 재무비율 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 우측의 '재무 비율' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| grs | 매출액 증가율 | string | Y | 124 | |
+| bsop_prfi_inrt | 영업 이익 증가율 | string | Y | 124 | 적자지속, 흑자전환, 적자전환인 경우 0으로 표시 |
+| ntin_inrt | 순이익 증가율 | string | Y | 124 | |
+| roe_val | ROE 값 | string | Y | 132 | |
+| eps | EPS | string | Y | 112 | |
+| sps | 주당매출액 | string | Y | 18 | |
+| bps | BPS | string | Y | 112 | |
+| rsrv_rate | 유보 비율 | string | Y | 84 | |
+| lblt_rate | 부채 비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "grs": "-14.33",
+ "bsop_prfi_inrt": "-84.86",
+ "ntin_inrt": "-72.17",
+ "roe_val": "4.14",
+ "eps": "2131.00",
+ "sps": "38120",
+ "bps": "52002.00",
+ "rsrv_rate": "39256.91",
+ "lblt_rate": "25.36"
+ },
+ {
+ "stac_yymm": "202309",
+ "grs": "-17.52",
+ "bsop_prfi_inrt": "-90.42",
+ "ntin_inrt": "-71.26",
+ "roe_val": "3.22",
+ "eps": "1244.00",
+ "sps": "37522",
+ "bps": "52068.00",
+ "rsrv_rate": "39306.65",
+ "lblt_rate": "24.89"
+ },
+ {
+ "stac_yymm": "202306",
+ "grs": "-20.15",
+ "bsop_prfi_inrt": "-95.36",
+ "ntin_inrt": "-85.29",
+ "roe_val": "1.70",
+ "eps": "434.00",
+ "sps": "36437",
+ "bps": "51385.00",
+ "rsrv_rate": "38789.91",
+ "lblt_rate": "24.80"
+ },
+ {
+ "stac_yymm": "202303",
+ "grs": "-18.05",
+ "bsop_prfi_inrt": "-95.47",
+ "ntin_inrt": "-86.10",
+ "roe_val": "1.61",
+ "eps": "206.00",
+ "sps": "37538",
+ "bps": "51529.00",
+ "rsrv_rate": "38898.83",
+ "lblt_rate": "26.21"
+ },
+ {
+ "stac_yymm": "202212",
+ "grs": "8.09",
+ "bsop_prfi_inrt": "-15.99",
+ "ntin_inrt": "39.46",
+ "roe_val": "17.07",
+ "eps": "8057.00",
+ "sps": "44494",
+ "bps": "50817.00",
+ "rsrv_rate": "38360.25",
+ "lblt_rate": "26.41"
+ },
+ {
+ "stac_yymm": "202209",
+ "grs": "14.15",
+ "bsop_prfi_inrt": "3.45",
+ "ntin_inrt": "9.44",
+ "roe_val": "13.18",
+ "eps": "4597.00",
+ "sps": "45494",
+ "bps": "49387.00",
+ "rsrv_rate": "37277.71",
+ "lblt_rate": "36.35"
+ },
+ {
+ "stac_yymm": "202206",
+ "grs": "20.09",
+ "bsop_prfi_inrt": "28.56",
+ "ntin_inrt": "33.66",
+ "roe_val": "14.36",
+ "eps": "3251.00",
+ "sps": "45633",
+ "bps": "46937.00",
+ "rsrv_rate": "35423.75",
+ "lblt_rate": "36.64"
+ },
+ {
+ "stac_yymm": "202203",
+ "grs": "18.95",
+ "bsop_prfi_inrt": "50.50",
+ "ntin_inrt": "58.57",
+ "roe_val": "14.77",
+ "eps": "1638.00",
+ "sps": "45803",
+ "bps": "45106.00",
+ "rsrv_rate": "34037.84",
+ "lblt_rate": "39.34"
+ },
+ {
+ "stac_yymm": "202112",
+ "grs": "18.07",
+ "bsop_prfi_inrt": "43.45",
+ "ntin_inrt": "51.12",
+ "roe_val": "13.92",
+ "eps": "5777.00",
+ "sps": "41163",
+ "bps": "43611.00",
+ "rsrv_rate": "32906.47",
+ "lblt_rate": "39.92"
+ },
+ {
+ "stac_yymm": "202109",
+ "grs": "15.85",
+ "bsop_prfi_inrt": "40.15",
+ "ntin_inrt": "46.81",
+ "roe_val": "13.72",
+ "eps": "4211.00",
+ "sps": "39855",
+ "bps": "42447.00",
+ "rsrv_rate": "32025.54",
+ "lblt_rate": "38.30"
+ },
+ {
+ "stac_yymm": "202106",
+ "grs": "19.18",
+ "bsop_prfi_inrt": "50.41",
+ "ntin_inrt": "60.69",
+ "roe_val": "12.21",
+ "eps": "2435.00",
+ "sps": "38000",
+ "bps": "40361.00",
+ "rsrv_rate": "30446.66",
+ "lblt_rate": "36.29"
+ },
+ {
+ "stac_yymm": "202103",
+ "grs": "18.19",
+ "bsop_prfi_inrt": "45.53",
+ "ntin_inrt": "46.20",
+ "roe_val": "10.64",
+ "eps": "1044.00",
+ "sps": "38505",
+ "bps": "39126.00",
+ "rsrv_rate": "29511.49",
+ "lblt_rate": "43.23"
+ },
+ {
+ "stac_yymm": "202012",
+ "grs": "2.78",
+ "bsop_prfi_inrt": "29.62",
+ "ntin_inrt": "21.48",
+ "roe_val": "9.99",
+ "eps": "3841.00",
+ "sps": "34862",
+ "bps": "39406.00",
+ "rsrv_rate": "29723.53",
+ "lblt_rate": "37.07"
+ },
+ {
+ "stac_yymm": "202009",
+ "grs": "2.78",
+ "bsop_prfi_inrt": "30.76",
+ "ntin_inrt": "19.92",
+ "roe_val": "10.02",
+ "eps": "2892.00",
+ "sps": "34401",
+ "bps": "39446.00",
+ "rsrv_rate": "29753.81",
+ "lblt_rate": "36.09"
+ },
+ {
+ "stac_yymm": "202006",
+ "grs": "-0.20",
+ "bsop_prfi_inrt": "13.74",
+ "ntin_inrt": "2.11",
+ "roe_val": "8.04",
+ "eps": "1528.00",
+ "sps": "31885",
+ "bps": "38534.00",
+ "rsrv_rate": "29063.37",
+ "lblt_rate": "32.67"
+ },
+ {
+ "stac_yymm": "202003",
+ "grs": "5.61",
+ "bsop_prfi_inrt": "3.43",
+ "ntin_inrt": "-3.15",
+ "roe_val": "7.62",
+ "eps": "720.00",
+ "sps": "32579",
+ "bps": "38053.00",
+ "rsrv_rate": "28699.75",
+ "lblt_rate": "34.19"
+ },
+ {
+ "stac_yymm": "201912",
+ "grs": "-5.48",
+ "bsop_prfi_inrt": "-52.84",
+ "ntin_inrt": "-50.98",
+ "roe_val": "8.69",
+ "eps": "3166.00",
+ "sps": "33919",
+ "bps": "37528.00",
+ "rsrv_rate": "28302.40",
+ "lblt_rate": "34.12"
+ },
+ {
+ "stac_yymm": "201909",
+ "grs": "-7.58",
+ "bsop_prfi_inrt": "-57.14",
+ "ntin_inrt": "-53.98",
+ "roe_val": "8.76",
+ "eps": "2396.00",
+ "sps": "33471",
+ "bps": "37600.00",
+ "rsrv_rate": "28356.77",
+ "lblt_rate": "34.14"
+ },
+ {
+ "stac_yymm": "201906",
+ "grs": "-8.85",
+ "bsop_prfi_inrt": "-57.95",
+ "ntin_inrt": "-55.02",
+ "roe_val": "8.30",
+ "eps": "1498.00",
+ "sps": "31950",
+ "bps": "36789.00",
+ "rsrv_rate": "27742.76",
+ "lblt_rate": "33.05"
+ },
+ {
+ "stac_yymm": "201903",
+ "grs": "-13.50",
+ "bsop_prfi_inrt": "-60.15",
+ "ntin_inrt": "-56.85",
+ "roe_val": "8.41",
+ "eps": "752.00",
+ "sps": "30848",
+ "bps": "36142.00",
+ "rsrv_rate": "27253.31",
+ "lblt_rate": "36.27"
+ },
+ {
+ "stac_yymm": "201812",
+ "grs": "1.75",
+ "bsop_prfi_inrt": "9.77",
+ "ntin_inrt": "5.12",
+ "roe_val": "19.63",
+ "eps": "6024.00",
+ "sps": "33458",
+ "bps": "35342.00",
+ "rsrv_rate": "26648.22",
+ "lblt_rate": "36.97"
+ },
+ {
+ "stac_yymm": "201809",
+ "grs": "6.28",
+ "bsop_prfi_inrt": "24.91",
+ "ntin_inrt": "19.88",
+ "roe_val": "21.47",
+ "eps": "4853.00",
+ "sps": "33572",
+ "bps": "32685.00",
+ "rsrv_rate": "26568.28",
+ "lblt_rate": "39.28"
+ },
+ {
+ "stac_yymm": "201806",
+ "grs": "6.72",
+ "bsop_prfi_inrt": "27.32",
+ "ntin_inrt": "21.31",
+ "roe_val": "20.88",
+ "eps": "3082.00",
+ "sps": "32482",
+ "bps": "31483.00",
+ "rsrv_rate": "25587.24",
+ "lblt_rate": "36.70"
+ },
+ {
+ "stac_yymm": "201803",
+ "grs": "19.82",
+ "bsop_prfi_inrt": "58.03",
+ "ntin_inrt": "52.11",
+ "roe_val": "21.96",
+ "eps": "1583.00",
+ "sps": "33017",
+ "bps": "30146.00",
+ "rsrv_rate": "24496.79",
+ "lblt_rate": "39.96"
+ },
+ {
+ "stac_yymm": "201712",
+ "grs": "18.68",
+ "bsop_prfi_inrt": "83.46",
+ "ntin_inrt": "85.63",
+ "roe_val": "21.01",
+ "eps": "5421.00",
+ "sps": "31414",
+ "bps": "28971.00",
+ "rsrv_rate": "23681.42",
+ "lblt_rate": "40.68"
+ },
+ {
+ "stac_yymm": "201709",
+ "grs": "16.87",
+ "bsop_prfi_inrt": "92.30",
+ "ntin_inrt": "91.40",
+ "roe_val": "20.06",
+ "eps": "3804.00",
+ "sps": "30021",
+ "bps": "28305.00",
+ "rsrv_rate": "23266.64",
+ "lblt_rate": "40.76"
+ },
+ {
+ "stac_yymm": "201706",
+ "grs": "10.75",
+ "bsop_prfi_inrt": "61.71",
+ "ntin_inrt": "68.81",
+ "roe_val": "19.25",
+ "eps": "2328.00",
+ "sps": "28399",
+ "bps": "26828.00",
+ "rsrv_rate": "22216.19",
+ "lblt_rate": "38.31"
+ },
+ {
+ "stac_yymm": "201703",
+ "grs": "1.54",
+ "bsop_prfi_inrt": "48.27",
+ "ntin_inrt": "46.29",
+ "roe_val": "16.21",
+ "eps": "929.00",
+ "sps": "25087",
+ "bps": "24184.00",
+ "rsrv_rate": "21617.29",
+ "lblt_rate": "39.20"
+ },
+ {
+ "stac_yymm": "201612",
+ "grs": "0.60",
+ "bsop_prfi_inrt": "10.70",
+ "ntin_inrt": "19.23",
+ "roe_val": "12.48",
+ "eps": "2735.00",
+ "sps": "24632",
+ "bps": "24340.00",
+ "rsrv_rate": "21757.56",
+ "lblt_rate": "35.87"
+ },
+ {
+ "stac_yymm": "201609",
+ "grs": "0.81",
+ "bsop_prfi_inrt": "-1.24",
+ "ntin_inrt": "-1.25",
+ "roe_val": "11.94",
+ "eps": "1881.00",
+ "sps": "24033",
+ "bps": "22708.00",
+ "rsrv_rate": "20291.88",
+ "lblt_rate": "36.17"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/088_국내주식-149_예탁원정보자본감소일정.md b/docs/broker/kis/rest/국내주식/종목정보/088_국내주식-149_예탁원정보자본감소일정.md
new file mode 100644
index 0000000..aa1248c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/088_국내주식-149_예탁원정보자본감소일정.md
@@ -0,0 +1,1110 @@
+# 예탁원정보(자본감소일정)
+
+- 원본 시트명: 예탁원정보(자본감소일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-149
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669106C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/cap-dcrs
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(자본감소일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0665] 자본감소 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669106C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| stk_kind | 주식종류 | string | Y | 10 | |
+| reduce_cap_type | 감자구분 | string | Y | 9 | |
+| reduce_cap_rate | 감자배정율 | string | Y | 142 | |
+| comp_way | 계산방법 | string | Y | 6 | |
+| td_stop_dt | 매매거래정지기간 | string | Y | 23 | |
+| list_dt | 상장/등록일 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240315",
+ "sht_cd": "067390",
+ "isin_name": "아스트",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/03/14 ~ 2024/03/31",
+ "list_dt": "2024/04/01"
+ },
+ {
+ "record_date": "20240226",
+ "sht_cd": "000040",
+ "isin_name": "케이알모터스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.30",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/02/23 ~ 2024/03/17",
+ "list_dt": "2024/03/18"
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "033180",
+ "isin_name": "케이에이치필룩스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/02/07 ~ 2024/02/28",
+ "list_dt": "2024/02/29"
+ },
+ {
+ "record_date": "20240207",
+ "sht_cd": "219750",
+ "isin_name": "지티지웰니스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 4.00",
+ "comp_way": "나누기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20240129",
+ "sht_cd": "057880",
+ "isin_name": "피에이치씨",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/01/26 ~ 2024/02/20",
+ "list_dt": "2024/02/21"
+ },
+ {
+ "record_date": "20240115",
+ "sht_cd": "001140",
+ "isin_name": "국보",
+ "stk_kind": "보통",
+ "reduce_cap_type": "",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/01/12 ~ 2024/02/01",
+ "list_dt": "2024/02/02"
+ },
+ {
+ "record_date": "20240108",
+ "sht_cd": "078130",
+ "isin_name": "국일제지",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2024/01/05 ~ 2024/02/21",
+ "list_dt": "2024/02/22"
+ },
+ {
+ "record_date": "20240102",
+ "sht_cd": "013090",
+ "isin_name": "인켈",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20240102",
+ "sht_cd": "013095",
+ "isin_name": "인켈1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20240102",
+ "sht_cd": "013097",
+ "isin_name": "인켈2우",
+ "stk_kind": "2우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231227",
+ "sht_cd": "078130",
+ "isin_name": "국일제지",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/26 ~ 2024/02/20",
+ "list_dt": "2024/02/21"
+ },
+ {
+ "record_date": "20231227",
+ "sht_cd": "088240",
+ "isin_name": "대우조선해양건설",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231226",
+ "sht_cd": "043590",
+ "isin_name": "웰킵스하이텍",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.75",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/22 ~ 2024/01/18",
+ "list_dt": "2024/01/19"
+ },
+ {
+ "record_date": "20231222",
+ "sht_cd": "227420",
+ "isin_name": "도부마스크",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": "2024/01/19"
+ },
+ {
+ "record_date": "20231218",
+ "sht_cd": "076610",
+ "isin_name": "해성옵틱스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/15 ~ 2024/01/07",
+ "list_dt": "2024/01/08"
+ },
+ {
+ "record_date": "20231218",
+ "sht_cd": "217480",
+ "isin_name": "에스디생명공학",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.70",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/15 ~ 2024/01/24",
+ "list_dt": "2024/01/25"
+ },
+ {
+ "record_date": "20231215",
+ "sht_cd": "321080",
+ "isin_name": "메타엠",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.43",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/14 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231214",
+ "sht_cd": "299910",
+ "isin_name": "베스파",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/13 ~ 2024/01/14",
+ "list_dt": "2024/01/15"
+ },
+ {
+ "record_date": "20231213",
+ "sht_cd": "314170",
+ "isin_name": "메디에이지",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/12 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "003560",
+ "isin_name": "아이에이치큐",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.33",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/08 ~ 2024/01/03",
+ "list_dt": "2024/01/04"
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "078860",
+ "isin_name": "아이오케이컴퍼니",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/08 ~ 2023/12/26",
+ "list_dt": "2023/12/27"
+ },
+ {
+ "record_date": "20231208",
+ "sht_cd": "088240",
+ "isin_name": "대우조선해양건설",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231208",
+ "sht_cd": "08824K",
+ "isin_name": "대우조선해양건설1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231208",
+ "sht_cd": "08824L",
+ "isin_name": "대우조선해양건설2우",
+ "stk_kind": "2우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231208",
+ "sht_cd": "08824M",
+ "isin_name": "대우조선해양건설3우",
+ "stk_kind": "3우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231207",
+ "sht_cd": "159910",
+ "isin_name": "스킨앤스킨",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/06 ~ 2023/12/26",
+ "list_dt": "2023/12/27"
+ },
+ {
+ "record_date": "20231205",
+ "sht_cd": "013090",
+ "isin_name": "인켈",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.01",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/04 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231205",
+ "sht_cd": "013095",
+ "isin_name": "인켈1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.01",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/04 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231205",
+ "sht_cd": "013097",
+ "isin_name": "인켈2우",
+ "stk_kind": "2우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.01",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/04 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "002880",
+ "isin_name": "대유에이텍",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 3.00",
+ "comp_way": "나누기",
+ "td_stop_dt": "2023/12/01 ~ 2023/12/19",
+ "list_dt": "2023/12/20"
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "174880",
+ "isin_name": "장원테크",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/01 ~ 2023/12/20",
+ "list_dt": "2023/12/21"
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "406830",
+ "isin_name": "여기어때컴퍼니",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.46",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/01 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "40683K",
+ "isin_name": "여기어때컴퍼니1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.46",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/12/01 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231129",
+ "sht_cd": "299910",
+ "isin_name": "베스파",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.33",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/28 ~ 2024/01/14",
+ "list_dt": "2024/01/15"
+ },
+ {
+ "record_date": "20231127",
+ "sht_cd": "412790",
+ "isin_name": "테람스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231123",
+ "sht_cd": "181690",
+ "isin_name": "디엔지비",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.25",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/22 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231117",
+ "sht_cd": "058450",
+ "isin_name": "엔터파트너즈",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/16 ~ 2023/12/11",
+ "list_dt": "2023/12/12"
+ },
+ {
+ "record_date": "20231117",
+ "sht_cd": "155960",
+ "isin_name": "지디",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/16 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231117",
+ "sht_cd": "186630",
+ "isin_name": "리치앤타임",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/16 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231113",
+ "sht_cd": "144620",
+ "isin_name": "코오롱머티리얼",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.75",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/10 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231107",
+ "sht_cd": "181690",
+ "isin_name": "디엔지비",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/06 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231106",
+ "sht_cd": "148140",
+ "isin_name": "비디아이",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/11/03 ~ 2023/12/11",
+ "list_dt": "2023/12/12"
+ },
+ {
+ "record_date": "20231101",
+ "sht_cd": "155900",
+ "isin_name": "바다로19호선박투자회사",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/31 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231030",
+ "sht_cd": "197210",
+ "isin_name": "리드",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/27 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231030",
+ "sht_cd": "238500",
+ "isin_name": "로보쓰리에이아이앤로보틱스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/27 ~ 2023/11/16",
+ "list_dt": "2023/11/17"
+ },
+ {
+ "record_date": "20231020",
+ "sht_cd": "148140",
+ "isin_name": "비디아이",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.25",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/19 ~ 2023/12/11",
+ "list_dt": "2023/12/12"
+ },
+ {
+ "record_date": "20231018",
+ "sht_cd": "115390",
+ "isin_name": "락앤락",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.86",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/17 ~ 2023/11/05",
+ "list_dt": "2023/11/06"
+ },
+ {
+ "record_date": "20231012",
+ "sht_cd": "326830",
+ "isin_name": "모르페우스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20231010",
+ "sht_cd": "005110",
+ "isin_name": "한창",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/10/06 ~ 2023/10/26",
+ "list_dt": "2023/10/27"
+ },
+ {
+ "record_date": "20230926",
+ "sht_cd": "065560",
+ "isin_name": "녹원씨엔아이",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/25 ~ 2023/10/22",
+ "list_dt": "2023/10/23"
+ },
+ {
+ "record_date": "20230925",
+ "sht_cd": "447800",
+ "isin_name": "브릿지벤처스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230922",
+ "sht_cd": "101140",
+ "isin_name": "인바이오젠",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/21 ~ 2023/10/22",
+ "list_dt": "2023/10/23"
+ },
+ {
+ "record_date": "20230922",
+ "sht_cd": "101145",
+ "isin_name": "인바이오젠1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/21 ~ 2023/10/22",
+ "list_dt": "2023/10/23"
+ },
+ {
+ "record_date": "20230919",
+ "sht_cd": "06911M",
+ "isin_name": "코스온3우",
+ "stk_kind": "3우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.17",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/18 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230914",
+ "sht_cd": "234760",
+ "isin_name": "고위드",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.72",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/13 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230912",
+ "sht_cd": "069110",
+ "isin_name": "코스온",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.17",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/11 ~ 2023/10/10",
+ "list_dt": "2023/10/11"
+ },
+ {
+ "record_date": "20230911",
+ "sht_cd": "046640",
+ "isin_name": "씨디데이타",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.40",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230907",
+ "sht_cd": "058420",
+ "isin_name": "제이웨이",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/06 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230907",
+ "sht_cd": "05842L",
+ "isin_name": "제이웨이2우",
+ "stk_kind": "2우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/06 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230906",
+ "sht_cd": "033180",
+ "isin_name": "케이에이치필룩스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.33",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/09/05 ~ 2023/10/03",
+ "list_dt": "2023/10/04"
+ },
+ {
+ "record_date": "20230823",
+ "sht_cd": "003560",
+ "isin_name": "아이에이치큐",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/08/22 ~ 2023/09/13",
+ "list_dt": "2023/09/14"
+ },
+ {
+ "record_date": "20230822",
+ "sht_cd": "036630",
+ "isin_name": "세종텔레콤",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.81",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/08/21 ~ 2023/09/07",
+ "list_dt": "2023/09/08"
+ },
+ {
+ "record_date": "20230822",
+ "sht_cd": "043420",
+ "isin_name": "에코이에스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.73",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230822",
+ "sht_cd": "220630",
+ "isin_name": "맘스터치앤컴퍼니",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.26",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/08/21 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230811",
+ "sht_cd": "000360",
+ "isin_name": "삼환기업",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/08/10 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230807",
+ "sht_cd": "048180",
+ "isin_name": "씨제이푸드빌",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.63",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230807",
+ "sht_cd": "434840",
+ "isin_name": "니즈게임즈",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.88",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/08/04 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230725",
+ "sht_cd": "111870",
+ "isin_name": "케이에이치전자",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/07/24 ~ 2023/08/16",
+ "list_dt": "2023/08/17"
+ },
+ {
+ "record_date": "20230720",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.20",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/07/19 ~ 2023/08/13",
+ "list_dt": "2023/08/14"
+ },
+ {
+ "record_date": "20230719",
+ "sht_cd": "203810",
+ "isin_name": "국제16호선박투자회사",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.16",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/07/18 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230710",
+ "sht_cd": "087800",
+ "isin_name": "KDB생명보험",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.25",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/07/07 ~ 2023/07/26",
+ "list_dt": "2023/07/27"
+ },
+ {
+ "record_date": "20230703",
+ "sht_cd": "038530",
+ "isin_name": "케이바이오컴퍼니",
+ "stk_kind": "보통",
+ "reduce_cap_type": "",
+ "reduce_cap_rate": " 1.00",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/06/30 ~ 2023/07/20",
+ "list_dt": "2023/07/21"
+ },
+ {
+ "record_date": "20230612",
+ "sht_cd": "197210",
+ "isin_name": "리드",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.04",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/06/09 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230612",
+ "sht_cd": "19721K",
+ "isin_name": "리드1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.04",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/06/09 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230608",
+ "sht_cd": "139050",
+ "isin_name": "시티랩스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.07",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/06/07 ~ 2023/06/27",
+ "list_dt": "2023/06/28"
+ },
+ {
+ "record_date": "20230515",
+ "sht_cd": "373560",
+ "isin_name": "페이투스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230509",
+ "sht_cd": "351160",
+ "isin_name": "케이온네트워크",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.58",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/05/08 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230508",
+ "sht_cd": "138690",
+ "isin_name": "엘아이에스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.04",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/05/04 ~ 2023/06/26",
+ "list_dt": "2023/06/27"
+ },
+ {
+ "record_date": "20230502",
+ "sht_cd": "115580",
+ "isin_name": "현대인프라코어",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/28 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230501",
+ "sht_cd": "333830",
+ "isin_name": "티비에스머티리얼",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.10",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230428",
+ "sht_cd": "113300",
+ "isin_name": "세명테크",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/27 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230424",
+ "sht_cd": "112240",
+ "isin_name": "에스에프씨",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/21 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230420",
+ "sht_cd": "050320",
+ "isin_name": "에스에이치엔엘",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230420",
+ "sht_cd": "05032K",
+ "isin_name": "에스에이치엔엘1우",
+ "stk_kind": "우선",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230418",
+ "sht_cd": "203810",
+ "isin_name": "국제16호선박투자회사",
+ "stk_kind": "보통",
+ "reduce_cap_type": "유상감자",
+ "reduce_cap_rate": " 0.91",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/17 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230418",
+ "sht_cd": "391360",
+ "isin_name": "버디버디(budybudy)",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/17 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230417",
+ "sht_cd": "141020",
+ "isin_name": "디에스앤엘",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.25",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/14 ~ 2023/05/08",
+ "list_dt": "2023/05/09"
+ },
+ {
+ "record_date": "20230417",
+ "sht_cd": "219750",
+ "isin_name": "지티지웰니스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/14 ~ 2023/05/07",
+ "list_dt": "2023/05/08"
+ },
+ {
+ "record_date": "20230417",
+ "sht_cd": "329820",
+ "isin_name": "정금에프앤씨",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.05",
+ "comp_way": "곱하기",
+ "td_stop_dt": "",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230413",
+ "sht_cd": "019570",
+ "isin_name": "리더스기술투자",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.33",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/12 ~ 2023/05/02",
+ "list_dt": "2023/05/03"
+ },
+ {
+ "record_date": "20230411",
+ "sht_cd": "050090",
+ "isin_name": "비케이홀딩스",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.25",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/04/10 ~ 2023/05/07",
+ "list_dt": "2023/05/08"
+ },
+ {
+ "record_date": "20230403",
+ "sht_cd": "362570",
+ "isin_name": "아이프리원",
+ "stk_kind": "보통",
+ "reduce_cap_type": "무상감자",
+ "reduce_cap_rate": " 0.50",
+ "comp_way": "곱하기",
+ "td_stop_dt": "2023/03/31 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230329",
+ "sht_cd": "101000",
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/089_국내주식-144_예탁원정보무상증자일정.md b/docs/broker/kis/rest/국내주식/종목정보/089_국내주식-144_예탁원정보무상증자일정.md
new file mode 100644
index 0000000..e965ea0
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/089_국내주식-144_예탁원정보무상증자일정.md
@@ -0,0 +1,167 @@
+# 예탁원정보(무상증자일정)
+
+- 원본 시트명: 예탁원정보(무상증자일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-144
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669101C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/bonus-issue
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(무상증자일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0656] 무상증자 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669101C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| fix_rate | 확정배정율 | string | Y | 152 | |
+| odd_rec_price | 단주기준가 | string | Y | 9 | |
+| right_dt | 권리락일 | string | Y | 8 | |
+| odd_pay_dt | 단주대금지급일 | string | Y | 23 | |
+| list_date | 상장/등록일 | string | Y | 8 | |
+| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
+| issue_stk_qty | 발행할주식 | string | Y | 12 | |
+| stk_kind | 주식종류 | string | Y | 2 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240326",
+ "sht_cd": "466100",
+ "isin_name": "클로봇",
+ "fix_rate": "1000.0",
+ "odd_rec_price": "000000000",
+ "right_dt": "20240325",
+ "odd_pay_dt": "",
+ "list_date": "",
+ "tot_issue_stk_qty": " 1885394",
+ "issue_stk_qty": " 18853940",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "473980",
+ "isin_name": "노머스",
+ "fix_rate": "3900.0",
+ "odd_rec_price": "000000000",
+ "right_dt": "20240314",
+ "odd_pay_dt": "",
+ "list_date": "",
+ "tot_issue_stk_qty": " 234220",
+ "issue_stk_qty": " 9134580",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240314",
+ "sht_cd": "377220",
+ "isin_name": "프롬바이오",
+ "fix_rate": "100.00",
+ "odd_rec_price": "000000000",
+ "right_dt": "20240313",
+ "odd_pay_dt": "",
+ "list_date": "20240405",
+ "tot_issue_stk_qty": " 14155000",
+ "issue_stk_qty": " 14155000",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240307",
+ "sht_cd": "357230",
+ "isin_name": "에이치피오",
+ "fix_rate": "100.00",
+ "odd_rec_price": "000000000",
+ "right_dt": "20240306",
+ "odd_pay_dt": "",
+ "list_date": "20240329",
+ "tot_issue_stk_qty": " 21149725",
+ "issue_stk_qty": " 20337240",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "005810",
+ "isin_name": "풍산홀딩스",
+ "fix_rate": " 50.00",
+ "odd_rec_price": "000029850",
+ "right_dt": "20240304",
+ "odd_pay_dt": "2024/03/29 ~ 2024/03/29",
+ "list_date": "20240322",
+ "tot_issue_stk_qty": " 9748528",
+ "issue_stk_qty": " 4668764",
+ "stk_kind": "01"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/090_국내주식-189_국내주식-증권사별-투자의견.md b/docs/broker/kis/rest/국내주식/종목정보/090_국내주식-189_국내주식-증권사별-투자의견.md
new file mode 100644
index 0000000..9a29a3c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/090_국내주식-189_국내주식-증권사별-투자의견.md
@@ -0,0 +1,237 @@
+# 국내주식 증권사별 투자의견
+
+- 원본 시트명: 국내주식 증권사별 투자의견
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-189
+- HTTP Method: GET
+- 실전 TR_ID: FHKST663400C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/invest-opbysec
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 증권사별 투자의견 API입니다.
+한국투자 HTS(eFriend Plus) > [0608] 증권사별 투자의견 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+한 번의 호출에 20건까지 조회가 가능하기에, 일자 파라미터(FID_INPUT_DATE_1, FID_INPUT_DATE_2)를 조절하여 다음 데이터 조회하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST663400C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J(시장 구분 코드) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 16634(Primary key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 회원사코드 (kis developers 포탈 사이트 포럼-> FAQ -> 종목정보 다운로드(국내) 참조) |
+| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 전체(0) 매수(1) 중립(2) 매도(3) |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 이후 ~ |
+| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~ 이전 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| stck_shrn_iscd | 주식단축종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| invt_opnn | 투자의견 | string | Y | 40 | |
+| invt_opnn_cls_code | 투자의견구분코드 | string | Y | 2 | |
+| rgbf_invt_opnn | 직전투자의견 | string | Y | 40 | |
+| rgbf_invt_opnn_cls_code | 직전투자의견구분코드 | string | Y | 2 | |
+| mbcr_name | 회원사명 | string | Y | 50 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| hts_goal_prc | HTS목표가격 | string | Y | 10 | |
+| stck_prdy_clpr | 주식전일종가 | string | Y | 10 | |
+| stft_esdg | 주식선물괴리도 | string | Y | 10 | |
+| dprt | 괴리율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:16633
+FID_INPUT_ISCD:999
+FID_DIV_CLS_CODE:0
+FID_INPUT_DATE_1:20240428
+FID_INPUT_DATE_2:20240528
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "454910",
+ "hts_kor_isnm": "두산로보틱스",
+ "invt_opnn": "NotRated",
+ "invt_opnn_cls_code": "3",
+ "rgbf_invt_opnn": "NotRated",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "상상인",
+ "stck_prpr": "74300",
+ "prdy_vrss": "500",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.68",
+ "hts_goal_prc": "0",
+ "stck_prdy_clpr": "71600",
+ "stft_esdg": "74300",
+ "dprt": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "389140",
+ "hts_kor_isnm": "포바이포",
+ "invt_opnn": "NotRated",
+ "invt_opnn_cls_code": "3",
+ "rgbf_invt_opnn": "NotRated",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "상상인",
+ "stck_prpr": "10330",
+ "prdy_vrss": "0",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "hts_goal_prc": "0",
+ "stck_prdy_clpr": "10120",
+ "stft_esdg": "10330",
+ "dprt": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "336260",
+ "hts_kor_isnm": "두산퓨얼셀",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "상상인",
+ "stck_prpr": "26150",
+ "prdy_vrss": "-50",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.19",
+ "hts_goal_prc": "33000",
+ "stck_prdy_clpr": "25000",
+ "stft_esdg": "-6850",
+ "dprt": "-20.76"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "298380",
+ "hts_kor_isnm": "에이비엘바이오",
+ "invt_opnn": "NotRated",
+ "invt_opnn_cls_code": "3",
+ "rgbf_invt_opnn": "NotRated",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "상상인",
+ "stck_prpr": "23300",
+ "prdy_vrss": "-100",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.43",
+ "hts_goal_prc": "0",
+ "stck_prdy_clpr": "24300",
+ "stft_esdg": "23300",
+ "dprt": "0.00"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "377740",
+ "hts_kor_isnm": "바이오노트",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "다올투자",
+ "stck_prpr": "4135",
+ "prdy_vrss": "-10",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.24",
+ "hts_goal_prc": "5700",
+ "stck_prdy_clpr": "4175",
+ "stft_esdg": "-1565",
+ "dprt": "-27.46"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "137310",
+ "hts_kor_isnm": "에스디바이오센서",
+ "invt_opnn": "HOLD",
+ "invt_opnn_cls_code": "3",
+ "rgbf_invt_opnn": "HOLD",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "다올투자",
+ "stck_prpr": "10110",
+ "prdy_vrss": "60",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.60",
+ "hts_goal_prc": "11000",
+ "stck_prdy_clpr": "10060",
+ "stft_esdg": "-890",
+ "dprt": "-8.09"
+ },
+ {
+ "stck_bsop_date": "20240527",
+ "stck_shrn_iscd": "298020",
+ "hts_kor_isnm": "효성티앤씨",
+ "invt_opnn": "매수",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "매수",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "IBK투자",
+ "stck_prpr": "389000",
+ "prdy_vrss": "-19000",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-4.66",
+ "hts_goal_prc": "550000",
+ "stck_prdy_clpr": "400500",
+ "stft_esdg": "-161000",
+ "dprt": "-29.27"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/091_국내주식-111_국내주식-당사-신용가능종목.md b/docs/broker/kis/rest/국내주식/종목정보/091_국내주식-111_국내주식-당사-신용가능종목.md
new file mode 100644
index 0000000..704af6f
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/091_국내주식-111_국내주식-당사-신용가능종목.md
@@ -0,0 +1,597 @@
+# 국내주식 당사 신용가능종목
+
+- 원본 시트명: 국내주식 당사 신용가능종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-111
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04770000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/credit-by-company
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 당사 신용가능종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0477] 당사 신용가능 종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+최대 100건 확인 가능하며, 다음 조회가 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04770000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:코드순, 1:이름순 |
+| fid_slct_yn | 선택 여부 | string | Y | 1 | 0:신용주문가능, 1: 신용주문불가 |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
+| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20477) |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| crdt_rate | 신용 비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_cond_scr_div_code":"20477",
+"fid_input_iscd":"0000",
+"fid_slct_yn":"0",
+"fid_rank_sort_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_shrn_iscd": "473440",
+ "hts_kor_isnm": "ACE 11월만기자동연장회사채AA-이상액티브",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "105190",
+ "hts_kor_isnm": "ACE 200",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "332500",
+ "hts_kor_isnm": "ACE 200TR",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "448880",
+ "hts_kor_isnm": "ACE 24-12 회사채(AA-이상)액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "461270",
+ "hts_kor_isnm": "ACE 26-06 회사채(AA-이상)액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "414270",
+ "hts_kor_isnm": "ACE G2전기차&자율주행액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "365780",
+ "hts_kor_isnm": "ACE 국고채10년",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "446770",
+ "hts_kor_isnm": "ACE 글로벌반도체TOP4 Plus SOLACTIVE",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "190620",
+ "hts_kor_isnm": "ACE 단기통안채",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "453850",
+ "hts_kor_isnm": "ACE 미국30년국채액티브(H)",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "360200",
+ "hts_kor_isnm": "ACE 미국S&P500",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "438080",
+ "hts_kor_isnm": "ACE 미국S&P500채권혼합액티브",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "309230",
+ "hts_kor_isnm": "ACE 미국WideMoat가치주",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "367380",
+ "hts_kor_isnm": "ACE 미국나스닥100",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "456880",
+ "hts_kor_isnm": "ACE 미국달러SOFR금리(합성)",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "402970",
+ "hts_kor_isnm": "ACE 미국배당다우존스",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "465580",
+ "hts_kor_isnm": "ACE 미국빅테크TOP7 Plus",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "245710",
+ "hts_kor_isnm": "ACE 베트남VN30(합성)",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "448540",
+ "hts_kor_isnm": "ACE 엔비디아채권혼합블룸버그",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "238720",
+ "hts_kor_isnm": "ACE 일본Nikkei225(H)",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "356540",
+ "hts_kor_isnm": "ACE 종합채권(AA-이상)KIS액티브",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "457480",
+ "hts_kor_isnm": "ACE 테슬라밸류체인액티브",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "469170",
+ "hts_kor_isnm": "ACE 포스코그룹포커스",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "265520",
+ "hts_kor_isnm": "AP시스템",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "152100",
+ "hts_kor_isnm": "ARIRANG 200",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "453010",
+ "hts_kor_isnm": "ARIRANG KOFR금리",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "449450",
+ "hts_kor_isnm": "ARIRANG K방산Fn",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "161510",
+ "hts_kor_isnm": "ARIRANG 고배당주",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "464470",
+ "hts_kor_isnm": "ARIRANG 미국채30년액티브",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "195980",
+ "hts_kor_isnm": "ARIRANG 신흥국MSCI(합성 H)",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "421320",
+ "hts_kor_isnm": "ARIRANG 우주항공&UAM iSelect",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "328370",
+ "hts_kor_isnm": "ARIRANG 코스피TR",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "027410",
+ "hts_kor_isnm": "BGF",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "282330",
+ "hts_kor_isnm": "BGF리테일",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "126600",
+ "hts_kor_isnm": "BGF에코머티리얼즈",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "138930",
+ "hts_kor_isnm": "BNK금융지주",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "001040",
+ "hts_kor_isnm": "CJ",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "000120",
+ "hts_kor_isnm": "CJ대한통운",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "011150",
+ "hts_kor_isnm": "CJ씨푸드",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "097950",
+ "hts_kor_isnm": "CJ제일제당",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "097955",
+ "hts_kor_isnm": "CJ제일제당 우",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "051500",
+ "hts_kor_isnm": "CJ프레시웨이",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "058820",
+ "hts_kor_isnm": "CMG제약",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "012030",
+ "hts_kor_isnm": "DB",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "005830",
+ "hts_kor_isnm": "DB손해보험",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "000990",
+ "hts_kor_isnm": "DB하이텍",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "139130",
+ "hts_kor_isnm": "DGB금융지주",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "001530",
+ "hts_kor_isnm": "DI동일",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "375500",
+ "hts_kor_isnm": "DL이앤씨",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "068790",
+ "hts_kor_isnm": "DMS",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "007340",
+ "hts_kor_isnm": "DN오토모티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "241520",
+ "hts_kor_isnm": "DSC인베스트먼트",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "017940",
+ "hts_kor_isnm": "E1",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "007700",
+ "hts_kor_isnm": "F&F홀딩스",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "078930",
+ "hts_kor_isnm": "GS",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "001250",
+ "hts_kor_isnm": "GS글로벌",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "007070",
+ "hts_kor_isnm": "GS리테일",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "293180",
+ "hts_kor_isnm": "HANARO 200",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "454320",
+ "hts_kor_isnm": "HANARO CAPEX설비투자iSelect",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "395290",
+ "hts_kor_isnm": "HANARO Fn K-POP&미디어",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "395270",
+ "hts_kor_isnm": "HANARO Fn K-반도체",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "441540",
+ "hts_kor_isnm": "HANARO Fn조선해운",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "434730",
+ "hts_kor_isnm": "HANARO 원자력iSelect",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "078150",
+ "hts_kor_isnm": "HB테크놀러지",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "089470",
+ "hts_kor_isnm": "HDC현대EP",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "009540",
+ "hts_kor_isnm": "HD한국조선해양",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "267250",
+ "hts_kor_isnm": "HD현대",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "267270",
+ "hts_kor_isnm": "HD현대건설기계",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "322000",
+ "hts_kor_isnm": "HD현대에너지솔루션",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "042670",
+ "hts_kor_isnm": "HD현대인프라코어",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "329180",
+ "hts_kor_isnm": "HD현대중공업",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "195940",
+ "hts_kor_isnm": "HK이노엔",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "204320",
+ "hts_kor_isnm": "HL만도",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "060980",
+ "hts_kor_isnm": "HL홀딩스",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "011200",
+ "hts_kor_isnm": "HMM",
+ "crdt_rate": "20.00"
+ },
+ {
+ "stck_shrn_iscd": "036640",
+ "hts_kor_isnm": "HRS",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "095340",
+ "hts_kor_isnm": "ISC",
+ "crdt_rate": "60.00"
+ },
+ {
+ "stck_shrn_iscd": "175330",
+ "hts_kor_isnm": "JB금융지주",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "234080",
+ "hts_kor_isnm": "JW생명과학",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "035900",
+ "hts_kor_isnm": "JYP Ent.",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "148020",
+ "hts_kor_isnm": "KBSTAR 200",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "448600",
+ "hts_kor_isnm": "KBSTAR 25-11 회사채(AA-이상)액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "465330",
+ "hts_kor_isnm": "KBSTAR 2차전지TOP10",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "422420",
+ "hts_kor_isnm": "KBSTAR 2차전지액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "469070",
+ "hts_kor_isnm": "KBSTAR AI&로봇",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "290130",
+ "hts_kor_isnm": "KBSTAR ESG사회책임투자",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "367760",
+ "hts_kor_isnm": "KBSTAR Fn5G테크",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "367770",
+ "hts_kor_isnm": "KBSTAR Fn수소경제테마",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "326240",
+ "hts_kor_isnm": "KBSTAR IT플러스",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "385560",
+ "hts_kor_isnm": "KBSTAR KIS국고채30년Enhanced",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "401170",
+ "hts_kor_isnm": "KBSTAR iSelect메타버스",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "266160",
+ "hts_kor_isnm": "KBSTAR 고배당",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "385550",
+ "hts_kor_isnm": "KBSTAR 단기종합채권(AA-이상)액티브",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "196230",
+ "hts_kor_isnm": "KBSTAR 단기통안채",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "315960",
+ "hts_kor_isnm": "KBSTAR 대형고배당10TR",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "455890",
+ "hts_kor_isnm": "KBSTAR 머니마켓액티브",
+ "crdt_rate": "30.00"
+ },
+ {
+ "stck_shrn_iscd": "379780",
+ "hts_kor_isnm": "KBSTAR 미국S&P500",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "453330",
+ "hts_kor_isnm": "KBSTAR 미국S&P500(H)",
+ "crdt_rate": "50.00"
+ },
+ {
+ "stck_shrn_iscd": "368590",
+ "hts_kor_isnm": "KBSTAR 미국나스닥100",
+ "crdt_rate": "40.00"
+ },
+ {
+ "stck_shrn_iscd": "437350",
+ "hts_kor_isnm": "KBSTAR 미국단기투자등급회사채액티브",
+ "crdt_rate": "40.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/092_국내주식-146_예탁원정보주식매수청구일정.md b/docs/broker/kis/rest/국내주식/종목정보/092_국내주식-146_예탁원정보주식매수청구일정.md
new file mode 100644
index 0000000..6ccb96f
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/092_국내주식-146_예탁원정보주식매수청구일정.md
@@ -0,0 +1,1055 @@
+# 예탁원정보(주식매수청구일정)
+
+- 원본 시트명: 예탁원정보(주식매수청구일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-146
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669103C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/purreq
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(주식매수청구일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0663] 주식매수청구 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669103C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| CTS | CTS | string | Y | 17 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| stk_kind | 주식종류 | string | Y | 8 | |
+| opp_opi_rcpt_term | 반대의사접수시한 | string | Y | 9 | |
+| buy_req_rcpt_term | 매수청구접수시한 | string | Y | 12 | |
+| buy_req_price | 매수청구가격 | string | Y | 62 | |
+| buy_amt_pay_dt | 매수대금지급일 | string | Y | 62 | |
+| get_meet_dt | 주총일 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240313",
+ "sht_cd": "065350",
+ "isin_name": "신성델타테크",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240326",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240311",
+ "sht_cd": "472850",
+ "isin_name": "폰드그룹",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240325",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240306",
+ "sht_cd": "238930",
+ "isin_name": "제이비케이랩",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240319",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "435620",
+ "isin_name": "하나금융25호기업인수목적",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240409",
+ "buy_req_rcpt_term": "020240430",
+ "buy_req_price": "000000010578",
+ "buy_amt_pay_dt": "2024/05/16",
+ "get_meet_dt": "2024/04/12"
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "452450",
+ "isin_name": "피아이이",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240409",
+ "buy_req_rcpt_term": "020240430",
+ "buy_req_price": "000000006733",
+ "buy_amt_pay_dt": "2024/05/16",
+ "get_meet_dt": "2024/04/12"
+ },
+ {
+ "record_date": "20240304",
+ "sht_cd": "065150",
+ "isin_name": "대산에프앤비",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240327",
+ "buy_req_rcpt_term": "020240417",
+ "buy_req_price": "000000000260",
+ "buy_amt_pay_dt": "2024/05/17",
+ "get_meet_dt": "2024/03/29"
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "034110",
+ "isin_name": "조선호텔앤리조트",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240322",
+ "buy_req_rcpt_term": "020240412",
+ "buy_req_price": "000000016577",
+ "buy_amt_pay_dt": "2024/05/14",
+ "get_meet_dt": "2024/03/26"
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "034300",
+ "isin_name": "신세계건설",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240322",
+ "buy_req_rcpt_term": "020240412",
+ "buy_req_price": "000000011865",
+ "buy_amt_pay_dt": "2024/05/14",
+ "get_meet_dt": "2024/03/26"
+ },
+ {
+ "record_date": "20240228",
+ "sht_cd": "011690",
+ "isin_name": "와이투솔루션",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240312",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240222",
+ "sht_cd": "021240",
+ "isin_name": "코웨이",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240320",
+ "buy_req_rcpt_term": "020240409",
+ "buy_req_price": "000000056357",
+ "buy_amt_pay_dt": "2024/05/07",
+ "get_meet_dt": "2024/03/22"
+ },
+ {
+ "record_date": "20240222",
+ "sht_cd": "035720",
+ "isin_name": "카카오",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240307",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240221",
+ "sht_cd": "039310",
+ "isin_name": "세중",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240305",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240216",
+ "sht_cd": "101000",
+ "isin_name": "상상인인더스트리",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240308",
+ "buy_req_rcpt_term": "020240329",
+ "buy_req_price": "000000002310",
+ "buy_amt_pay_dt": "2024/04/30",
+ "get_meet_dt": "2024/03/12"
+ },
+ {
+ "record_date": "20240216",
+ "sht_cd": "101005",
+ "isin_name": "상상인인더스트리1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240308",
+ "buy_req_rcpt_term": "020240329",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/04/30",
+ "get_meet_dt": "2024/03/12"
+ },
+ {
+ "record_date": "20240216",
+ "sht_cd": "101007",
+ "isin_name": "상상인인더스트리2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240308",
+ "buy_req_rcpt_term": "020240329",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/04/30",
+ "get_meet_dt": "2024/03/12"
+ },
+ {
+ "record_date": "20240216",
+ "sht_cd": "101009",
+ "isin_name": "상상인인더스트리3우",
+ "stk_kind": "3우선",
+ "opp_opi_rcpt_term": "020240308",
+ "buy_req_rcpt_term": "020240329",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/04/30",
+ "get_meet_dt": "2024/03/12"
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "053300",
+ "isin_name": "한국정보인증",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240322",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "123010",
+ "isin_name": "아이윈플러스",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "123015",
+ "isin_name": "아이윈플러스1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "123017",
+ "isin_name": "아이윈플러스2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "123019",
+ "isin_name": "아이윈플러스3우",
+ "stk_kind": "3우선",
+ "opp_opi_rcpt_term": "020240227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240214",
+ "sht_cd": "12301A",
+ "isin_name": "아이윈플러스4우",
+ "stk_kind": "4우선",
+ "opp_opi_rcpt_term": "020240227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "044180",
+ "isin_name": "KD",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240226",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "095190",
+ "isin_name": "이엠코리아",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240222",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "097780",
+ "isin_name": "에코볼트",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240222",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "097785",
+ "isin_name": "에코볼트1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240222",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240208",
+ "sht_cd": "457190",
+ "isin_name": "이수스페셜티케미컬",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240221",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240207",
+ "sht_cd": "019440",
+ "isin_name": "세아특수강",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240220",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "140430",
+ "isin_name": "카티스",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240313",
+ "buy_req_rcpt_term": "020240403",
+ "buy_req_price": "000000003359",
+ "buy_amt_pay_dt": "2024/04/12",
+ "get_meet_dt": "2024/03/15"
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "296170",
+ "isin_name": "에스엘바이젠",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "29617K",
+ "isin_name": "에스엘바이젠1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "29617L",
+ "isin_name": "에스엘바이젠2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "29617M",
+ "isin_name": "에스엘바이젠3우",
+ "stk_kind": "3우선",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "29617N",
+ "isin_name": "에스엘바이젠4우",
+ "stk_kind": "4우선",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "29617P",
+ "isin_name": "에스엘바이젠5우",
+ "stk_kind": "5우선",
+ "opp_opi_rcpt_term": "020240219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "419270",
+ "isin_name": "신영해피투모로우제7호기업인수목적",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240229",
+ "buy_req_rcpt_term": "020240322",
+ "buy_req_price": "000000002092",
+ "buy_amt_pay_dt": "2024/04/05",
+ "get_meet_dt": "2024/03/05"
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "436530",
+ "isin_name": "케이비제22호기업인수목적",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240313",
+ "buy_req_rcpt_term": "020240403",
+ "buy_req_price": "000000002093",
+ "buy_amt_pay_dt": "2024/04/12",
+ "get_meet_dt": "2024/03/15"
+ },
+ {
+ "record_date": "20240205",
+ "sht_cd": "451250",
+ "isin_name": "삐아",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240229",
+ "buy_req_rcpt_term": "020240322",
+ "buy_req_price": "000000007334",
+ "buy_amt_pay_dt": "2024/04/05",
+ "get_meet_dt": "2024/03/05"
+ },
+ {
+ "record_date": "20240129",
+ "sht_cd": "299910",
+ "isin_name": "베스파",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240213",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240126",
+ "sht_cd": "217270",
+ "isin_name": "넵튠",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240208",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240119",
+ "sht_cd": "151860",
+ "isin_name": "케이지이티에스",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240208",
+ "buy_req_rcpt_term": "020240304",
+ "buy_req_price": "000000011116",
+ "buy_amt_pay_dt": "2024/04/04",
+ "get_meet_dt": "2024/02/14"
+ },
+ {
+ "record_date": "20240118",
+ "sht_cd": "391060",
+ "isin_name": "엔에이치기업인수목적20호",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240221",
+ "buy_req_rcpt_term": "099991229",
+ "buy_req_price": "000000010580",
+ "buy_amt_pay_dt": "9999/12/31",
+ "get_meet_dt": "2024/02/23"
+ },
+ {
+ "record_date": "20240118",
+ "sht_cd": "439270",
+ "isin_name": "크리에이츠",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240221",
+ "buy_req_rcpt_term": "099991229",
+ "buy_req_price": "000000024996",
+ "buy_amt_pay_dt": "9999/12/31",
+ "get_meet_dt": "2024/02/23"
+ },
+ {
+ "record_date": "20240112",
+ "sht_cd": "445090",
+ "isin_name": "에이직랜드",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240125",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240112",
+ "sht_cd": "44509K",
+ "isin_name": "에이직랜드1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240125",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240112",
+ "sht_cd": "44509L",
+ "isin_name": "에이직랜드2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240125",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "177350",
+ "isin_name": "베셀",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "17735K",
+ "isin_name": "베셀1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "222080",
+ "isin_name": "씨아이에스",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "445090",
+ "isin_name": "에이직랜드",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "44509K",
+ "isin_name": "에이직랜드1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240111",
+ "sht_cd": "44509L",
+ "isin_name": "에이직랜드2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20240105",
+ "sht_cd": "009730",
+ "isin_name": "코센",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240118",
+ "buy_req_rcpt_term": "020240213",
+ "buy_req_price": "000000003054",
+ "buy_amt_pay_dt": "2024/03/13",
+ "get_meet_dt": "2024/01/22"
+ },
+ {
+ "record_date": "20240103",
+ "sht_cd": "012160",
+ "isin_name": "영흥",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240123",
+ "buy_req_rcpt_term": "020240213",
+ "buy_req_price": "000000000566",
+ "buy_amt_pay_dt": "2024/03/13",
+ "get_meet_dt": "2024/01/25"
+ },
+ {
+ "record_date": "20240102",
+ "sht_cd": "023530",
+ "isin_name": "롯데쇼핑",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240115",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "017680",
+ "isin_name": "데코앤에프",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240327",
+ "buy_req_rcpt_term": "020240417",
+ "buy_req_price": "000000063827",
+ "buy_amt_pay_dt": "2024/06/17",
+ "get_meet_dt": "2024/03/29"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "017685",
+ "isin_name": "데코앤에프1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240327",
+ "buy_req_rcpt_term": "020240417",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/06/17",
+ "get_meet_dt": "2024/03/29"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "033540",
+ "isin_name": "파라텍",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240325",
+ "buy_req_rcpt_term": "020240415",
+ "buy_req_price": "000000002607",
+ "buy_amt_pay_dt": "2024/05/14",
+ "get_meet_dt": "2024/03/27"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "037710",
+ "isin_name": "광주신세계",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240326",
+ "buy_req_rcpt_term": "020240416",
+ "buy_req_price": "000000030905",
+ "buy_amt_pay_dt": "2024/05/10",
+ "get_meet_dt": "2024/03/28"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "065650",
+ "isin_name": "메디프론디비티",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240326",
+ "buy_req_rcpt_term": "020240416",
+ "buy_req_price": "000000001336",
+ "buy_amt_pay_dt": "2024/05/16",
+ "get_meet_dt": "2024/03/28"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "06565K",
+ "isin_name": "메디프론디비티 1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240326",
+ "buy_req_rcpt_term": "020240416",
+ "buy_req_price": "000000001336",
+ "buy_amt_pay_dt": "2024/05/16",
+ "get_meet_dt": "2024/03/28"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "215000",
+ "isin_name": "골프존",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240327",
+ "buy_req_rcpt_term": "020240417",
+ "buy_req_price": "000000087629",
+ "buy_amt_pay_dt": "2024/04/26",
+ "get_meet_dt": "2024/03/29"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "234690",
+ "isin_name": "녹십자웰빙",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240325",
+ "buy_req_rcpt_term": "020240415",
+ "buy_req_price": "000000009043",
+ "buy_amt_pay_dt": "2024/05/10",
+ "get_meet_dt": "2024/03/27"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "278270",
+ "isin_name": "네오임플란트",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240322",
+ "buy_req_rcpt_term": "020240412",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/04/30",
+ "get_meet_dt": "2024/03/26"
+ },
+ {
+ "record_date": "20231231",
+ "sht_cd": "371110",
+ "isin_name": "포인트임플란트",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240327",
+ "buy_req_rcpt_term": "020240417",
+ "buy_req_price": "000000002400",
+ "buy_amt_pay_dt": "2024/06/17",
+ "get_meet_dt": "2024/03/29"
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "356950",
+ "isin_name": "클래스101",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695K",
+ "isin_name": "클래스101 1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695L",
+ "isin_name": "클래스101 2우",
+ "stk_kind": "2우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695M",
+ "isin_name": "클래스101 3우",
+ "stk_kind": "3우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695N",
+ "isin_name": "클래스101 4우",
+ "stk_kind": "4우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695P",
+ "isin_name": "클래스101 5우",
+ "stk_kind": "5우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695Q",
+ "isin_name": "클래스101 6우",
+ "stk_kind": "6우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695R",
+ "isin_name": "클래스101 7우",
+ "stk_kind": "7우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231229",
+ "sht_cd": "35695S",
+ "isin_name": "클래스101 8우",
+ "stk_kind": "8우선",
+ "opp_opi_rcpt_term": "020240116",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231226",
+ "sht_cd": "016880",
+ "isin_name": "웅진",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240108",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231222",
+ "sht_cd": "397880",
+ "isin_name": "교보11호기업인수목적",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240130",
+ "buy_req_rcpt_term": "020240220",
+ "buy_req_price": "000000002126",
+ "buy_amt_pay_dt": "2024/02/29",
+ "get_meet_dt": "2024/02/01"
+ },
+ {
+ "record_date": "20231222",
+ "sht_cd": "420570",
+ "isin_name": "제이투케이바이오",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240130",
+ "buy_req_rcpt_term": "020240220",
+ "buy_req_price": "000000017267",
+ "buy_amt_pay_dt": "2024/02/29",
+ "get_meet_dt": "2024/02/01"
+ },
+ {
+ "record_date": "20231214",
+ "sht_cd": "227100",
+ "isin_name": "에이치앤비디자인",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020231227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231214",
+ "sht_cd": "22710K",
+ "isin_name": "에이치앤비디자인1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020231227",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231212",
+ "sht_cd": "369370",
+ "isin_name": "블리츠웨이",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240108",
+ "buy_req_rcpt_term": "020240129",
+ "buy_req_price": "000000002022",
+ "buy_amt_pay_dt": "2024/02/08",
+ "get_meet_dt": "2024/01/10"
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "041520",
+ "isin_name": "이라이콤",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020231221",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "123840",
+ "isin_name": "한일진공",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "020240214",
+ "buy_req_price": "000000000465",
+ "buy_amt_pay_dt": "2024/03/15",
+ "get_meet_dt": "2024/01/26"
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "452240",
+ "isin_name": "뉴온",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "020240214",
+ "buy_req_price": "000000011964",
+ "buy_amt_pay_dt": "2024/02/27",
+ "get_meet_dt": "2024/01/26"
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "45224K",
+ "isin_name": "뉴온 1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020240124",
+ "buy_req_rcpt_term": "020240214",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "2024/02/27",
+ "get_meet_dt": "2024/01/26"
+ },
+ {
+ "record_date": "20231206",
+ "sht_cd": "054210",
+ "isin_name": "이랜텍",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020231219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231206",
+ "sht_cd": "05421K",
+ "isin_name": "이랜텍1우",
+ "stk_kind": "우선",
+ "opp_opi_rcpt_term": "020231219",
+ "buy_req_rcpt_term": "",
+ "buy_req_price": "000000000000",
+ "buy_amt_pay_dt": "",
+ "get_meet_dt": ""
+ },
+ {
+ "record_date": "20231129",
+ "sht_cd": "034300",
+ "isin_name": "신세계건설",
+ "stk_kind": "보통",
+ "opp_opi_rcpt_term": "020231220",
+ "buy_req_rcpt_term": "020240110",
+ "buy_req_price": "000000013424",
+ "buy_amt_pay_dt": "2024/01/22",
+ "get_meet_dt": "2023/12/22"
+ },
+ {
+ "record_date": "20231129",
+ "
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/093_국내주식-148_예탁원정보액면교체일정.md b/docs/broker/kis/rest/국내주식/종목정보/093_국내주식-148_예탁원정보액면교체일정.md
new file mode 100644
index 0000000..09192ea
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/093_국내주식-148_예탁원정보액면교체일정.md
@@ -0,0 +1,244 @@
+# 예탁원정보(액면교체일정)
+
+- 원본 시트명: 예탁원정보(액면교체일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-148
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669105C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/rev-split
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(액면교체일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0657] 액면교체 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669105C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| MARKET_GB | 시장구분 | string | Y | 1 | 0:전체, 1:코스피, 2:코스닥 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| inter_bf_face_amt | 변경전액면가 | string | Y | 9 | |
+| inter_af_face_amt | 변경후액면가 | string | Y | 9 | |
+| td_stop_dt | 매매거래정지기간 | string | Y | 23 | |
+| list_dt | 상장/등록일 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+market_gb:1
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20230823",
+ "sht_cd": "001390",
+ "isin_name": "케이지케미칼",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000001000",
+ "td_stop_dt": "2023/08/22 ~ 2023/08/27",
+ "list_dt": "2023/08/28"
+ },
+ {
+ "record_date": "20230823",
+ "sht_cd": "011690",
+ "isin_name": "와이투솔루션",
+ "inter_bf_face_amt": "000000500",
+ "inter_af_face_amt": "000002500",
+ "td_stop_dt": "2023/08/22 ~ 2023/09/11",
+ "list_dt": "2023/09/12"
+ },
+ {
+ "record_date": "20230626",
+ "sht_cd": "017860",
+ "isin_name": "디에스단석",
+ "inter_bf_face_amt": "000001000",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/06/23 ~",
+ "list_dt": ""
+ },
+ {
+ "record_date": "20230525",
+ "sht_cd": "111380",
+ "isin_name": "동인기연",
+ "inter_bf_face_amt": "000010000",
+ "inter_af_face_amt": "000000100",
+ "td_stop_dt": "2023/05/24 ~",
+ "list_dt": "2023/11/21"
+ },
+ {
+ "record_date": "20230525",
+ "sht_cd": "11138K",
+ "isin_name": "동인기연1우",
+ "inter_bf_face_amt": "000010000",
+ "inter_af_face_amt": "000000100",
+ "td_stop_dt": "2023/05/24 ~",
+ "list_dt": "2023/11/21"
+ },
+ {
+ "record_date": "20230509",
+ "sht_cd": "002900",
+ "isin_name": "티와이엠",
+ "inter_bf_face_amt": "000000500",
+ "inter_af_face_amt": "000002500",
+ "td_stop_dt": "2023/05/08 ~ 2023/05/21",
+ "list_dt": "2023/05/22"
+ },
+ {
+ "record_date": "20230503",
+ "sht_cd": "001140",
+ "isin_name": "국보",
+ "inter_bf_face_amt": "000000500",
+ "inter_af_face_amt": "000005000",
+ "td_stop_dt": "2023/05/02 ~ 2023/05/22",
+ "list_dt": "2023/05/23"
+ },
+ {
+ "record_date": "20230502",
+ "sht_cd": "001440",
+ "isin_name": "대한전선",
+ "inter_bf_face_amt": "000000100",
+ "inter_af_face_amt": "000001000",
+ "td_stop_dt": "2023/04/28 ~ 2023/05/15",
+ "list_dt": "2023/05/16"
+ },
+ {
+ "record_date": "20230420",
+ "sht_cd": "016590",
+ "isin_name": "신대양제지",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/19 ~ 2023/04/23",
+ "list_dt": "2023/04/24"
+ },
+ {
+ "record_date": "20230414",
+ "sht_cd": "049770",
+ "isin_name": "동원에프앤비",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000001000",
+ "td_stop_dt": "2023/04/13 ~ 2023/04/18",
+ "list_dt": "2023/04/19"
+ },
+ {
+ "record_date": "20230413",
+ "sht_cd": "003120",
+ "isin_name": "일성신약",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000001000",
+ "td_stop_dt": "2023/04/12 ~ 2023/04/16",
+ "list_dt": "2023/04/17"
+ },
+ {
+ "record_date": "20230413",
+ "sht_cd": "007120",
+ "isin_name": "미래아이앤지",
+ "inter_bf_face_amt": "000000100",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/12 ~ 2023/05/03",
+ "list_dt": "2023/05/04"
+ },
+ {
+ "record_date": "20230411",
+ "sht_cd": "002200",
+ "isin_name": "한국수출포장공업",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/10 ~ 2023/04/16",
+ "list_dt": "2023/04/17"
+ },
+ {
+ "record_date": "20230410",
+ "sht_cd": "380440",
+ "isin_name": "엔에이치기업인수목적19호",
+ "inter_bf_face_amt": "000000100",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/07 ~ 2023/05/01",
+ "list_dt": "2023/05/02"
+ },
+ {
+ "record_date": "20230407",
+ "sht_cd": "000480",
+ "isin_name": "시알홀딩스",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/06 ~ 2023/04/12",
+ "list_dt": "2023/04/13"
+ },
+ {
+ "record_date": "20230407",
+ "sht_cd": "003200",
+ "isin_name": "일신방직",
+ "inter_bf_face_amt": "000005000",
+ "inter_af_face_amt": "000000500",
+ "td_stop_dt": "2023/04/06 ~ 2023/04/13",
+ "list_dt": "2023/04/14"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/094_국내주식-145_예탁원정보배당일정.md b/docs/broker/kis/rest/국내주식/종목정보/094_국내주식-145_예탁원정보배당일정.md
new file mode 100644
index 0000000..2b3c936
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/094_국내주식-145_예탁원정보배당일정.md
@@ -0,0 +1,1075 @@
+# 예탁원정보(배당일정)
+
+- 원본 시트명: 예탁원정보(배당일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-145
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669102C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/dividend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(배당일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0658] 배당 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+'주식배당지급일'은 배당주식의 주식교부일자를 말합니다. 배당주식의 계좌입고는 배당주식 상장일인데 일반적으로 주권교부일의 익영업일입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669102C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| GB1 | 조회구분 | string | Y | 1 | 0:배당전체, 1:결산배당, 2:중간배당 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| HIGH_GB | 고배당여부 | string | Y | 1 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| divi_kind | 배당종류 | string | Y | 8 | |
+| face_val | 액면가 | string | Y | 9 | |
+| per_sto_divi_amt | 현금배당금 | string | Y | 12 | |
+| divi_rate | 현금배당률(%) | string | Y | 62 | |
+| stk_divi_rate | 주식배당률(%) | string | Y | 152 | |
+| divi_pay_dt | 배당금지급일 | string | Y | 10 | |
+| stk_div_pay_dt | 주식배당지급일 | string | Y | 10 | |
+| odd_pay_dt | 단주대금지급일 | string | Y | 10 | |
+| stk_kind | 주식종류 | string | Y | 10 | |
+| high_divi_gb | 고배당종목여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+gb1:0
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+high_gb:0
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240326",
+ "sht_cd": "000720",
+ "isin_name": "현대건설",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000600",
+ "divi_rate": " 12.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "000725",
+ "isin_name": "현대건설1우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000650",
+ "divi_rate": " 13.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "003540",
+ "isin_name": "대신증권",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000001200",
+ "divi_rate": " 24.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "003545",
+ "isin_name": "대신증권1우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000001250",
+ "divi_rate": " 25.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "003547",
+ "isin_name": "대신증권2우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000001200",
+ "divi_rate": " 24.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "2우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "012510",
+ "isin_name": "더존비즈온",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000217",
+ "divi_rate": " 43.40",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/15",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240326",
+ "sht_cd": "01251K",
+ "isin_name": "더존비즈온2우",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000004861",
+ "divi_rate": "972.20",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/15",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "2우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240325",
+ "sht_cd": "012330",
+ "isin_name": "현대모비스",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000003500",
+ "divi_rate": " 70.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240325",
+ "sht_cd": "012335",
+ "isin_name": "현대모비스1우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000003550",
+ "divi_rate": " 71.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240322",
+ "sht_cd": "030210",
+ "isin_name": "다올투자증권",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000150",
+ "divi_rate": " 3.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/09",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240322",
+ "sht_cd": "03021K",
+ "isin_name": "다올투자증권3우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000356",
+ "divi_rate": " 7.14",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/09",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "3우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240322",
+ "sht_cd": "03021L",
+ "isin_name": "다올투자증권4우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000295",
+ "divi_rate": " 5.91",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/09",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "4우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "006840",
+ "isin_name": "에이케이홀딩스",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000200",
+ "divi_rate": " 4.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "014680",
+ "isin_name": "한솔케미칼",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000002100",
+ "divi_rate": " 42.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/08",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "380440",
+ "isin_name": "엔에이치기업인수목적19호",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000000",
+ "divi_rate": " 0.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240320",
+ "sht_cd": "000270",
+ "isin_name": "기아",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000005600",
+ "divi_rate": "112.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/15",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240320",
+ "sht_cd": "276970",
+ "isin_name": "삼성KODEX 미국S&P500배당귀족커버드콜증권",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000130",
+ "divi_rate": " 1.30",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/22",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "012690",
+ "isin_name": "모나리자",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000050",
+ "divi_rate": " 10.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/11",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "474220",
+ "isin_name": "미래에셋TIGER미국테크TOP10+10%프리미엄증",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000092",
+ "divi_rate": " 0.92",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240311",
+ "sht_cd": "028100",
+ "isin_name": "동아지질",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000500",
+ "divi_rate": "100.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240311",
+ "sht_cd": "267790",
+ "isin_name": "배럴",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000050",
+ "divi_rate": " 10.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240311",
+ "sht_cd": "26779L",
+ "isin_name": "배럴 2우",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000112",
+ "divi_rate": " 22.40",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "2우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "114100",
+ "isin_name": "KB KBSTAR 국고채3년 증권 상장지수 투자신",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000720",
+ "divi_rate": " 0.70",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "114460",
+ "isin_name": "한국투자ACE국고채증권상장지수투자신탁(채",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000580",
+ "divi_rate": " 0.56",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "114470",
+ "isin_name": "키움 KOSEF 국고채 상장지수증권투자신탁[",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000580",
+ "divi_rate": " 0.57",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/13",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "114820",
+ "isin_name": "미래에셋TIGER국채3증권상장지수투자신탁(",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000518",
+ "divi_rate": " 0.50",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "346000",
+ "isin_name": "NH-Amundi HANARO KAP 초장기국고채 증권 ",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000354",
+ "divi_rate": " 0.71",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "385560",
+ "isin_name": "KB KBSTAR KIS국고채30년Enhanced 증권 상",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000001570",
+ "divi_rate": " 1.57",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "464230",
+ "isin_name": "키움히어로즈24-09회사채(AA-이상)액티브증",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000300",
+ "divi_rate": " 0.60",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/13",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "464240",
+ "isin_name": "키움히어로즈26-09회사채(AA-이상)액티브증",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000300",
+ "divi_rate": " 0.60",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/13",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "467620",
+ "isin_name": "키움히어로즈25-09미국달러채권(AA-이상)액",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000200",
+ "divi_rate": " 0.40",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/13",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240307",
+ "sht_cd": "042700",
+ "isin_name": "한미반도체",
+ "divi_kind": "결산",
+ "face_val": "000000100",
+ "per_sto_divi_amt": "000000000420",
+ "divi_rate": "420.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/29",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240306",
+ "sht_cd": "004310",
+ "isin_name": "현대약품",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000035",
+ "divi_rate": " 7.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/27",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "152550",
+ "isin_name": "한국투자ANKOR유전해외자원개발특별자산투",
+ "divi_kind": "결산",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000000",
+ "divi_rate": " 0.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "377630",
+ "isin_name": "삼성기업인수목적4호",
+ "divi_kind": "결산",
+ "face_val": "000000100",
+ "per_sto_divi_amt": "000000000000",
+ "divi_rate": "2079.0",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240301",
+ "sht_cd": "002900",
+ "isin_name": "티와이엠",
+ "divi_kind": "결산",
+ "face_val": "000002500",
+ "per_sto_divi_amt": "000000000110",
+ "divi_rate": " 4.40",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240301",
+ "sht_cd": "084870",
+ "isin_name": "티비에이치글로벌",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000050",
+ "divi_rate": " 10.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "002380",
+ "isin_name": "케이씨씨",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000007000",
+ "divi_rate": "140.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "005380",
+ "isin_name": "현대자동차",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000008400",
+ "divi_rate": "168.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "005385",
+ "isin_name": "현대자동차1우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000008450",
+ "divi_rate": "169.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "005387",
+ "isin_name": "현대자동차2우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000008500",
+ "divi_rate": "170.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "2우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "005389",
+ "isin_name": "현대자동차3우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000008450",
+ "divi_rate": "169.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "3우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "005490",
+ "isin_name": "포스코홀딩스",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000002500",
+ "divi_rate": " 50.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "007340",
+ "isin_name": "디엔오토모티브",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000002500",
+ "divi_rate": "500.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "035720",
+ "isin_name": "카카오",
+ "divi_kind": "결산",
+ "face_val": "000000100",
+ "per_sto_divi_amt": "000000000061",
+ "divi_rate": " 61.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "092870",
+ "isin_name": "엑시콘",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000100",
+ "divi_rate": " 20.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/16",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "097950",
+ "isin_name": "씨제이제일제당",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000002500",
+ "divi_rate": " 50.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "097955",
+ "isin_name": "씨제이제일제당1우",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000002550",
+ "divi_rate": " 51.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "105560",
+ "isin_name": "KB금융지주",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000001530",
+ "divi_rate": " 30.60",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/11",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "136340",
+ "isin_name": "KB KBSTAR 중기우량회사채 증권 상장지수 ",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000370",
+ "divi_rate": " 0.37",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "138930",
+ "isin_name": "BNK금융지주",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000410",
+ "divi_rate": " 8.20",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "139130",
+ "isin_name": "DGB금융지주",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000550",
+ "divi_rate": " 11.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "148150",
+ "isin_name": "세경하이테크",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000100",
+ "divi_rate": " 20.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "14815K",
+ "isin_name": "세경하이테크1우",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000180",
+ "divi_rate": " 36.17",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/12",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "우선",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "166400",
+ "isin_name": "미래에셋 TIGER 200커버드콜5%OTM 증권상장",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000060",
+ "divi_rate": " 0.60",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "175330",
+ "isin_name": "JB금융지주",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000735",
+ "divi_rate": " 14.70",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "182480",
+ "isin_name": "미래에셋TIGERMSCIUS리츠부동산상장지수투",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000040",
+ "divi_rate": " 0.40",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "245340",
+ "isin_name": "미래에셋TIGER미국다우존스30증권상장지수",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000020",
+ "divi_rate": " 0.20",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "246250",
+ "isin_name": "에스엘에스바이오",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000000050",
+ "divi_rate": " 10.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/15",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "251600",
+ "isin_name": "한화ARIRANG고배당주채권혼합증권상장지수",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000030",
+ "divi_rate": " 0.30",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "271830",
+ "isin_name": "팸텍",
+ "divi_kind": "결산",
+ "face_val": "000000100",
+ "per_sto_divi_amt": "000000000030",
+ "divi_rate": " 30.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/19",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "282690",
+ "isin_name": "동아타이어공업(신설)",
+ "divi_kind": "결산",
+ "face_val": "000000500",
+ "per_sto_divi_amt": "000000001000",
+ "divi_rate": "200.00",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "289480",
+ "isin_name": "미래에셋TIGER200커버드콜ATM증권상장지수",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000062",
+ "divi_rate": " 0.62",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "290080",
+ "isin_name": "KB KBSTAR 200 고배당 커버드콜 ATM 증권 ",
+ "divi_kind": "",
+ "face_val": "000000000",
+ "per_sto_divi_amt": "000000000053",
+ "divi_rate": " 0.53",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/03/05",
+ "stk_div_pay_dt": "",
+ "odd_pay_dt": "",
+ "stk_kind": "보통",
+ "high_divi_gb": ""
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "316140",
+ "isin_name": "우리금융지주",
+ "divi_kind": "결산",
+ "face_val": "000005000",
+ "per_sto_divi_amt": "000000000640",
+ "divi_rate": " 12.80",
+ "stk_divi_rate": " 0.00",
+ "divi_pay_dt": "2024/04/09",
+ "stk_div_pay_dt": "",
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/095_국내주식-188_국내주식-종목투자의견.md b/docs/broker/kis/rest/국내주식/종목정보/095_국내주식-188_국내주식-종목투자의견.md
new file mode 100644
index 0000000..6bd4e91
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/095_국내주식-188_국내주식-종목투자의견.md
@@ -0,0 +1,203 @@
+# 국내주식 종목투자의견
+
+- 원본 시트명: 국내주식 종목투자의견
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-188
+- HTTP Method: GET
+- 실전 TR_ID: FHKST663300C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/invest-opinion
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목투자의견 API입니다.
+한국투자 HTS(eFriend Plus) > [0605] 종목투자의견 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+한 번의 호출에 100건까지 조회가 가능하기에, 일자 파라미터(FID_INPUT_DATE_1, FID_INPUT_DATE_2)를 조절하여 다음 데이터 조회하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST663300C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J(시장 구분 코드) |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 16633(Primary key) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 종목코드(ex) 005930(삼성전자)) |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 이후 ~(ex) 0020231113) |
+| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~ 이전(ex) 0020240513) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| invt_opnn | 투자의견 | string | Y | 40 | |
+| invt_opnn_cls_code | 투자의견구분코드 | string | Y | 2 | |
+| rgbf_invt_opnn | 직전투자의견 | string | Y | 40 | |
+| rgbf_invt_opnn_cls_code | 직전투자의견구분코드 | string | Y | 2 | |
+| mbcr_name | 회원사명 | string | Y | 50 | |
+| hts_goal_prc | HTS목표가격 | string | Y | 10 | |
+| stck_prdy_clpr | 주식전일종가 | string | Y | 10 | |
+| stck_nday_esdg | 주식N일괴리도 | string | Y | 10 | |
+| nday_dprt | N일괴리율 | string | Y | 82 | |
+| stft_esdg | 주식선물괴리도 | string | Y | 10 | |
+| dprt | 괴리율 | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:J
+FID_COND_SCR_DIV_CODE:16633
+FID_INPUT_ISCD:005930
+FID_INPUT_DATE_1:20240101
+FID_INPUT_DATE_2:20240528
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240527",
+ "invt_opnn": "매수",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "매수",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "SK",
+ "hts_goal_prc": "105000",
+ "stck_prdy_clpr": "75900",
+ "stck_nday_esdg": "-29100",
+ "nday_dprt": "-27.71",
+ "stft_esdg": "-27400",
+ "dprt": "-26.10"
+ },
+ {
+ "stck_bsop_date": "20240520",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "하이투자",
+ "hts_goal_prc": "91000",
+ "stck_prdy_clpr": "77400",
+ "stck_nday_esdg": "-13600",
+ "nday_dprt": "-14.95",
+ "stft_esdg": "-13400",
+ "dprt": "-14.73"
+ },
+ {
+ "stck_bsop_date": "20240516",
+ "invt_opnn": "매수",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "매수",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "미래에셋",
+ "hts_goal_prc": "110000",
+ "stck_prdy_clpr": "78300",
+ "stck_nday_esdg": "-31700",
+ "nday_dprt": "-28.82",
+ "stft_esdg": "-32400",
+ "dprt": "-29.45"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "다올투자",
+ "hts_goal_prc": "105000",
+ "stck_prdy_clpr": "77500",
+ "stck_nday_esdg": "-27500",
+ "nday_dprt": "-26.19",
+ "stft_esdg": "-27400",
+ "dprt": "-26.10"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "하이투자",
+ "hts_goal_prc": "95000",
+ "stck_prdy_clpr": "77500",
+ "stck_nday_esdg": "-17500",
+ "nday_dprt": "-18.42",
+ "stft_esdg": "-17400",
+ "dprt": "-18.32"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "invt_opnn": "BUY",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "BUY",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "KB",
+ "hts_goal_prc": "120000",
+ "stck_prdy_clpr": "77500",
+ "stck_nday_esdg": "-42500",
+ "nday_dprt": "-35.42",
+ "stft_esdg": "-42400",
+ "dprt": "-35.33"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "invt_opnn": "매수",
+ "invt_opnn_cls_code": "2",
+ "rgbf_invt_opnn": "매수",
+ "rgbf_invt_opnn_cls_code": "3",
+ "mbcr_name": "신한투자증권",
+ "hts_goal_prc": "110000",
+ "stck_prdy_clpr": "77500",
+ "stck_nday_esdg": "-32500",
+ "nday_dprt": "-29.55",
+ "stft_esdg": "-32400",
+ "dprt": "-29.45"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/096_v1_국내주식-083_국내주식-안정성비율.md b/docs/broker/kis/rest/국내주식/종목정보/096_v1_국내주식-083_국내주식-안정성비율.md
new file mode 100644
index 0000000..8895140
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/096_v1_국내주식-083_국내주식-안정성비율.md
@@ -0,0 +1,304 @@
+# 국내주식 안정성비율
+
+- 원본 시트명: 국내주식 안정성비율
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-083
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430600
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/stability-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 안정성비율 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '5. 안정성비율' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430600 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| lblt_rate | 부채 비율 | string | Y | 84 | |
+| bram_depn | 차입금 의존도 | string | Y | 92 | |
+| crnt_rate | 유동 비율 | string | Y | 84 | |
+| quck_rate | 당좌 비율 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "lblt_rate": "25.36",
+ "bram_depn": "2.78",
+ "crnt_rate": "258.77",
+ "quck_rate": "190.59"
+ },
+ {
+ "stac_yymm": "202309",
+ "lblt_rate": "24.89",
+ "bram_depn": "2.21",
+ "crnt_rate": "280.39",
+ "quck_rate": "205.34"
+ },
+ {
+ "stac_yymm": "202306",
+ "lblt_rate": "24.80",
+ "bram_depn": "2.04",
+ "crnt_rate": "288.18",
+ "quck_rate": "209.76"
+ },
+ {
+ "stac_yymm": "202303",
+ "lblt_rate": "26.21",
+ "bram_depn": "2.19",
+ "crnt_rate": "281.95",
+ "quck_rate": "210.40"
+ },
+ {
+ "stac_yymm": "202212",
+ "lblt_rate": "26.41",
+ "bram_depn": "2.30",
+ "crnt_rate": "278.86",
+ "quck_rate": "212.24"
+ },
+ {
+ "stac_yymm": "202209",
+ "lblt_rate": "36.35",
+ "bram_depn": "2.65",
+ "crnt_rate": "294.17",
+ "quck_rate": "226.96"
+ },
+ {
+ "stac_yymm": "202206",
+ "lblt_rate": "36.64",
+ "bram_depn": "3.89",
+ "crnt_rate": "283.45",
+ "quck_rate": "220.96"
+ },
+ {
+ "stac_yymm": "202203",
+ "lblt_rate": "39.34",
+ "bram_depn": "4.11",
+ "crnt_rate": "256.86",
+ "quck_rate": "204.26"
+ },
+ {
+ "stac_yymm": "202112",
+ "lblt_rate": "39.92",
+ "bram_depn": "4.31",
+ "crnt_rate": "247.58",
+ "quck_rate": "200.62"
+ },
+ {
+ "stac_yymm": "202109",
+ "lblt_rate": "38.30",
+ "bram_depn": "4.65",
+ "crnt_rate": "259.91",
+ "quck_rate": "213.74"
+ },
+ {
+ "stac_yymm": "202106",
+ "lblt_rate": "36.29",
+ "bram_depn": "4.35",
+ "crnt_rate": "263.75",
+ "quck_rate": "217.39"
+ },
+ {
+ "stac_yymm": "202103",
+ "lblt_rate": "43.23",
+ "bram_depn": "5.08",
+ "crnt_rate": "232.11",
+ "quck_rate": "198.13"
+ },
+ {
+ "stac_yymm": "202012",
+ "lblt_rate": "37.07",
+ "bram_depn": "5.35",
+ "crnt_rate": "262.17",
+ "quck_rate": "219.79"
+ },
+ {
+ "stac_yymm": "202009",
+ "lblt_rate": "36.09",
+ "bram_depn": "5.22",
+ "crnt_rate": "278.77",
+ "quck_rate": "234.36"
+ },
+ {
+ "stac_yymm": "202006",
+ "lblt_rate": "32.67",
+ "bram_depn": "4.66",
+ "crnt_rate": "300.88",
+ "quck_rate": "252.96"
+ },
+ {
+ "stac_yymm": "202003",
+ "lblt_rate": "34.19",
+ "bram_depn": "4.38",
+ "crnt_rate": "288.34",
+ "quck_rate": "244.41"
+ },
+ {
+ "stac_yymm": "201912",
+ "lblt_rate": "34.12",
+ "bram_depn": "5.22",
+ "crnt_rate": "284.38",
+ "quck_rate": "242.41"
+ },
+ {
+ "stac_yymm": "201909",
+ "lblt_rate": "34.14",
+ "bram_depn": "4.57",
+ "crnt_rate": "293.89",
+ "quck_rate": "245.06"
+ },
+ {
+ "stac_yymm": "201906",
+ "lblt_rate": "33.05",
+ "bram_depn": "4.51",
+ "crnt_rate": "292.42",
+ "quck_rate": "239.74"
+ },
+ {
+ "stac_yymm": "201903",
+ "lblt_rate": "36.27",
+ "bram_depn": "3.83",
+ "crnt_rate": "263.37",
+ "quck_rate": "216.66"
+ },
+ {
+ "stac_yymm": "201812",
+ "lblt_rate": "36.97",
+ "bram_depn": "4.32",
+ "crnt_rate": "252.89",
+ "quck_rate": "210.93"
+ },
+ {
+ "stac_yymm": "201809",
+ "lblt_rate": "39.28",
+ "bram_depn": "6.43",
+ "crnt_rate": "235.97",
+ "quck_rate": "198.16"
+ },
+ {
+ "stac_yymm": "201806",
+ "lblt_rate": "36.70",
+ "bram_depn": "5.05",
+ "crnt_rate": "239.29",
+ "quck_rate": "197.58"
+ },
+ {
+ "stac_yymm": "201803",
+ "lblt_rate": "39.96",
+ "bram_depn": "4.12",
+ "crnt_rate": "226.86",
+ "quck_rate": "188.10"
+ },
+ {
+ "stac_yymm": "201712",
+ "lblt_rate": "40.68",
+ "bram_depn": "6.23",
+ "crnt_rate": "218.80",
+ "quck_rate": "181.61"
+ },
+ {
+ "stac_yymm": "201709",
+ "lblt_rate": "40.76",
+ "bram_depn": "6.26",
+ "crnt_rate": "219.61",
+ "quck_rate": "178.76"
+ },
+ {
+ "stac_yymm": "201706",
+ "lblt_rate": "38.31",
+ "bram_depn": "6.02",
+ "crnt_rate": "226.06",
+ "quck_rate": "186.68"
+ },
+ {
+ "stac_yymm": "201703",
+ "lblt_rate": "39.20",
+ "bram_depn": "5.01",
+ "crnt_rate": "227.44",
+ "quck_rate": "188.99"
+ },
+ {
+ "stac_yymm": "201612",
+ "lblt_rate": "35.87",
+ "bram_depn": "5.83",
+ "crnt_rate": "258.54",
+ "quck_rate": "224.99"
+ },
+ {
+ "stac_yymm": "201609",
+ "lblt_rate": "36.17",
+ "bram_depn": "5.30",
+ "crnt_rate": "261.93",
+ "quck_rate": "225.50"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/097_v1_국내주식-081_국내주식-수익성비율.md b/docs/broker/kis/rest/국내주식/종목정보/097_v1_국내주식-081_국내주식-수익성비율.md
new file mode 100644
index 0000000..74ba1b7
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/097_v1_국내주식-081_국내주식-수익성비율.md
@@ -0,0 +1,304 @@
+# 국내주식 수익성비율
+
+- 원본 시트명: 국내주식 수익성비율
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-081
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/profit-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 수익성비율 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '4. 수익성비율' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| cptl_ntin_rate | 총자본 순이익율 | string | Y | 92 | |
+| self_cptl_ntin_inrt | 자기자본 순이익율 | string | Y | 92 | |
+| sale_ntin_rate | 매출액 순이익율 | string | Y | 92 | |
+| sale_totl_rate | 매출액 총이익율 | string | Y | 92 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "cptl_ntin_rate": "3.43",
+ "self_cptl_ntin_inrt": "4.14",
+ "sale_ntin_rate": "5.98",
+ "sale_totl_rate": "30.33"
+ },
+ {
+ "stac_yymm": "202309",
+ "cptl_ntin_rate": "2.70",
+ "self_cptl_ntin_inrt": "3.22",
+ "sale_ntin_rate": "4.78",
+ "sale_totl_rate": "29.76"
+ },
+ {
+ "stac_yymm": "202306",
+ "cptl_ntin_rate": "1.47",
+ "self_cptl_ntin_inrt": "1.70",
+ "sale_ntin_rate": "2.67",
+ "sale_totl_rate": "29.17"
+ },
+ {
+ "stac_yymm": "202303",
+ "cptl_ntin_rate": "1.40",
+ "self_cptl_ntin_inrt": "1.61",
+ "sale_ntin_rate": "2.47",
+ "sale_totl_rate": "27.83"
+ },
+ {
+ "stac_yymm": "202212",
+ "cptl_ntin_rate": "12.72",
+ "self_cptl_ntin_inrt": "17.07",
+ "sale_ntin_rate": "18.41",
+ "sale_totl_rate": "37.12"
+ },
+ {
+ "stac_yymm": "202209",
+ "cptl_ntin_rate": "9.46",
+ "self_cptl_ntin_inrt": "13.18",
+ "sale_ntin_rate": "13.73",
+ "sale_totl_rate": "38.98"
+ },
+ {
+ "stac_yymm": "202206",
+ "cptl_ntin_rate": "10.25",
+ "self_cptl_ntin_inrt": "14.36",
+ "sale_ntin_rate": "14.47",
+ "sale_totl_rate": "39.77"
+ },
+ {
+ "stac_yymm": "202203",
+ "cptl_ntin_rate": "10.46",
+ "self_cptl_ntin_inrt": "14.77",
+ "sale_ntin_rate": "14.56",
+ "sale_totl_rate": "39.48"
+ },
+ {
+ "stac_yymm": "202112",
+ "cptl_ntin_rate": "9.92",
+ "self_cptl_ntin_inrt": "13.92",
+ "sale_ntin_rate": "14.27",
+ "sale_totl_rate": "40.48"
+ },
+ {
+ "stac_yymm": "202109",
+ "cptl_ntin_rate": "9.83",
+ "self_cptl_ntin_inrt": "13.72",
+ "sale_ntin_rate": "14.32",
+ "sale_totl_rate": "40.18"
+ },
+ {
+ "stac_yymm": "202106",
+ "cptl_ntin_rate": "8.79",
+ "self_cptl_ntin_inrt": "12.21",
+ "sale_ntin_rate": "13.00",
+ "sale_totl_rate": "39.12"
+ },
+ {
+ "stac_yymm": "202103",
+ "cptl_ntin_rate": "7.41",
+ "self_cptl_ntin_inrt": "10.64",
+ "sale_ntin_rate": "10.92",
+ "sale_totl_rate": "36.53"
+ },
+ {
+ "stac_yymm": "202012",
+ "cptl_ntin_rate": "7.23",
+ "self_cptl_ntin_inrt": "9.99",
+ "sale_ntin_rate": "11.15",
+ "sale_totl_rate": "38.98"
+ },
+ {
+ "stac_yymm": "202009",
+ "cptl_ntin_rate": "7.25",
+ "self_cptl_ntin_inrt": "10.02",
+ "sale_ntin_rate": "11.30",
+ "sale_totl_rate": "39.13"
+ },
+ {
+ "stac_yymm": "202006",
+ "cptl_ntin_rate": "5.88",
+ "self_cptl_ntin_inrt": "8.04",
+ "sale_ntin_rate": "9.64",
+ "sale_totl_rate": "38.39"
+ },
+ {
+ "stac_yymm": "202003",
+ "cptl_ntin_rate": "5.50",
+ "self_cptl_ntin_inrt": "7.62",
+ "sale_ntin_rate": "8.83",
+ "sale_totl_rate": "37.09"
+ },
+ {
+ "stac_yymm": "201912",
+ "cptl_ntin_rate": "6.28",
+ "self_cptl_ntin_inrt": "8.69",
+ "sale_ntin_rate": "9.44",
+ "sale_totl_rate": "36.09"
+ },
+ {
+ "stac_yymm": "201909",
+ "cptl_ntin_rate": "6.36",
+ "self_cptl_ntin_inrt": "8.76",
+ "sale_ntin_rate": "9.68",
+ "sale_totl_rate": "36.26"
+ },
+ {
+ "stac_yymm": "201906",
+ "cptl_ntin_rate": "5.99",
+ "self_cptl_ntin_inrt": "8.30",
+ "sale_ntin_rate": "9.42",
+ "sale_totl_rate": "36.70"
+ },
+ {
+ "stac_yymm": "201903",
+ "cptl_ntin_rate": "5.90",
+ "self_cptl_ntin_inrt": "8.41",
+ "sale_ntin_rate": "9.63",
+ "sale_totl_rate": "37.49"
+ },
+ {
+ "stac_yymm": "201812",
+ "cptl_ntin_rate": "13.83",
+ "self_cptl_ntin_inrt": "19.63",
+ "sale_ntin_rate": "18.19",
+ "sale_totl_rate": "45.69"
+ },
+ {
+ "stac_yymm": "201809",
+ "cptl_ntin_rate": "14.98",
+ "self_cptl_ntin_inrt": "21.47",
+ "sale_ntin_rate": "19.45",
+ "sale_totl_rate": "46.68"
+ },
+ {
+ "stac_yymm": "201806",
+ "cptl_ntin_rate": "14.66",
+ "self_cptl_ntin_inrt": "20.88",
+ "sale_ntin_rate": "19.10",
+ "sale_totl_rate": "46.92"
+ },
+ {
+ "stac_yymm": "201803",
+ "cptl_ntin_rate": "15.22",
+ "self_cptl_ntin_inrt": "21.96",
+ "sale_ntin_rate": "19.30",
+ "sale_totl_rate": "47.31"
+ },
+ {
+ "stac_yymm": "201712",
+ "cptl_ntin_rate": "14.96",
+ "self_cptl_ntin_inrt": "21.01",
+ "sale_ntin_rate": "17.61",
+ "sale_totl_rate": "46.03"
+ },
+ {
+ "stac_yymm": "201709",
+ "cptl_ntin_rate": "14.28",
+ "self_cptl_ntin_inrt": "20.06",
+ "sale_ntin_rate": "17.24",
+ "sale_totl_rate": "46.11"
+ },
+ {
+ "stac_yymm": "201706",
+ "cptl_ntin_rate": "13.89",
+ "self_cptl_ntin_inrt": "19.25",
+ "sale_ntin_rate": "16.80",
+ "sale_totl_rate": "45.71"
+ },
+ {
+ "stac_yymm": "201703",
+ "cptl_ntin_rate": "11.68",
+ "self_cptl_ntin_inrt": "16.21",
+ "sale_ntin_rate": "15.20",
+ "sale_totl_rate": "44.30"
+ },
+ {
+ "stac_yymm": "201612",
+ "cptl_ntin_rate": "9.01",
+ "self_cptl_ntin_inrt": "12.48",
+ "sale_ntin_rate": "11.26",
+ "sale_totl_rate": "40.42"
+ },
+ {
+ "stac_yymm": "201609",
+ "cptl_ntin_rate": "8.57",
+ "self_cptl_ntin_inrt": "11.94",
+ "sale_ntin_rate": "10.53",
+ "sale_totl_rate": "39.82"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/098_국내주식-152_예탁원정보실권주일정.md b/docs/broker/kis/rest/국내주식/종목정보/098_국내주식-152_예탁원정보실권주일정.md
new file mode 100644
index 0000000..6dc6964
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/098_국내주식-152_예탁원정보실권주일정.md
@@ -0,0 +1,166 @@
+# 예탁원정보(실권주일정)
+
+- 원본 시트명: 예탁원정보(실권주일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-152
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669109C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/forfeit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(실권주일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0668] 실권주 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669109C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| CTS | CTS | string | Y | 17 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| subscr_dt | 청약일 | string | Y | 23 | |
+| subscr_price | 공모가 | string | Y | 9 | |
+| subscr_stk_qty | 공모주식수 | string | Y | 12 | |
+| refund_dt | 환불일 | string | Y | 10 | |
+| list_dt | 상장/등록일 | string | Y | 10 | |
+| lead_mgr | 주간사 | string | Y | 25 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240131",
+ "sht_cd": "001440",
+ "isin_name": "대한전선",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "subscr_price": "000007460",
+ "subscr_stk_qty": " 62000000",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/04/02",
+ "lead_mgr": "케이비증권,미래에셋증권,"
+ },
+ {
+ "record_date": "20240131",
+ "sht_cd": "001447",
+ "isin_name": "대한전선2우",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "subscr_price": "000007460",
+ "subscr_stk_qty": " 62000000",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/04/02",
+ "lead_mgr": "케이비증권,미래에셋증권,"
+ },
+ {
+ "record_date": "20240131",
+ "sht_cd": "001449",
+ "isin_name": "대한전선3우",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "subscr_price": "000007460",
+ "subscr_stk_qty": " 62000000",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/04/02",
+ "lead_mgr": "케이비증권,미래에셋증권,"
+ },
+ {
+ "record_date": "20240131",
+ "sht_cd": "00144A",
+ "isin_name": "대한전선4우",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "subscr_price": "000007460",
+ "subscr_stk_qty": " 62000000",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/04/02",
+ "lead_mgr": "케이비증권,미래에셋증권,"
+ },
+ {
+ "record_date": "20240131",
+ "sht_cd": "00144K",
+ "isin_name": "대한전선5우",
+ "subscr_dt": "2024/03/14 ~ 2024/03/15",
+ "subscr_price": "000007460",
+ "subscr_stk_qty": " 62000000",
+ "refund_dt": "2024/03/19",
+ "list_dt": "2024/04/02",
+ "lead_mgr": "케이비증권,미래에셋증권,"
+ },
+ {
+ "record_date": "20240126",
+ "sht_cd": "034220",
+ "isin_name": "LG디스플레이",
+ "subscr_dt": "2024/03/11 ~ 2024/03/12",
+ "subscr_price": "000009090",
+ "subscr_stk_qty": " 142184300",
+ "refund_dt": "2024/03/14",
+ "list_dt": "2024/03/26",
+ "lead_mgr": "한국투자증권,NH투자증권,"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/099_국내주식-153_예탁원정보의무예치일정.md b/docs/broker/kis/rest/국내주식/종목정보/099_국내주식-153_예탁원정보의무예치일정.md
new file mode 100644
index 0000000..9bafe52
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/099_국내주식-153_예탁원정보의무예치일정.md
@@ -0,0 +1,257 @@
+# 예탁원정보(의무예치일정)
+
+- 원본 시트명: 예탁원정보(의무예치일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-153
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669110C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/mand-deposit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(의무예치일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0758] 의무예치 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669110C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| CTS | CTS | string | Y | 17 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| stk_qty | 주식수 | string | Y | 12 | |
+| depo_date | 예치일 | string | Y | 23 | |
+| depo_reason | 사유 | string | Y | 10 | |
+| tot_issue_qty_per_rate | 총발행주식수대비비율(%) | string | Y | 52 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "sht_cd": "27322R",
+ "isin_name": "뷰텔7우",
+ "stk_qty": " 68966",
+ "depo_date": "2024/03/26 ~ 2025/03/26",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "10000"
+ },
+ {
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_qty": " 48000",
+ "depo_date": "2024/03/26 ~ 2024/06/26",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "33.51"
+ },
+ {
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_qty": " 4224840",
+ "depo_date": "2024/03/26 ~ 2027/03/26",
+ "depo_reason": "최대주주",
+ "tot_issue_qty_per_rate": "3014."
+ },
+ {
+ "sht_cd": "455900",
+ "isin_name": "엔젤로보틱스",
+ "stk_qty": " 307036",
+ "depo_date": "2024/03/26 ~ 2024/04/26",
+ "depo_reason": "최대주주",
+ "tot_issue_qty_per_rate": "214.3"
+ },
+ {
+ "sht_cd": "45590S",
+ "isin_name": "엔젤로보틱스 8우",
+ "stk_qty": " 65128",
+ "depo_date": "2024/03/26 ~ 2024/04/26",
+ "depo_reason": "벤처금융",
+ "tot_issue_qty_per_rate": "700.0"
+ },
+ {
+ "sht_cd": "45590S",
+ "isin_name": "엔젤로보틱스 8우",
+ "stk_qty": " 865277",
+ "depo_date": "2024/03/26 ~ 2024/04/26",
+ "depo_reason": "최대주주",
+ "tot_issue_qty_per_rate": "9300."
+ },
+ {
+ "sht_cd": "119650",
+ "isin_name": "케이씨코트렐",
+ "stk_qty": " 12733857",
+ "depo_date": "2024/03/25 ~ 2025/03/25",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "2000."
+ },
+ {
+ "sht_cd": "123840",
+ "isin_name": "뉴온",
+ "stk_qty": " 62516803",
+ "depo_date": "2024/03/25 ~ 2024/09/25",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "2253."
+ },
+ {
+ "sht_cd": "420570",
+ "isin_name": "제이투케이바이오",
+ "stk_qty": " 951",
+ "depo_date": "2024/03/25 ~ 2024/09/25",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": " 1.71"
+ },
+ {
+ "sht_cd": "019570",
+ "isin_name": "리더스기술투자",
+ "stk_qty": " 8905532",
+ "depo_date": "2024/03/22 ~ 2025/03/22",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "1697."
+ },
+ {
+ "sht_cd": "036180",
+ "isin_name": "지더블유바이텍",
+ "stk_qty": " 28911564",
+ "depo_date": "2024/03/22 ~ 2025/03/22",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "3160."
+ },
+ {
+ "sht_cd": "069110",
+ "isin_name": "코스온",
+ "stk_qty": " 4000000",
+ "depo_date": "2024/03/22 ~ 2025/03/22",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "1107."
+ },
+ {
+ "sht_cd": "440110",
+ "isin_name": "파두",
+ "stk_qty": " 270200",
+ "depo_date": "2024/03/22 ~ 2024/08/07",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "55.06"
+ },
+ {
+ "sht_cd": "222080",
+ "isin_name": "씨아이에스",
+ "stk_qty": " 42636",
+ "depo_date": "2024/03/21 ~ 2024/09/21",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": " 5.97"
+ },
+ {
+ "sht_cd": "245620",
+ "isin_name": "이원다이애그노믹스",
+ "stk_qty": " 17633408",
+ "depo_date": "2024/03/21 ~ 2025/03/21",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "1273."
+ },
+ {
+ "sht_cd": "437730",
+ "isin_name": "삼현",
+ "stk_qty": " 33333",
+ "depo_date": "2024/03/21 ~ 2024/06/21",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "31.54"
+ },
+ {
+ "sht_cd": "437730",
+ "isin_name": "삼현",
+ "stk_qty": " 390320",
+ "depo_date": "2024/03/21 ~ 2024/04/21",
+ "depo_reason": "벤처금융",
+ "tot_issue_qty_per_rate": "369.3"
+ },
+ {
+ "sht_cd": "476180",
+ "isin_name": "마이공사",
+ "stk_qty": " 100000",
+ "depo_date": "2024/03/20 ~ 2024/09/20",
+ "depo_reason": "-",
+ "tot_issue_qty_per_rate": "2000."
+ },
+ {
+ "sht_cd": "082740",
+ "isin_name": "한화엔진 주식회사",
+ "stk_qty": " 11903148",
+ "depo_date": "2024/03/19 ~ 2025/03/19",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "1426."
+ },
+ {
+ "sht_cd": "214870",
+ "isin_name": "뉴지랩파마",
+ "stk_qty": " 13670000",
+ "depo_date": "2024/03/18 ~ 2025/03/18",
+ "depo_reason": "모집매출",
+ "tot_issue_qty_per_rate": "2921."
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/100_v1_국내주식-079_국내주식-손익계산서.md b/docs/broker/kis/rest/국내주식/종목정보/100_v1_국내주식-079_국내주식-손익계산서.md
new file mode 100644
index 0000000..18c2942
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/100_v1_국내주식-079_국내주식-손익계산서.md
@@ -0,0 +1,552 @@
+# 국내주식 손익계산서
+
+- 원본 시트명: 국내주식 손익계산서
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-079
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 없음
+- URL 명: /uapi/domestic-stock/v1/finance/income-statement
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 손익계산서 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '2. 손익계산서' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기
※ 분기데이터는 연단위 누적합산 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| sale_account | 매출액 | string | Y | 18 | |
+| sale_cost | 매출 원가 | string | Y | 182 | |
+| sale_totl_prfi | 매출 총 이익 | string | Y | 182 | |
+| depr_cost | 감가상각비 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| sell_mang | 판매 및 관리비 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| bsop_prti | 영업 이익 | string | Y | 182 | |
+| bsop_non_ernn | 영업 외 수익 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| bsop_non_expn | 영업 외 비용 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| op_prfi | 경상 이익 | string | Y | 182 | |
+| spec_prfi | 특별 이익 | string | Y | 182 | |
+| spec_loss | 특별 손실 | string | Y | 182 | |
+| thtr_ntin | 당기순이익 | string | Y | 102 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "sale_account": "2589355.00",
+ "sale_cost": "1803886.00",
+ "sale_totl_prfi": "785469",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "65670.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "110063.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "154871.00"
+ },
+ {
+ "stac_yymm": "202309",
+ "sale_account": "1911556.00",
+ "sale_cost": "1342731.00",
+ "sale_totl_prfi": "568825",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "37423.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "74820.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "91423.00"
+ },
+ {
+ "stac_yymm": "202306",
+ "sale_account": "1237509.00",
+ "sale_cost": "876543.00",
+ "sale_totl_prfi": "360966",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "13087.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "35394.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "32982.00"
+ },
+ {
+ "stac_yymm": "202303",
+ "sale_account": "637454.00",
+ "sale_cost": "460071.00",
+ "sale_totl_prfi": "177383",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "6402.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "18264.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "15746.00"
+ },
+ {
+ "stac_yymm": "202212",
+ "sale_account": "3022314.00",
+ "sale_cost": "1900418.00",
+ "sale_totl_prfi": "1121896",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "433766.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "464405.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "556541.00"
+ },
+ {
+ "stac_yymm": "202209",
+ "sale_account": "2317668.00",
+ "sale_cost": "1414141.00",
+ "sale_totl_prfi": "903527",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "390705.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "413856.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "318126.00"
+ },
+ {
+ "stac_yymm": "202206",
+ "sale_account": "1549851.00",
+ "sale_cost": "933418.00",
+ "sale_totl_prfi": "616433",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "282185.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "295306.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "224234.00"
+ },
+ {
+ "stac_yymm": "202203",
+ "sale_account": "777815.00",
+ "sale_cost": "470721.00",
+ "sale_totl_prfi": "307094",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "141214.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "150698.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "113246.00"
+ },
+ {
+ "stac_yymm": "202112",
+ "sale_account": "2796048.00",
+ "sale_cost": "1664113.00",
+ "sale_totl_prfi": "1131935",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "516339.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "533518.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "399075.00"
+ },
+ {
+ "stac_yymm": "202109",
+ "sale_account": "2030393.00",
+ "sale_cost": "1214648.00",
+ "sale_totl_prfi": "815745",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "377671.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "389889.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "290695.00"
+ },
+ {
+ "stac_yymm": "202106",
+ "sale_account": "1290601.00",
+ "sale_cost": "785659.00",
+ "sale_totl_prfi": "504942",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "219496.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "226331.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "167762.00"
+ },
+ {
+ "stac_yymm": "202103",
+ "sale_account": "653885.00",
+ "sale_cost": "415000.00",
+ "sale_totl_prfi": "238885",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "93829.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "97506.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "71417.00"
+ },
+ {
+ "stac_yymm": "202012",
+ "sale_account": "2368070.00",
+ "sale_cost": "1444883.00",
+ "sale_totl_prfi": "923187",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "359939.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "363451.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "264078.00"
+ },
+ {
+ "stac_yymm": "202009",
+ "sale_account": "1752555.00",
+ "sale_cost": "1066834.00",
+ "sale_totl_prfi": "685721",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "269469.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "273707.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "198007.00"
+ },
+ {
+ "stac_yymm": "202006",
+ "sale_account": "1082913.00",
+ "sale_cost": "667129.00",
+ "sale_totl_prfi": "415784",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "145936.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "145265.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "104400.00"
+ },
+ {
+ "stac_yymm": "202003",
+ "sale_account": "553252.00",
+ "sale_cost": "348067.00",
+ "sale_totl_prfi": "205185",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "64473.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "67569.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "48849.00"
+ },
+ {
+ "stac_yymm": "201912",
+ "sale_account": "2304009.00",
+ "sale_cost": "1472396.00",
+ "sale_totl_prfi": "831613",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "277685.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "304322.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "217389.00"
+ },
+ {
+ "stac_yymm": "201909",
+ "sale_account": "1705161.00",
+ "sale_cost": "1086850.00",
+ "sale_totl_prfi": "618311",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "206082.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "227131.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "165118.00"
+ },
+ {
+ "stac_yymm": "201906",
+ "sale_account": "1085127.00",
+ "sale_cost": "686912.00",
+ "sale_totl_prfi": "398215",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "128303.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "140923.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "102242.00"
+ },
+ {
+ "stac_yymm": "201903",
+ "sale_account": "523855.00",
+ "sale_cost": "327464.00",
+ "sale_totl_prfi": "196391",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "62333.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "69130.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "50436.00"
+ },
+ {
+ "stac_yymm": "201812",
+ "sale_account": "2437714.00",
+ "sale_cost": "1323944.00",
+ "sale_totl_prfi": "1113770",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "588867.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "611600.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "443449.00"
+ },
+ {
+ "stac_yymm": "201809",
+ "sale_account": "1845064.00",
+ "sale_cost": "983785.00",
+ "sale_totl_prfi": "861279",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "480861.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "495521.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "358827.00"
+ },
+ {
+ "stac_yymm": "201806",
+ "sale_account": "1190464.00",
+ "sale_cost": "631841.00",
+ "sale_totl_prfi": "558623",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "305112.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "315827.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "227320.00"
+ },
+ {
+ "stac_yymm": "201803",
+ "sale_account": "605637.00",
+ "sale_cost": "319095.00",
+ "sale_totl_prfi": "286542",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "156422.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "161759.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "116885.00"
+ },
+ {
+ "stac_yymm": "201712",
+ "sale_account": "2395754.00",
+ "sale_cost": "1292907.00",
+ "sale_totl_prfi": "1102847",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "536450.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "561960.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "421867.00"
+ },
+ {
+ "stac_yymm": "201709",
+ "sale_account": "1735970.00",
+ "sale_cost": "935596.00",
+ "sale_totl_prfi": "800374",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "384981.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "394916.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "299316.00"
+ },
+ {
+ "stac_yymm": "201706",
+ "sale_account": "1115481.00",
+ "sale_cost": "605555.00",
+ "sale_totl_prfi": "509926",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "239649.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "245768.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "187382.00"
+ },
+ {
+ "stac_yymm": "201703",
+ "sale_account": "505475.00",
+ "sale_cost": "281556.00",
+ "sale_totl_prfi": "223919",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "98984.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "101646.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "76844.00"
+ },
+ {
+ "stac_yymm": "201612",
+ "sale_account": "2018667.00",
+ "sale_cost": "1202777.00",
+ "sale_totl_prfi": "815890",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "292407.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "307137.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "227261.00"
+ },
+ {
+ "stac_yymm": "201609",
+ "sale_account": "1485350.00",
+ "sale_cost": "893942.00",
+ "sale_totl_prfi": "591408",
+ "depr_cost": "99.99",
+ "sell_mang": "99.99",
+ "bsop_prti": "200199.00",
+ "bsop_non_ernn": "99.99",
+ "bsop_non_expn": "99.99",
+ "op_prfi": "211651.00",
+ "spec_prfi": "99.99",
+ "spec_loss": "99.99",
+ "thtr_ntin": "156381.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/101_국내주식-195_당사-대주가능-종목.md b/docs/broker/kis/rest/국내주식/종목정보/101_국내주식-195_당사-대주가능-종목.md
new file mode 100644
index 0000000..5dd7d6a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/101_국내주식-195_당사-대주가능-종목.md
@@ -0,0 +1,224 @@
+# 당사 대주가능 종목
+
+- 원본 시트명: 당사 대주가능 종목
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-195
+- HTTP Method: GET
+- 실전 TR_ID: CTSC2702R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/lendable-by-company
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+당사 대주가능 종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0490] 당사 대주가능 종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 본 API는 다음조회가 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTSC2702R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| EXCG_DVSN_CD | 거래소구분코드 | string | Y | 2 | 00(전체), 02(거래소), 03(코스닥) |
+| PDNO | 상품번호 | string | Y | 12 | 공백 : 전체조회, 종목코드 입력 시 해당종목만 조회 |
+| THCO_STLN_PSBL_YN | 당사대주가능여부 | string | Y | 1 | Y |
+| INQR_DVSN_1 | 조회구분1 | string | Y | 1 | 0 : 전체조회, 1: 종목코드순 정렬 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 미입력 (다음조회 불가) |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 미입력 (다음조회 불가) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| papr | 액면가 | string | Y | 19 | |
+| bfdy_clpr | 전일종가 | string | Y | 19 | 전일종가 |
+| sbst_prvs | 대용가 | string | Y | 19 | |
+| tr_stop_dvsn_name | 거래정지구분명 | string | Y | 60 | |
+| psbl_yn_name | 가능여부명 | string | Y | 60 | |
+| lmt_qty1 | 한도수량1 | string | Y | 19 | |
+| use_qty1 | 사용수량1 | string | Y | 19 | |
+| trad_psbl_qty2 | 매매가능수량2 | string | Y | 19 | 가능수량 |
+| rght_type_cd | 권리유형코드 | string | Y | 2 | |
+| bass_dt | 기준일자 | string | Y | 8 | |
+| psbl_yn | 가능여부 | string | Y | 1 | |
+| output2 | 응답상세 | object | Y | | |
+| tot_stup_lmt_qty | 총설정한도수량 | string | Y | 19 | |
+| brch_lmt_qty | 지점한도수량 | string | Y | 19 | |
+| rqst_psbl_qty | 신청가능수량 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+EXCG_DVSN_CD:00
+PDNO:
+THCO_STLN_PSBL_YN:Y
+INQR_DVSN_1:0
+CTX_AREA_FK200:
+CTX_AREA_NK100:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "00!^!^Y!^0 ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "pdno": "130960",
+ "prdt_name": "CJ E&M",
+ "papr": "5000",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "10520",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "10520",
+ "rght_type_cd": "11",
+ "bass_dt": "20180629",
+ "psbl_yn": "Y"
+ },
+ {
+ "pdno": "110550",
+ "prdt_name": "HIT 골드",
+ "papr": "0",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "32",
+ "bass_dt": "20111222",
+ "psbl_yn": "Y"
+ },
+ {
+ "pdno": "124090",
+ "prdt_name": "HIT 보험",
+ "papr": "0",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "32",
+ "bass_dt": "20111219",
+ "psbl_yn": "Y"
+ },
+ {
+ "pdno": "002550",
+ "prdt_name": "KB손해보험",
+ "papr": "500",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "13",
+ "bass_dt": "20170706",
+ "psbl_yn": "Y"
+ },
+ {
+ "pdno": "021960",
+ "prdt_name": "KB캐피탈",
+ "papr": "5000",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "13",
+ "bass_dt": "20170706",
+ "psbl_yn": "Y"
+ },
+ {
+ "pdno": "105270",
+ "prdt_name": "KINDEX 성장대형F15",
+ "papr": "0",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "32",
+ "bass_dt": "20140430",
+ "psbl_yn": "Y"
+ },...
+ {
+ "pdno": "003450",
+ "prdt_name": "현대증권",
+ "papr": "5000",
+ "bfdy_clpr": "0",
+ "sbst_prvs": "0",
+ "tr_stop_dvsn_name": "거래정지",
+ "psbl_yn_name": "가능",
+ "lmt_qty1": "0",
+ "use_qty1": "0",
+ "trad_psbl_qty2": "0",
+ "rght_type_cd": "13",
+ "bass_dt": "20161018",
+ "psbl_yn": "Y"
+ }
+ ],
+ "output2": {
+ "tot_stup_lmt_qty": "6441070",
+ "brch_lmt_qty": "-1228",
+ "rqst_psbl_qty": "6442095"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/102_v1_국내주식-067_주식기본조회.md b/docs/broker/kis/rest/국내주식/종목정보/102_v1_국내주식-067_주식기본조회.md
new file mode 100644
index 0000000..338fa33
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/102_v1_국내주식-067_주식기본조회.md
@@ -0,0 +1,211 @@
+# 주식기본조회
+
+- 원본 시트명: 주식기본조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-067
+- HTTP Method: GET
+- 실전 TR_ID: CTPF1002R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/search-stock-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식기본조회 API입니다.
+국내주식 종목의 종목상세정보를 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF1002R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 300: 주식, ETF, ETN, ELW
301 : 선물옵션
302 : 채권
306 : ELS' |
+| PDNO | 상품번호 | string | Y | 12 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| mket_id_cd | 시장ID코드 | string | Y | 3 | AGR.농축산물파생
BON.채권파생
CMD.일반상품시장
CUR.통화파생
ENG.에너지파생
EQU.주식파생
ETF.ETF파생
IRT.금리파생
KNX.코넥스
KSQ.코스닥
MTL.금속파생
SPI.주가지수파생
STK.유가증권 |
+| scty_grp_id_cd | 증권그룹ID코드 | string | Y | 2 | BC.수익증권
DR.주식예탁증서
EF.ETF
EN.ETN
EW.ELW
FE.해외ETF
FO.선물옵션
FS.외국주권
FU.선물
FX.플렉스 선물
GD.금현물
IC.투자계약증권
IF.사회간접자본투융자회사
KN.코넥스주권
MF.투자회사
OP.옵션
RT.부동산투자회사
SC.선박투자회사
SR.신주인수권증서
ST.주권
SW.신주인수권증권
TC.신탁수익증권 |
+| excg_dvsn_cd | 거래소구분코드 | string | Y | 2 | 01.한국증권
02.증권거래소
03.코스닥
04.K-OTC
05.선물거래소
06.CME
07.EUREX
21.금현물
50.미국주간
51.홍콩
52.상해B
53.심천
54.홍콩거래소
55.미국
56.일본
57.상해A
58.심천A
59.베트남
61.장전시간외시장
64.경쟁대량매매
65.경매매시장
81.시간외단일가시장 |
+| setl_mmdd | 결산월일 | string | Y | 4 | |
+| lstg_stqt | 상장주수 | string | Y | 19 | |
+| lstg_cptl_amt | 상장자본금액 | string | Y | 19 | |
+| cpta | 자본금 | string | Y | 19 | |
+| papr | 액면가 | string | Y | 19 | |
+| issu_pric | 발행가격 | string | Y | 19 | |
+| kospi200_item_yn | 코스피200종목여부 | string | Y | 1 | |
+| scts_mket_lstg_dt | 유가증권시장상장일자 | string | Y | 8 | |
+| scts_mket_lstg_abol_dt | 유가증권시장상장폐지일자 | string | Y | 8 | |
+| kosdaq_mket_lstg_dt | 코스닥시장상장일자 | string | Y | 8 | |
+| kosdaq_mket_lstg_abol_dt | 코스닥시장상장폐지일자 | string | Y | 8 | |
+| frbd_mket_lstg_dt | 프리보드시장상장일자 | string | Y | 8 | |
+| frbd_mket_lstg_abol_dt | 프리보드시장상장폐지일자 | string | Y | 8 | |
+| reits_kind_cd | 리츠종류코드 | string | Y | 1 | |
+| etf_dvsn_cd | ETF구분코드 | string | Y | 2 | |
+| oilf_fund_yn | 유전펀드여부 | string | Y | 1 | |
+| idx_bztp_lcls_cd | 지수업종대분류코드 | string | Y | 3 | |
+| idx_bztp_mcls_cd | 지수업종중분류코드 | string | Y | 3 | |
+| idx_bztp_scls_cd | 지수업종소분류코드 | string | Y | 3 | |
+| stck_kind_cd | 주식종류코드 | string | Y | 3 | 000.해당사항없음
101.보통주
201.우선주
202.2우선주
203.3우선주
204.4우선주
205.5우선주
206.6우선주
207.7우선주
208.8우선주
209.9우선주
210.10우선주
211.11우선주
212.12우선주
213.13우선주
214.14우선주
215.15우선주
216.16우선주
217.17우선주
218.18우선주
219.19우선주
220.20우선주
301.후배주
401.혼합주 |
+| mfnd_opng_dt | 뮤추얼펀드개시일자 | string | Y | 8 | |
+| mfnd_end_dt | 뮤추얼펀드종료일자 | string | Y | 8 | |
+| dpsi_erlm_cncl_dt | 예탁등록취소일자 | string | Y | 8 | |
+| etf_cu_qty | ETFCU수량 | string | Y | 10 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_name120 | 상품명120 | string | Y | 120 | |
+| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| prdt_eng_name | 상품영문명 | string | Y | 60 | |
+| prdt_eng_name120 | 상품영문명120 | string | Y | 120 | |
+| prdt_eng_abrv_name | 상품영문약어명 | string | Y | 60 | |
+| dpsi_aptm_erlm_yn | 예탁지정등록여부 | string | Y | 1 | |
+| etf_txtn_type_cd | ETF과세유형코드 | string | Y | 2 | |
+| etf_type_cd | ETF유형코드 | string | Y | 2 | |
+| lstg_abol_dt | 상장폐지일자 | string | Y | 8 | |
+| nwst_odst_dvsn_cd | 신주구주구분코드 | string | Y | 2 | |
+| sbst_pric | 대용가격 | string | Y | 19 | |
+| thco_sbst_pric | 당사대용가격 | string | Y | 19 | |
+| thco_sbst_pric_chng_dt | 당사대용가격변경일자 | string | Y | 8 | |
+| tr_stop_yn | 거래정지여부 | string | Y | 1 | |
+| admn_item_yn | 관리종목여부 | string | Y | 1 | |
+| thdt_clpr | 당일종가 | string | Y | 19 | |
+| bfdy_clpr | 전일종가 | string | Y | 19 | |
+| clpr_chng_dt | 종가변경일자 | string | Y | 8 | |
+| std_idst_clsf_cd | 표준산업분류코드 | string | Y | 6 | |
+| std_idst_clsf_cd_name | 표준산업분류코드명 | string | Y | 130 | 표준산업소분류코드
000000 해당사항없음
010101 작물 재배업
010102 축산업
010103 작물재배 및 축산 복합농업
010104 작물재배 및 축산 관련 서비스업
010105 수렵 및 관련 서비스업
010201 임업
010301 어로 어업
010302 양식어업 및 어업관련 서비스업
020501 석탄 광업
020502 원유 및 천연가스 채굴업
020601 철 광업
020602 비철금속 광업
020701 토사석 광업
020702 기타 비금속광물 광업
020801 광업 지원 서비스업
031001 도축, 육류 가공 및 저장 처리업
031002 수산물 가공 및 저장 처리업
031003 과실, 채소 가공 및 저장 처리업
031004 동물성 및 식물성 유지 제조업
031005 낙농제품 및 식용빙과류 제조업
031006 곡물가공품, 전분 및 전분제품 제조업
031007 기타 식품 제조업
031008 동물용 사료 및 조제식품 제조업
031101 알콜음료 제조업
031102 비알콜음료 및 얼음 제조업
031201 담배 제조업
031301 방적 및 가공사 제조업
031302 직물직조 및 직물제품 제조업
031303 편조원단 및 편조제품 제조업
031304 섬유제품 염색, 정리 및 마무리 가공업
031309 기타 섬유제품 제조업
031401 봉제의복 제조업
031402 모피가공 및 모피제품 제조업
031403 편조의복 제조업
031404 의복 액세서리 제조업
031501 가죽, 가방 및 유사제품 제조업
031502 신발 및 신발부분품 제조업
031601 제재 및 목재 가공업
031602 나무제품 제조업
031603 코르크 및 조물 제품 제조업
031701 펄프, 종이 및 판지 제조업
031702 골판지, 종이 상자 및 종이용기 제조업
031709 기타 종이 및 판지 제품 제조업
031801 인쇄 및 인쇄관련 산업
031802 기록매체 복제업
031901 코크스 및 연탄 제조업
031902 석유 정제품 제조업
032001 기초화학물질 제조업
032002 비료 및 질소화합물 제조업
032003 합성고무 및 플라스틱 물질 제조업
032004 기타 화학제품 제조업
032005 화학섬유 제조업
032101 기초 의약물질 및 생물학적 제제 제조업
032102 의약품 제조업
032103 의료용품 및 기타 의약관련제품 제조업
032201 고무제품 제조업
032202 플라스틱제품 제조업
032301 유리 및 유리제품 제조업
032302 도자기 및 기타 요업제품 제조업
032303 시멘트, 석회, 플라스터 및 그 제품 제조업
032309 기타 비금속 광물제품 제조업
032401 1차 철강 제조업
032402 1차 비철금속 제조업
032403 금속 주조업
032501 구조용 금속제품, 탱크 및 증기발생기 제조업
032502 무기 및 총포탄 제조업
032509 기타 금속가공제품 제조업
032601 반도체 제조업
032602 전자부품 제조업
032603 컴퓨터 및 주변장치 제조업
032604 통신 및 방송 장비 제조업
032605 영상 및 음향기기 제조업
032606 마그네틱 및 광학 매체 제조업
032701 의료용 기기 제조업
032702 측정, 시험, 항해, 제어 및 기타 정밀기기 제조업; ?
032703 안경, 사진장비 및 기타 광학기기 제조업
032704 시계 및 시계부품 제조업
032801 전동기, 발전기 및 전기 변환 · 공급 · 제어 장치
032802 일차전지 및 축전지 제조업
032803 절연선 및 케이블 제조업
032804 전구 및 조명장치 제조업
032805 가정용 기기 제조업
032809 기타 전기장비 제조업
032901 일반 목적용 기계 제조업
032902 특수 목적용 기계 제조업
033001 자동차용 엔진 및 자동차 제조업
033002 자동차 차체 및 트레일러 제조업
033003 자동차 부품 제조업
033101 선박 및 보트 건조업
033102 철도장비 제조업
033103 항공기,우주선 및 부품 제조업
033109 그외 기타 운송장비 제조업
033201 가구 제조업
033301 귀금속 및 장신용품 제조업
033302 악기 제조업
033303 운동 및 경기용구 제조업
033304 인형,장난감 및 오락용품 제조업
033309 그외 기타 제품 제조업
043501 전기업
043502 가스 제조 및 배관공급업
043503 증기, 냉온수 및 공기조절 공급업
043601 수도사업
053701 하수, 폐수 및 분뇨 처리업
053801 폐기물 수집운반업
053802 폐기물 처리업
053803 금속 및 비금속 원료 재생업
053901 환경 정화 및 복원업
064101 건물 건설업
064102 토목 건설업
064201 기반조성 및 시설물 축조관련 전문공사업
064202 건물설비 설치 공사업
064203 전기 및 통신 공사업
064204 실내건축 및 건축 마무리 공사업
064205 건설장비 운영업
074501 자동차 판매업
074502 자동차 부품 및 내장품 판매업
074503 모터사이클 및 부품 판매업
074601 상품 중개업
074602 산업용 농축산물 및 산동물 도매업
074603 음·식료품 및 담배 도매업
074604 가정용품 도매업
074605 기계장비 및 관련 물품 도매업
074606 건축자재, 철물 및 난방장치 도매업
074607 기타 전문 도매업
074608 상품 종합 도매업
074701 종합 소매업
074702 음·식료품 및 담배 소매업
074703 정보통신장비 소매업
074704 섬유, 의복, 신발 및 가죽제품 소매업
074705 기타 가정용품 소매업
074706 문화, 오락 및 여가 용품 소매업
074707 연료 소매업
074708 기타 상품 전문 소매업
074709 무점포 소매업
084901 철도운송업
084902 육상 여객 운송업
084903 도로 화물 운송업
084904 소화물 전문 운송업
084905 파이프라인 운송업
085001 해상 운송업
085002 내륙 수상 및 항만내 운송업
085101 정기 항공 운송업
085102 부정기 항공 운송업
085201 보관 및 창고업
085209 기타 운송관련 서비스업
095501 숙박시설 운영업
095509 기타 숙박업
095601 음식점업
095602 주점 및 비알콜음료점업
105801 서적, 잡지 및 기타 인쇄물 출판업
105802 소프트웨어 개발 및 공급업
105901 영화, 비디오물, 방송프로그램 제작 및 배급업
105902 오디오물 출판 및 원판 녹음업
106001 라디오 방송업
106002 텔레비전 방송업
106101 우편업
106102 전기통신업
106201 컴퓨터 프로그래밍, 시스템 통합 및 관리업
106301 자료처리, 호스팅, 포털 및 기타 인터넷 정보매개서?
106309 기타 정보 서비스업
116401 은행 및 저축기관
116402 투자기관
116409 기타 금융업
116501 보험업
116502 재 보험업
116503 연금 및 공제업
116601 금융지원 서비스업
116602 보험 및 연금관련 서비스업
126801 부동산 임대 및 공급업
126802 부동산 관련 서비스업
126901 운송장비 임대업
126902 개인 및 가정용품 임대업
126903 산업용 기계 및 장비 임대업
126904 무형재산권 임대업
137001 자연과학 및 공학 연구개발업
137002 인문 및 사회과학 연구개발업
137101 법무관련 서비스업
137102 회계 및 세무관련 서비스업
137103 광고업
137104 시장조사 및 여론조사업
137105 회사본부, 지주회사 및 경영컨설팅 서비스업
137201 건축기술, 엔지니어링 및 관련기술 서비스업
137209 기타 과학기술 서비스업
137301 수의업
137302 전문디자인업
137303 사진 촬영 및 처리업
137309 그외 기타 전문, 과학 및 기술 서비스업
147401 사업시설 유지관리 서비스업
147402 건물·산업설비 청소 및 방제 서비스업
147403 조경 관리 및 유지 서비스업
147501 인력공급 및 고용알선업
147502 여행사 및 기타 여행보조 서비스업
147503 경비, 경호 및 탐정업
147509 기타 사업지원 서비스업
158401 입법 및 일반 정부 행정
158402 사회 및 산업정책 행정
158403 외무 및 국방 행정
158404 사법 및 공공질서 행정
158405 사회보장 행정
168501 초등 교육기관
168502 중등 교육기관
168503 고등 교육기관
168504 특수학교, 외국인학교 및 대안학교
168505 일반 교습 학원
168506 기타 교육기관
168507 교육지원 서비스업
178601 병원
178602 의원
178603 공중 보건 의료업
178609 기타 보건업
178701 거주 복지시설 운영업
178702 비거주 복지시설 운영업
189001 창작 및 예술관련 서비스업
189002 도서관, 사적지 및 유사 여가관련 서비스업
189101 스포츠 서비스업
189102 유원지 및 기타 오락관련 서비스업
199401 산업 및 전문가 단체
199402 노동조합
199409 기타 협회 및 단체
199501 기계 및 장비 수리업
199502 자동차 및 모터사이클 수리업
199503 개인 및 가정용품 수리업
199601 미용, 욕탕 및 유사 서비스업
199609 그외 기타 개인 서비스업
209701 가구내 고용활동
209801 자가 소비를 위한 가사 생산 활동
209802 자가 소비를 위한 가사 서비스 활동
219901 국제 및 외국기관 |
+| idx_bztp_lcls_cd_name | 지수업종대분류코드명 | string | Y | 60 | 표준산업대분류코드
00 해당사항없음
01 농업, 임업 및 어업
02 광업
03 제조업
04 전기, 가스, 증기 및 수도사업
05 하수-폐기물 처리, 원료재생 및환경복원업
06 건설업
07 도매 및 소매업
08 운수업
09 숙박 및 음식점업
10 출판, 영상, 방송통신 및 정보서비스업
11 금융 및 보험업
12 부동산업 및 임대업
13 전문, 과학 및 기술 서비스업
14 사업시설관리 및 사업지원서비스업
15 공공행정, 국방 및 사회보장 행정
16 교육 서비스업
17 보건업 및 사회복지 서비스업
18 예술, 스포츠 및 여가관련 서비스업
19 협회 및 단체, 수리 및 기타 개인 서비스업
20 가구내 고용활동 및 달리 분류되지 않은 자가소비생산활동
21 국제 및 외국기관 |
+| idx_bztp_mcls_cd_name | 지수업종중분류코드명 | string | Y | 60 | 표준산업중분류코드
0000 해당사항없음
0101 농업
0102 임업
0103 어업
0205 석탄, 원유 및 천연가스 광업
0206 금속 광업
0207 비금속광물 광업; 연료용 제외
0208 광업 지원 서비스업
0310 식료품 제조업
0311 음료 제조업
0312 담배 제조업
0313 섬유제품 제조업; 의복제외
0314 의복, 의복액세서리 및 모피제품제조업
0315 가죽, 가방 및 신발 제조업
0316 목재 및 나무제품 제조업;가구제외
0317 펄프, 종이 및 종이제품 제조업
0318 인쇄 및 기록매체 복제업
0319 코크스, 연탄 및 석유정제품 제조업
0320 화학물질 및 화학제품 제조업;의약품 제외
0321 의료용 물질 및 의약품 제조업
0322 고무제품 및 플라스틱제품 제조업
0323 비금속 광물제품 제조업
0324 1차 금속 제조업
0325 금속가공제품 제조업;기계 및가구 제외
0326 전자부품, 컴퓨터, 영상, 음향 및 통신장비 제조업
0327 의료, 정밀, 광학기기 및 시계 제조업
0328 전기장비 제조업
0329 기타 기계 및 장비 제조업
0330 자동차 및 트레일러 제조업
0331 기타 운송장비 제조업
0332 가구 제조업
0333 기타 제품 제조업
0435 전기, 가스, 증기 및 공기조절 공급업
0436 수도사업
0537 하수, 폐수 및 분뇨 처리업
0538 폐기물 수집운반, 처리 및 원료재생업
0539 환경 정화 및 복원업
0641 종합 건설업
0642 전문직별 공사업
0745 자동차 및 부품 판매업
0746 도매 및 상품중개업
0747 소매업; 자동차 제외
0849 육상운송 및 파이프라인 운송업
0850 수상 운송업
0851 항공 운송업
0852 창고 및 운송관련 서비스업
0955 숙박업
0956 음식점 및 주점업
1058 출판업
1059 영상·오디오 기록물 제작 및 배급업
1060 방송업
1061 통신업
1062 컴퓨터 프로그래밍, 시스템 통합및 관리업
1063 정보서비스업
1164 금융업
1165 보험 및 연금업
1166 금융 및 보험 관련 서비스업
1268 부동산업
1269 임대업;부동산 제외
1370 연구개발업
1371 전문서비스업
1372 건축기술, 엔지니어링 및 기타과학기술 서비스업
1373 기타 전문, 과학 및 기술 서비스업
1474 사업시설 관리 및 조경 서비스업
1475 사업지원 서비스업
1584 공공행정, 국방 및 사회보장 행정
1685 교육 서비스업
1786 보건업
1787 사회복지 서비스업
1890 창작, 예술 및 여가관련 서비스업
1891 스포츠 및 오락관련 서비스업
1994 협회 및 단체
1995 수리업
1996 기타 개인 서비스업
2097 가구내 고용활동
2098 달리 분류되지 않은 자가소비를 위한가구의 재화 및 서비스 생산활동
2199 국제 및 외국기관 |
+| idx_bztp_scls_cd_name | 지수업종소분류코드명 | string | Y | 60 | 표준산업소분류코드 참조 |
+| ocr_no | OCR번호 | string | Y | 4 | |
+| crfd_item_yn | 크라우드펀딩종목여부 | string | Y | 1 | |
+| elec_scty_yn | 전자증권여부 | string | Y | 1 | |
+| issu_istt_cd | 발행기관코드 | string | Y | 5 | |
+| etf_chas_erng_rt_dbnb | ETF추적수익율배수 | string | Y | 19 | |
+| etf_etn_ivst_heed_item_yn | ETFETN투자유의종목여부 | string | Y | 1 | |
+| stln_int_rt_dvsn_cd | 대주이자율구분코드 | string | Y | 2 | |
+| frnr_psnl_lmt_rt | 외국인개인한도비율 | string | Y | 24 | |
+| lstg_rqsr_issu_istt_cd | 상장신청인발행기관코드 | string | Y | 5 | |
+| lstg_rqsr_item_cd | 상장신청인종목코드 | string | Y | 12 | |
+| trst_istt_issu_istt_cd | 신탁기관발행기관코드 | string | Y | 5 | |
+| cptt_trad_tr_psbl_yn | NXT 거래종목여부 | string | Y | 1 | NXT 거래가능한 종목은 Y, 그 외 종목은 N |
+| nxt_tr_stop_yn | NXT 거래정지여부 | string | Y | 1 | NXT 거래종목 중 거래정지가 된 종목은 Y, 그 외 모든 종목은 N |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"PDNO":"000660",
+"PRDT_TYPE_CD":"300"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "pdno": "00000A000660",
+ "prdt_type_cd": "300",
+ "mket_id_cd": "STK",
+ "scty_grp_id_cd": "ST",
+ "excg_dvsn_cd": "02",
+ "setl_mmdd": "12",
+ "lstg_stqt": "728002365",
+ "lstg_cptl_amt": "0",
+ "cpta": "3657652050000",
+ "papr": "5000",
+ "issu_pric": "5000",
+ "kospi200_item_yn": "Y",
+ "scts_mket_lstg_dt": "19961226",
+ "scts_mket_lstg_abol_dt": "",
+ "kosdaq_mket_lstg_dt": "",
+ "kosdaq_mket_lstg_abol_dt": "",
+ "frbd_mket_lstg_dt": "19961226",
+ "frbd_mket_lstg_abol_dt": "",
+ "reits_kind_cd": "",
+ "etf_dvsn_cd": "0",
+ "oilf_fund_yn": "N",
+ "idx_bztp_lcls_cd": "002",
+ "idx_bztp_mcls_cd": "013",
+ "idx_bztp_scls_cd": "013",
+ "stck_kind_cd": "101",
+ "mfnd_opng_dt": "",
+ "mfnd_end_dt": "",
+ "dpsi_erlm_cncl_dt": "",
+ "etf_cu_qty": "0",
+ "prdt_name": "에스케이하이닉스보통주",
+ "prdt_name120": "에스케이하이닉스보통주",
+ "prdt_abrv_name": "SK하이닉스",
+ "std_pdno": "KR7000660001",
+ "prdt_eng_name": "SK hynix",
+ "prdt_eng_name120": "SK hynix",
+ "prdt_eng_abrv_name": "SK hynix",
+ "dpsi_aptm_erlm_yn": "Y",
+ "etf_txtn_type_cd": "00",
+ "etf_type_cd": "",
+ "lstg_abol_dt": "",
+ "nwst_odst_dvsn_cd": "1",
+ "sbst_pric": "115980",
+ "thco_sbst_pric": "115980",
+ "thco_sbst_pric_chng_dt": "20240215",
+ "tr_stop_yn": "N",
+ "admn_item_yn": "N",
+ "thdt_clpr": "146800",
+ "bfdy_clpr": "148700",
+ "clpr_chng_dt": "20240216",
+ "std_idst_clsf_cd": "032601",
+ "std_idst_clsf_cd_name": "반도체 제조업",
+ "idx_bztp_lcls_cd_name": "시가총액규모대",
+ "idx_bztp_mcls_cd_name": "전기,전자",
+ "idx_bztp_scls_cd_name": "전기,전자",
+ "ocr_no": "1147",
+ "crfd_item_yn": "N",
+ "elec_scty_yn": "Y"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/103_국내주식-143_예탁원정보유상증자일정.md b/docs/broker/kis/rest/국내주식/종목정보/103_국내주식-143_예탁원정보유상증자일정.md
new file mode 100644
index 0000000..71068d2
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/103_국내주식-143_예탁원정보유상증자일정.md
@@ -0,0 +1,181 @@
+# 예탁원정보(유상증자일정)
+
+- 원본 시트명: 예탁원정보(유상증자일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-143
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669100C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/paidin-capin
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(유상증자일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0655] 유상증자 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669100C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| GB1 | 조회구분 | string | Y | 1 | 1(청약일별), 2(기준일별) |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백(전체), 특정종목 조회시(종목코드) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
+| issue_stk_qty | 발행할주식 | string | Y | 12 | |
+| fix_rate | 확정배정율 | string | Y | 152 | |
+| disc_rate | 할인율 | string | Y | 52 | |
+| fix_price | 발행예정가 | string | Y | 8 | |
+| right_dt | 권리락일 | string | Y | 8 | |
+| sub_term_ft | 청약기간 | string | Y | 8 | |
+| sub_term | 청약기간 | string | Y | 23 | |
+| list_date | 상장/등록일 | string | Y | 10 | |
+| stk_kind | 주식종류 | string | Y | 2 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+gb1:1
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240222",
+ "sht_cd": "426530",
+ "isin_name": "메타록",
+ "tot_issue_stk_qty": " 31000000",
+ "issue_stk_qty": " 273199",
+ "fix_rate": " 20.00",
+ "disc_rate": " 0.00",
+ "fix_price": " 500",
+ "right_dt": "20240221",
+ "sub_term_ft": "20240325",
+ "sub_term": "2024/03/25 ~ 2024/03/26",
+ "list_date": "",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240219",
+ "sht_cd": "429850",
+ "isin_name": "애딥",
+ "tot_issue_stk_qty": " 755400",
+ "issue_stk_qty": " 1680196",
+ "fix_rate": "397.14",
+ "disc_rate": " 0.00",
+ "fix_price": " 500",
+ "right_dt": "20240216",
+ "sub_term_ft": "20240319",
+ "sub_term": "2024/03/19 ~ 2024/03/20",
+ "list_date": "",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "321850",
+ "isin_name": "나이스엘엠에스",
+ "tot_issue_stk_qty": " 22826013",
+ "issue_stk_qty": " 5337064",
+ "fix_rate": " 44.95",
+ "disc_rate": " 0.00",
+ "fix_price": " 6000",
+ "right_dt": "20240208",
+ "sub_term_ft": "20240318",
+ "sub_term": "2024/03/18 ~ 2024/03/18",
+ "list_date": "",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240216",
+ "sht_cd": "225340",
+ "isin_name": "메디셀",
+ "tot_issue_stk_qty": " 10085593",
+ "issue_stk_qty": " 1058677",
+ "fix_rate": " 29.70",
+ "disc_rate": " 0.00",
+ "fix_price": " 1000",
+ "right_dt": "20240215",
+ "sub_term_ft": "20240314",
+ "sub_term": "2024/03/14 ~ 2024/03/15",
+ "list_date": "",
+ "stk_kind": "01"
+ },
+ {
+ "record_date": "20240131",
+ "sht_cd": "001440",
+ "isin_name": "대한전선",
+ "tot_issue_stk_qty": " 124447300",
+ "issue_stk_qty": " 62000000",
+ "fix_rate": " 50.13",
+ "disc_rate": " 0.00",
+ "fix_price": " 7460",
+ "right_dt": "20240130",
+ "sub_term_ft": "20240311",
+ "sub_term": "2024/03/11 ~ 2024/03/12",
+ "list_date": "2024/04/02",
+ "stk_kind": "01"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/104_국내주식-154_예탁원정보주주총회일정.md b/docs/broker/kis/rest/국내주식/종목정보/104_국내주식-154_예탁원정보주주총회일정.md
new file mode 100644
index 0000000..d3935bf
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/104_국내주식-154_예탁원정보주주총회일정.md
@@ -0,0 +1,278 @@
+# 예탁원정보(주주총회일정)
+
+- 원본 시트명: 예탁원정보(주주총회일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-154
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669111C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/sharehld-meet
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(주주총회일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0759] 주주총회 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669111C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| isin_name | 종목명 | string | Y | 40 | |
+| gen_meet_dt | 주총일자 | string | Y | 10 | |
+| gen_meet_type | 주총사유 | string | Y | 8 | |
+| agenda | 주총의안 | string | Y | 71 | |
+| vote_tot_qty | 의결권주식총수 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230101
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240322",
+ "sht_cd": "388370",
+ "isin_name": "(주)우앤컴퍼니",
+ "gen_meet_dt": "2024/04/18",
+ "gen_meet_type": "임시총회",
+ "agenda": "정관변경",
+ "vote_tot_qty": " 959800"
+ },
+ {
+ "record_date": "20240322",
+ "sht_cd": "388370",
+ "isin_name": "(주)우앤컴퍼니",
+ "gen_meet_dt": "2024/04/18",
+ "gen_meet_type": "임시총회",
+ "agenda": "이사선임",
+ "vote_tot_qty": " 959800"
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "323530",
+ "isin_name": "(주)아이월드제약",
+ "gen_meet_dt": "2024/04/25",
+ "gen_meet_type": "임시총회",
+ "agenda": "사내이사 선임",
+ "vote_tot_qty": " 25721999"
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "323530",
+ "isin_name": "(주)아이월드제약",
+ "gen_meet_dt": "2024/04/25",
+ "gen_meet_type": "임시총회",
+ "agenda": "정관변경",
+ "vote_tot_qty": " 25721999"
+ },
+ {
+ "record_date": "20240321",
+ "sht_cd": "323530",
+ "isin_name": "(주)아이월드제약",
+ "gen_meet_dt": "2024/04/25",
+ "gen_meet_type": "임시총회",
+ "agenda": "사외이사 선임",
+ "vote_tot_qty": " 25721999"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨(주)",
+ "gen_meet_dt": "2024/04/12",
+ "gen_meet_type": "임시총회",
+ "agenda": "이사해임(주주제안)",
+ "vote_tot_qty": " 52754723"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨(주)",
+ "gen_meet_dt": "2024/04/12",
+ "gen_meet_type": "임시총회",
+ "agenda": "정관변경(주주제안)",
+ "vote_tot_qty": " 52754723"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨(주)",
+ "gen_meet_dt": "2024/04/12",
+ "gen_meet_type": "임시총회",
+ "agenda": "이사해임(주주제안)",
+ "vote_tot_qty": " 52754723"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨(주)",
+ "gen_meet_dt": "2024/04/12",
+ "gen_meet_type": "임시총회",
+ "agenda": "사외이사 선임(주주제안)",
+ "vote_tot_qty": " 52754723"
+ },
+ {
+ "record_date": "20240315",
+ "sht_cd": "091090",
+ "isin_name": "세원이앤씨(주)",
+ "gen_meet_dt": "2024/04/12",
+ "gen_meet_type": "임시총회",
+ "agenda": "사내이사 선임(주주제안)",
+ "vote_tot_qty": " 52754723"
+ },
+ {
+ "record_date": "20240312",
+ "sht_cd": "380440",
+ "isin_name": "엔에이치기업인수목적19호(주)",
+ "gen_meet_dt": "2024/04/19",
+ "gen_meet_type": "임시총회",
+ "agenda": "청산결산보고서승인",
+ "vote_tot_qty": " 10258000"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "263540",
+ "isin_name": "(주)어스앤에어로스페이스",
+ "gen_meet_dt": "2024/04/03",
+ "gen_meet_type": "임시총회",
+ "agenda": "사내이사 선임",
+ "vote_tot_qty": " 14294091"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "263540",
+ "isin_name": "(주)어스앤에어로스페이스",
+ "gen_meet_dt": "2024/04/03",
+ "gen_meet_type": "임시총회",
+ "agenda": "사내이사 선임",
+ "vote_tot_qty": " 14294091"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "263540",
+ "isin_name": "(주)어스앤에어로스페이스",
+ "gen_meet_dt": "2024/04/03",
+ "gen_meet_type": "임시총회",
+ "agenda": "정관변경",
+ "vote_tot_qty": " 14294091"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "263540",
+ "isin_name": "(주)어스앤에어로스페이스",
+ "gen_meet_dt": "2024/04/03",
+ "gen_meet_type": "임시총회",
+ "agenda": "사내이사 선임",
+ "vote_tot_qty": " 14294091"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "263540",
+ "isin_name": "(주)어스앤에어로스페이스",
+ "gen_meet_dt": "2024/04/03",
+ "gen_meet_type": "임시총회",
+ "agenda": "사외이사 선임",
+ "vote_tot_qty": " 14294091"
+ },
+ {
+ "record_date": "20240308",
+ "sht_cd": "343990",
+ "isin_name": "비즈플레이(주)",
+ "gen_meet_dt": "2024/03/27",
+ "gen_meet_type": "종류총회",
+ "agenda": "정관변경",
+ "vote_tot_qty": " 21751896"
+ },
+ {
+ "record_date": "20240307",
+ "sht_cd": "001140",
+ "isin_name": "(주)국보",
+ "gen_meet_dt": "2024/04/26",
+ "gen_meet_type": "정기총회",
+ "agenda": "사내이사 선임",
+ "vote_tot_qty": " 13691728"
+ },
+ {
+ "record_date": "20240307",
+ "sht_cd": "001140",
+ "isin_name": "(주)국보",
+ "gen_meet_dt": "2024/04/26",
+ "gen_meet_type": "정기총회",
+ "agenda": "감사선임",
+ "vote_tot_qty": " 13691728"
+ },
+ {
+ "record_date": "20240307",
+ "sht_cd": "001140",
+ "isin_name": "(주)국보",
+ "gen_meet_dt": "2024/04/26",
+ "gen_meet_type": "정기총회",
+ "agenda": "이사 보수한도액 승인",
+ "vote_tot_qty": " 13691728"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/105_v1_국내주식-085_국내주식-성장성비율.md b/docs/broker/kis/rest/국내주식/종목정보/105_v1_국내주식-085_국내주식-성장성비율.md
new file mode 100644
index 0000000..f7c7b6b
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/105_v1_국내주식-085_국내주식-성장성비율.md
@@ -0,0 +1,304 @@
+# 국내주식 성장성비율
+
+- 원본 시트명: 국내주식 성장성비율
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-085
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430800
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/growth-ratio
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 성장성비율 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '7.성장성비율' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430800 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | ex : 000660 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| grs | 매출액 증가율 | string | Y | 124 | |
+| bsop_prfi_inrt | 영업 이익 증가율 | string | Y | 124 | |
+| equt_inrt | 자기자본 증가율 | string | Y | 92 | |
+| totl_aset_inrt | 총자산 증가율 | string | Y | 92 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "grs": "-14.33",
+ "bsop_prfi_inrt": "-84.86",
+ "equt_inrt": "2.52",
+ "totl_aset_inrt": "1.67"
+ },
+ {
+ "stac_yymm": "202309",
+ "grs": "-17.52",
+ "bsop_prfi_inrt": "-90.42",
+ "equt_inrt": "5.50",
+ "totl_aset_inrt": "-3.36"
+ },
+ {
+ "stac_yymm": "202306",
+ "grs": "-20.15",
+ "bsop_prfi_inrt": "-95.36",
+ "equt_inrt": "9.47",
+ "totl_aset_inrt": "-0.01"
+ },
+ {
+ "stac_yymm": "202303",
+ "grs": "-18.05",
+ "bsop_prfi_inrt": "-95.47",
+ "equt_inrt": "14.12",
+ "totl_aset_inrt": "3.36"
+ },
+ {
+ "stac_yymm": "202212",
+ "grs": "8.09",
+ "bsop_prfi_inrt": "-15.99",
+ "equt_inrt": "16.35",
+ "totl_aset_inrt": "5.11"
+ },
+ {
+ "stac_yymm": "202209",
+ "grs": "14.15",
+ "bsop_prfi_inrt": "3.45",
+ "equt_inrt": "16.22",
+ "totl_aset_inrt": "14.58"
+ },
+ {
+ "stac_yymm": "202206",
+ "grs": "20.09",
+ "bsop_prfi_inrt": "28.56",
+ "equt_inrt": "16.15",
+ "totl_aset_inrt": "16.44"
+ },
+ {
+ "stac_yymm": "202203",
+ "grs": "18.95",
+ "bsop_prfi_inrt": "50.50",
+ "equt_inrt": "14.96",
+ "totl_aset_inrt": "11.84"
+ },
+ {
+ "stac_yymm": "202112",
+ "grs": "18.07",
+ "bsop_prfi_inrt": "43.45",
+ "equt_inrt": "10.49",
+ "totl_aset_inrt": "12.79"
+ },
+ {
+ "stac_yymm": "202109",
+ "grs": "15.85",
+ "bsop_prfi_inrt": "40.15",
+ "equt_inrt": "7.47",
+ "totl_aset_inrt": "9.22"
+ },
+ {
+ "stac_yymm": "202106",
+ "grs": "19.18",
+ "bsop_prfi_inrt": "50.41",
+ "equt_inrt": "4.64",
+ "totl_aset_inrt": "7.49"
+ },
+ {
+ "stac_yymm": "202103",
+ "grs": "18.19",
+ "bsop_prfi_inrt": "45.53",
+ "equt_inrt": "2.96",
+ "totl_aset_inrt": "9.89"
+ },
+ {
+ "stac_yymm": "202012",
+ "grs": "2.78",
+ "bsop_prfi_inrt": "29.62",
+ "equt_inrt": "4.97",
+ "totl_aset_inrt": "7.28"
+ },
+ {
+ "stac_yymm": "202009",
+ "grs": "2.78",
+ "bsop_prfi_inrt": "30.76",
+ "equt_inrt": "4.82",
+ "totl_aset_inrt": "6.34"
+ },
+ {
+ "stac_yymm": "202006",
+ "grs": "-0.20",
+ "bsop_prfi_inrt": "13.74",
+ "equt_inrt": "4.68",
+ "totl_aset_inrt": "4.38"
+ },
+ {
+ "stac_yymm": "202003",
+ "grs": "5.61",
+ "bsop_prfi_inrt": "3.43",
+ "equt_inrt": "5.20",
+ "totl_aset_inrt": "3.59"
+ },
+ {
+ "stac_yymm": "201912",
+ "grs": "-5.48",
+ "bsop_prfi_inrt": "-52.84",
+ "equt_inrt": "6.11",
+ "totl_aset_inrt": "3.89"
+ },
+ {
+ "stac_yymm": "201909",
+ "grs": "-7.58",
+ "bsop_prfi_inrt": "-57.14",
+ "equt_inrt": "8.81",
+ "totl_aset_inrt": "4.80"
+ },
+ {
+ "stac_yymm": "201906",
+ "grs": "-8.85",
+ "bsop_prfi_inrt": "-57.95",
+ "equt_inrt": "10.56",
+ "totl_aset_inrt": "7.61"
+ },
+ {
+ "stac_yymm": "201903",
+ "grs": "-13.50",
+ "bsop_prfi_inrt": "-60.15",
+ "equt_inrt": "13.42",
+ "totl_aset_inrt": "10.43"
+ },
+ {
+ "stac_yymm": "201812",
+ "grs": "1.75",
+ "bsop_prfi_inrt": "9.77",
+ "equt_inrt": "15.51",
+ "totl_aset_inrt": "12.46"
+ },
+ {
+ "stac_yymm": "201809",
+ "grs": "6.28",
+ "bsop_prfi_inrt": "24.91",
+ "equt_inrt": "14.91",
+ "totl_aset_inrt": "13.70"
+ },
+ {
+ "stac_yymm": "201806",
+ "grs": "6.72",
+ "bsop_prfi_inrt": "27.32",
+ "equt_inrt": "16.15",
+ "totl_aset_inrt": "14.81"
+ },
+ {
+ "stac_yymm": "201803",
+ "grs": "19.82",
+ "bsop_prfi_inrt": "58.03",
+ "equt_inrt": "17.62",
+ "totl_aset_inrt": "18.26"
+ },
+ {
+ "stac_yymm": "201712",
+ "grs": "18.68",
+ "bsop_prfi_inrt": "83.46",
+ "equt_inrt": "11.16",
+ "totl_aset_inrt": "15.10"
+ },
+ {
+ "stac_yymm": "201709",
+ "grs": "16.87",
+ "bsop_prfi_inrt": "92.30",
+ "equt_inrt": "17.35",
+ "totl_aset_inrt": "21.31"
+ },
+ {
+ "stac_yymm": "201706",
+ "grs": "10.75",
+ "bsop_prfi_inrt": "61.71",
+ "equt_inrt": "10.37",
+ "totl_aset_inrt": "13.78"
+ },
+ {
+ "stac_yymm": "201703",
+ "grs": "1.54",
+ "bsop_prfi_inrt": "48.27",
+ "equt_inrt": "6.44",
+ "totl_aset_inrt": "9.52"
+ },
+ {
+ "stac_yymm": "201612",
+ "grs": "0.60",
+ "bsop_prfi_inrt": "10.70",
+ "equt_inrt": "7.76",
+ "totl_aset_inrt": "8.26"
+ },
+ {
+ "stac_yymm": "201609",
+ "grs": "0.81",
+ "bsop_prfi_inrt": "-1.24",
+ "equt_inrt": "-0.66",
+ "totl_aset_inrt": "-0.85"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/106_v1_국내주식-078_국내주식-대차대조표.md b/docs/broker/kis/rest/국내주식/종목정보/106_v1_국내주식-078_국내주식-대차대조표.md
new file mode 100644
index 0000000..52d287b
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/106_v1_국내주식-078_국내주식-대차대조표.md
@@ -0,0 +1,490 @@
+# 국내주식 대차대조표
+
+- 원본 시트명: 국내주식 대차대조표
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-078
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/balance-sheet
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 대차대조표 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '1. 대차대조표' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| cras | 유동자산 | string | Y | 112 | |
+| fxas | 고정자산 | string | Y | 112 | |
+| total_aset | 자산총계 | string | Y | 102 | |
+| flow_lblt | 유동부채 | string | Y | 112 | |
+| fix_lblt | 고정부채 | string | Y | 112 | |
+| total_lblt | 부채총계 | string | Y | 102 | |
+| cpfn | 자본금 | string | Y | 22 | |
+| cfp_surp | 자본 잉여금 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| prfi_surp | 이익 잉여금 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
+| total_cptl | 자본총계 | string | Y | 102 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202312",
+ "cras": "1959366.00",
+ "fxas": "2599694.00",
+ "total_aset": "4559060.00",
+ "flow_lblt": "757195.00",
+ "fix_lblt": "165087.00",
+ "total_lblt": "922281.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3636779.00"
+ },
+ {
+ "stac_yymm": "202309",
+ "cras": "2064386.00",
+ "fxas": "2480278.00",
+ "total_aset": "4544664.00",
+ "flow_lblt": "736252.00",
+ "fix_lblt": "169486.00",
+ "total_lblt": "905738.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3638926.00"
+ },
+ {
+ "stac_yymm": "202306",
+ "cras": "2039754.00",
+ "fxas": "2440252.00",
+ "total_aset": "4480006.00",
+ "flow_lblt": "707806.00",
+ "fix_lblt": "182443.00",
+ "total_lblt": "890249.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3589756.00"
+ },
+ {
+ "stac_yymm": "202303",
+ "cras": "2144421.00",
+ "fxas": "2396496.00",
+ "total_aset": "4540918.00",
+ "flow_lblt": "760574.00",
+ "fix_lblt": "182349.00",
+ "total_lblt": "942924.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3597994.00"
+ },
+ {
+ "stac_yymm": "202212",
+ "cras": "2184706.00",
+ "fxas": "2299539.00",
+ "total_aset": "4484245.00",
+ "flow_lblt": "783449.00",
+ "fix_lblt": "153301.00",
+ "total_lblt": "936749.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3547496.00"
+ },
+ {
+ "stac_yymm": "202209",
+ "cras": "2508806.00",
+ "fxas": "2193978.00",
+ "total_aset": "4702784.00",
+ "flow_lblt": "852857.00",
+ "fix_lblt": "400859.00",
+ "total_lblt": "1253715.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3449069.00"
+ },
+ {
+ "stac_yymm": "202206",
+ "cras": "2362875.00",
+ "fxas": "2117532.00",
+ "total_aset": "4480407.00",
+ "flow_lblt": "833623.00",
+ "fix_lblt": "367717.00",
+ "total_lblt": "1201340.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3279067.00"
+ },
+ {
+ "stac_yymm": "202203",
+ "cras": "2323691.00",
+ "fxas": "2069579.00",
+ "total_aset": "4393270.00",
+ "flow_lblt": "904637.00",
+ "fix_lblt": "335723.00",
+ "total_lblt": "1240360.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3152909.00"
+ },
+ {
+ "stac_yymm": "202112",
+ "cras": "2181632.00",
+ "fxas": "2084580.00",
+ "total_aset": "4266212.00",
+ "flow_lblt": "881171.00",
+ "fix_lblt": "336041.00",
+ "total_lblt": "1217212.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "3048999.00"
+ },
+ {
+ "stac_yymm": "202109",
+ "cras": "2127930.00",
+ "fxas": "1976277.00",
+ "total_aset": "4104207.00",
+ "flow_lblt": "818720.00",
+ "fix_lblt": "317826.00",
+ "total_lblt": "1136546.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2967661.00"
+ },
+ {
+ "stac_yymm": "202106",
+ "cras": "1911185.00",
+ "fxas": "1936591.00",
+ "total_aset": "3847777.00",
+ "flow_lblt": "724615.00",
+ "fix_lblt": "299920.00",
+ "total_lblt": "1024534.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2823243.00"
+ },
+ {
+ "stac_yymm": "202103",
+ "cras": "2091554.00",
+ "fxas": "1836709.00",
+ "total_aset": "3928263.00",
+ "flow_lblt": "901095.00",
+ "fix_lblt": "284482.00",
+ "total_lblt": "1185577.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2742686.00"
+ },
+ {
+ "stac_yymm": "202012",
+ "cras": "1982156.00",
+ "fxas": "1800201.00",
+ "total_aset": "3782357.00",
+ "flow_lblt": "756044.00",
+ "fix_lblt": "266834.00",
+ "total_lblt": "1022877.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2759480.00"
+ },
+ {
+ "stac_yymm": "202009",
+ "cras": "2036349.00",
+ "fxas": "1721538.00",
+ "total_aset": "3757887.00",
+ "flow_lblt": "730464.00",
+ "fix_lblt": "266061.00",
+ "total_lblt": "996526.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2761362.00"
+ },
+ {
+ "stac_yymm": "202006",
+ "cras": "1861368.00",
+ "fxas": "1718227.00",
+ "total_aset": "3579595.00",
+ "flow_lblt": "618637.00",
+ "fix_lblt": "262880.00",
+ "total_lblt": "881517.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2698078.00"
+ },
+ {
+ "stac_yymm": "202003",
+ "cras": "1867397.00",
+ "fxas": "1707178.00",
+ "total_aset": "3574575.00",
+ "flow_lblt": "647633.00",
+ "fix_lblt": "263065.00",
+ "total_lblt": "910698.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2663877.00"
+ },
+ {
+ "stac_yymm": "201912",
+ "cras": "1813853.00",
+ "fxas": "1711792.00",
+ "total_aset": "3525645.00",
+ "flow_lblt": "637828.00",
+ "fix_lblt": "259013.00",
+ "total_lblt": "896841.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2628804.00"
+ },
+ {
+ "stac_yymm": "201909",
+ "cras": "1860421.00",
+ "fxas": "1673439.00",
+ "total_aset": "3533860.00",
+ "flow_lblt": "633032.00",
+ "fix_lblt": "266405.00",
+ "total_lblt": "899437.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2634422.00"
+ },
+ {
+ "stac_yymm": "201906",
+ "cras": "1734335.00",
+ "fxas": "1695067.00",
+ "total_aset": "3429401.00",
+ "flow_lblt": "593093.00",
+ "fix_lblt": "258838.00",
+ "total_lblt": "851931.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2577470.00"
+ },
+ {
+ "stac_yymm": "201903",
+ "cras": "1773885.00",
+ "fxas": "1676794.00",
+ "total_aset": "3450679.00",
+ "flow_lblt": "673541.00",
+ "fix_lblt": "244986.00",
+ "total_lblt": "918527.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2532152.00"
+ },
+ {
+ "stac_yymm": "201812",
+ "cras": "1746974.00",
+ "fxas": "1646598.00",
+ "total_aset": "3393572.00",
+ "flow_lblt": "690815.00",
+ "fix_lblt": "225226.00",
+ "total_lblt": "916041.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2477532.00"
+ },
+ {
+ "stac_yymm": "201809",
+ "cras": "1762820.00",
+ "fxas": "1609137.00",
+ "total_aset": "3371958.00",
+ "flow_lblt": "747059.00",
+ "fix_lblt": "203868.00",
+ "total_lblt": "950926.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2421032.00"
+ },
+ {
+ "stac_yymm": "201806",
+ "cras": "1569768.00",
+ "fxas": "1617115.00",
+ "total_aset": "3186884.00",
+ "flow_lblt": "656023.00",
+ "fix_lblt": "199612.00",
+ "total_lblt": "855635.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2331248.00"
+ },
+ {
+ "stac_yymm": "201803",
+ "cras": "1549420.00",
+ "fxas": "1575312.00",
+ "total_aset": "3124731.00",
+ "flow_lblt": "682986.00",
+ "fix_lblt": "209146.00",
+ "total_lblt": "892132.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2232599.00"
+ },
+ {
+ "stac_yymm": "201712",
+ "cras": "1469825.00",
+ "fxas": "1547696.00",
+ "total_aset": "3017521.00",
+ "flow_lblt": "671751.00",
+ "fix_lblt": "200855.00",
+ "total_lblt": "872607.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2144914.00"
+ },
+ {
+ "stac_yymm": "201709",
+ "cras": "1453223.00",
+ "fxas": "1512562.00",
+ "total_aset": "2965786.00",
+ "flow_lblt": "661726.00",
+ "fix_lblt": "197147.00",
+ "total_lblt": "858873.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2106913.00"
+ },
+ {
+ "stac_yymm": "201706",
+ "cras": "1321727.00",
+ "fxas": "1454168.00",
+ "total_aset": "2775894.00",
+ "flow_lblt": "584684.00",
+ "fix_lblt": "184153.00",
+ "total_lblt": "768837.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "2007057.00"
+ },
+ {
+ "stac_yymm": "201703",
+ "cras": "1292842.00",
+ "fxas": "1349332.00",
+ "total_aset": "2642174.00",
+ "flow_lblt": "568431.00",
+ "fix_lblt": "175563.00",
+ "total_lblt": "743994.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "1898180.00"
+ },
+ {
+ "stac_yymm": "201612",
+ "cras": "1414297.00",
+ "fxas": "1207446.00",
+ "total_aset": "2621743.00",
+ "flow_lblt": "547041.00",
+ "fix_lblt": "145072.00",
+ "total_lblt": "692113.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "1929630.00"
+ },
+ {
+ "stac_yymm": "201609",
+ "cras": "1321668.00",
+ "fxas": "1123047.00",
+ "total_aset": "2444715.00",
+ "flow_lblt": "504595.00",
+ "fix_lblt": "144756.00",
+ "total_lblt": "649351.00",
+ "cpfn": "8975",
+ "cfp_surp": "99.99",
+ "prfi_surp": "99.99",
+ "total_cptl": "1795364.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/107_국내주식-147_예탁원정보합병_분할일정.md b/docs/broker/kis/rest/국내주식/종목정보/107_국내주식-147_예탁원정보합병_분할일정.md
new file mode 100644
index 0000000..cd36c03
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/107_국내주식-147_예탁원정보합병_분할일정.md
@@ -0,0 +1,953 @@
+# 예탁원정보(합병_분할일정)
+
+- 원본 시트명: 예탁원정보(합병_분할일정)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-147
+- HTTP Method: GET
+- 실전 TR_ID: HHKDB669104C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/ksdinfo/merger-split
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+예탁원정보(합병/분할일정) API입니다.
+한국투자 HTS(eFriend Plus) > [0664] 합병/분할 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 예탁원에서 제공한 자료이므로 정보용으로만 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKDB669104C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CTS | CTS | string | Y | 17 | 공백 |
+| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
+| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
+| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| record_date | 기준일 | string | Y | 8 | |
+| sht_cd | 종목코드 | string | Y | 9 | |
+| opp_cust_cd | 피합병(피분할)회사코드 | string | Y | 5 | |
+| opp_cust_nm | 피합병(피분할)회사명 | string | Y | 37 | |
+| cust_cd | 합병(분할)회사코드 | string | Y | 5 | |
+| cust_nm | 합병(분할)회사명 | string | Y | 37 | |
+| merge_type | 합병사유 | string | Y | 8 | |
+| merge_rate | 비율 | string | Y | 142 | |
+| td_stop_dt | 매매거래정지기간 | string | Y | 23 | |
+| list_dt | 상장/등록일 | string | Y | 9 | |
+| odd_amt_pay_dt | 단주대금지급일 | string | Y | 10 | |
+| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
+| issue_stk_qty | 발행할주식 | string | Y | 12 | |
+| seq | 연번 | string | Y | 3 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+cts:
+f_dt:20230301
+t_dt:20240326
+sht_cd:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "record_date": "20240311",
+ "sht_cd": "224020",
+ "opp_cust_cd": "22402",
+ "opp_cust_nm": "에스케이씨에스",
+ "cust_cd": "17735",
+ "cust_nm": "베셀",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.66",
+ "td_stop_dt": "2024/03/08 ~ 2024/03/28",
+ "list_dt": "20240329",
+ "odd_amt_pay_dt": "2024/04/05",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240305",
+ "sht_cd": "397880",
+ "opp_cust_cd": "39788",
+ "opp_cust_nm": "교보11호기업인수목적",
+ "cust_cd": "42057",
+ "cust_nm": "제이투케이바이오",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.12",
+ "td_stop_dt": "2024/03/04 ~",
+ "list_dt": "20240325",
+ "odd_amt_pay_dt": "2024/04/01",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "210980",
+ "opp_cust_cd": "21098",
+ "opp_cust_nm": "에스케이디앤디",
+ "cust_cd": "47515",
+ "cust_nm": "에스케이이터닉스",
+ "merge_type": "회사분할",
+ "merge_rate": " 1.15",
+ "td_stop_dt": "2024/02/28 ~ 2024/03/28",
+ "list_dt": "20240329",
+ "odd_amt_pay_dt": "2024/04/05",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240229",
+ "sht_cd": "21098L",
+ "opp_cust_cd": "21098",
+ "opp_cust_nm": "에스케이디앤디",
+ "cust_cd": "21098",
+ "cust_nm": "에스케이디앤디",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.77",
+ "td_stop_dt": "2024/02/28 ~ 2024/03/28",
+ "list_dt": "20240329",
+ "odd_amt_pay_dt": "2024/04/05",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240228",
+ "sht_cd": "072700",
+ "opp_cust_cd": "07270",
+ "opp_cust_nm": "더존홀딩스",
+ "cust_cd": "01251",
+ "cust_nm": "더존비즈온",
+ "merge_type": "흡수합병",
+ "merge_rate": "834.0",
+ "td_stop_dt": "2024/02/27 ~ 2024/03/21",
+ "list_dt": "20240322",
+ "odd_amt_pay_dt": "2024/03/29",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240228",
+ "sht_cd": "452240",
+ "opp_cust_cd": "45224",
+ "opp_cust_nm": "뉴온",
+ "cust_cd": "12384",
+ "cust_nm": "뉴온",
+ "merge_type": "흡수합병",
+ "merge_rate": "24.52",
+ "td_stop_dt": "",
+ "list_dt": "20240325",
+ "odd_amt_pay_dt": "2024/04/02",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "001880",
+ "opp_cust_cd": "00188",
+ "opp_cust_nm": "디엘건설",
+ "cust_cd": "37550",
+ "cust_nm": "디엘이앤씨",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.37",
+ "td_stop_dt": "2024/02/08 ~ 2024/03/03",
+ "list_dt": "20240304",
+ "odd_amt_pay_dt": "2024/03/12",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "00188K",
+ "opp_cust_cd": "00188",
+ "opp_cust_nm": "디엘건설",
+ "cust_cd": "00188",
+ "cust_nm": "디엘건설",
+ "merge_type": "주식교환",
+ "merge_rate": " 1.00",
+ "td_stop_dt": "2024/02/08 ~ 2024/03/03",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240213",
+ "sht_cd": "115960",
+ "opp_cust_cd": "11596",
+ "opp_cust_nm": "연우",
+ "cust_cd": "16189",
+ "cust_nm": "한국콜마",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.29",
+ "td_stop_dt": "2024/02/08 ~ 2024/03/05",
+ "list_dt": "20240306",
+ "odd_amt_pay_dt": "2024/03/13",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240130",
+ "sht_cd": "183410",
+ "opp_cust_cd": "18341",
+ "opp_cust_nm": "골프존데카",
+ "cust_cd": "21500",
+ "cust_nm": "골프존",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.01",
+ "td_stop_dt": "2024/01/29 ~ 2024/02/21",
+ "list_dt": "20240222",
+ "odd_amt_pay_dt": "2024/02/28",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240123",
+ "sht_cd": "372290",
+ "opp_cust_cd": "37229",
+ "opp_cust_nm": "하나머스트7호기업인수목적",
+ "cust_cd": "45243",
+ "cust_nm": "사피엔반도체",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.13",
+ "td_stop_dt": "2024/01/22 ~",
+ "list_dt": "20240219",
+ "odd_amt_pay_dt": "2024/02/23",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240122",
+ "sht_cd": "426550",
+ "opp_cust_cd": "42655",
+ "opp_cust_nm": "아이비케이에스제19호기업인수목적",
+ "cust_cd": "44367",
+ "cust_nm": "에스피소프트",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.62",
+ "td_stop_dt": "2024/01/19 ~",
+ "list_dt": "20240215",
+ "odd_amt_pay_dt": "2024/02/22",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240115",
+ "sht_cd": "068400",
+ "opp_cust_cd": "06840",
+ "opp_cust_nm": "에스케이렌터카",
+ "cust_cd": "06840",
+ "cust_nm": "에스케이렌터카",
+ "merge_type": "주식교환",
+ "merge_rate": " 1.00",
+ "td_stop_dt": "2024/01/12 ~ 2024/01/30",
+ "list_dt": "20240131",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240115",
+ "sht_cd": "427950",
+ "opp_cust_cd": "42795",
+ "opp_cust_nm": "하나금융23호기업인수목적",
+ "cust_cd": "19955",
+ "cust_nm": "레이저옵텍",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.23",
+ "td_stop_dt": "2024/01/12 ~",
+ "list_dt": "20240201",
+ "odd_amt_pay_dt": "2024/02/07",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20240108",
+ "sht_cd": "377400",
+ "opp_cust_cd": "37740",
+ "opp_cust_nm": "하이제6호기업인수목적",
+ "cust_cd": "36299",
+ "cust_nm": "드림인사이트",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.37",
+ "td_stop_dt": "2024/01/05 ~",
+ "list_dt": "20240125",
+ "odd_amt_pay_dt": "2024/02/02",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231227",
+ "sht_cd": "033290",
+ "opp_cust_cd": "03329",
+ "opp_cust_nm": "코웰패션",
+ "cust_cd": "47285",
+ "cust_nm": "폰드그룹",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.37",
+ "td_stop_dt": "2023/12/26 ~ 2024/02/01",
+ "list_dt": "20240202",
+ "odd_amt_pay_dt": "2024/02/08",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231219",
+ "sht_cd": "091990",
+ "opp_cust_cd": "09199",
+ "opp_cust_nm": "셀트리온헬스케어",
+ "cust_cd": "06827",
+ "cust_nm": "셀트리온",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.45",
+ "td_stop_dt": "2023/12/18 ~ 2024/01/11",
+ "list_dt": "20240112",
+ "odd_amt_pay_dt": "2024/02/08",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231211",
+ "sht_cd": "404950",
+ "opp_cust_cd": "40495",
+ "opp_cust_nm": "디비금융제10호기업인수목적",
+ "cust_cd": "45219",
+ "cust_nm": "한빛레이저",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.65",
+ "td_stop_dt": "2023/12/08 ~",
+ "list_dt": "20240104",
+ "odd_amt_pay_dt": "2024/01/11",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231204",
+ "sht_cd": "450410",
+ "opp_cust_cd": "45041",
+ "opp_cust_nm": "엔에이치기업인수목적28호",
+ "cust_cd": "10967",
+ "cust_nm": "씨싸이트",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.18",
+ "td_stop_dt": "2023/12/01 ~",
+ "list_dt": "20231221",
+ "odd_amt_pay_dt": "2023/12/28",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231203",
+ "sht_cd": "046140",
+ "opp_cust_cd": "04614",
+ "opp_cust_nm": "에스비에스콘텐츠허브",
+ "cust_cd": "04614",
+ "cust_nm": "에스비에스콘텐츠허브",
+ "merge_type": "주식교환",
+ "merge_rate": " 1.00",
+ "td_stop_dt": "2023/11/30 ~ 2023/12/17",
+ "list_dt": "",
+ "odd_amt_pay_dt": "2023/12/26",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231107",
+ "sht_cd": "173200",
+ "opp_cust_cd": "17320",
+ "opp_cust_nm": "아센텍",
+ "cust_cd": "47196",
+ "cust_nm": "세종에이앤에프",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.14",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231107",
+ "sht_cd": "367360",
+ "opp_cust_cd": "36736",
+ "opp_cust_nm": "디비금융제9호기업인수목적",
+ "cust_cd": "45216",
+ "cust_nm": "제이엔비",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.35",
+ "td_stop_dt": "2023/11/06 ~",
+ "list_dt": "20231124",
+ "odd_amt_pay_dt": "2023/12/01",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231017",
+ "sht_cd": "440200",
+ "opp_cust_cd": "44020",
+ "opp_cust_nm": "케이비제23호기업인수목적",
+ "cust_cd": "18826",
+ "cust_nm": "세니젠",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.24",
+ "td_stop_dt": "2023/10/16 ~",
+ "list_dt": "20231103",
+ "odd_amt_pay_dt": "2023/11/10",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231012",
+ "sht_cd": "085370",
+ "opp_cust_cd": "08537",
+ "opp_cust_nm": "루트로닉",
+ "cust_cd": "08537",
+ "cust_nm": "루트로닉",
+ "merge_type": "주식교환",
+ "merge_rate": " 1.00",
+ "td_stop_dt": "2023/10/11 ~",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231012",
+ "sht_cd": "08537M",
+ "opp_cust_cd": "08537",
+ "opp_cust_nm": "루트로닉",
+ "cust_cd": "08537",
+ "cust_nm": "루트로닉",
+ "merge_type": "주식교환",
+ "merge_rate": " 1.00",
+ "td_stop_dt": "2023/10/11 ~",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231011",
+ "sht_cd": "284100",
+ "opp_cust_cd": "28410",
+ "opp_cust_nm": "이안프론티어",
+ "cust_cd": "46939",
+ "cust_nm": "퍼스트온파트너스",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.11",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231011",
+ "sht_cd": "405350",
+ "opp_cust_cd": "40535",
+ "opp_cust_nm": "아이비케이에스제17호기업인수목적",
+ "cust_cd": "29056",
+ "cust_nm": "신시웨이",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.23",
+ "td_stop_dt": "2023/10/10 ~",
+ "list_dt": "20231103",
+ "odd_amt_pay_dt": "2023/11/08",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20231010",
+ "sht_cd": "177900",
+ "opp_cust_cd": "17790",
+ "opp_cust_nm": "쓰리에이로직스",
+ "cust_cd": "46933",
+ "cust_nm": "쓰리에이솔루션",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.20",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "2023/11/29",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230927",
+ "sht_cd": "077500",
+ "opp_cust_cd": "07750",
+ "opp_cust_nm": "유니퀘스트",
+ "cust_cd": "19265",
+ "cust_nm": "드림텍",
+ "merge_type": "분할합병",
+ "merge_rate": " 0.92",
+ "td_stop_dt": "2023/09/26 ~ 2023/10/22",
+ "list_dt": "20231023",
+ "odd_amt_pay_dt": "2023/11/01",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230919",
+ "sht_cd": "019360",
+ "opp_cust_cd": "01936",
+ "opp_cust_nm": "한국신소재",
+ "cust_cd": "01796",
+ "cust_nm": "한국카본",
+ "merge_type": "흡수합병",
+ "merge_rate": "39.74",
+ "td_stop_dt": "",
+ "list_dt": "20231020",
+ "odd_amt_pay_dt": "2023/10/27",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230904",
+ "sht_cd": "366330",
+ "opp_cust_cd": "36633",
+ "opp_cust_nm": "신한제7호기업인수목적",
+ "cust_cd": "38447",
+ "cust_nm": "코어라인소프트",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.19",
+ "td_stop_dt": "2023/09/01 ~",
+ "list_dt": "20230918",
+ "odd_amt_pay_dt": "2023/09/26",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230831",
+ "sht_cd": "011810",
+ "opp_cust_cd": "01181",
+ "opp_cust_nm": "STX",
+ "cust_cd": "46577",
+ "cust_nm": "STX 그린로지스",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.23",
+ "td_stop_dt": "2023/08/30 ~ 2023/09/14",
+ "list_dt": "20230915",
+ "odd_amt_pay_dt": "2023/10/31",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230824",
+ "sht_cd": "048120",
+ "opp_cust_cd": "04812",
+ "opp_cust_nm": "원옥",
+ "cust_cd": "16857",
+ "cust_nm": "포겟",
+ "merge_type": "흡수합병",
+ "merge_rate": "12.00",
+ "td_stop_dt": "",
+ "list_dt": "20230912",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230822",
+ "sht_cd": "400560",
+ "opp_cust_cd": "40056",
+ "opp_cust_nm": "하나금융20호기업인수목적",
+ "cust_cd": "40349",
+ "cust_nm": "농업회사법인 우듬지팜",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.74",
+ "td_stop_dt": "2023/08/21 ~",
+ "list_dt": "20230919",
+ "odd_amt_pay_dt": "2023/09/26",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230821",
+ "sht_cd": "259210",
+ "opp_cust_cd": "25921",
+ "opp_cust_nm": "글람",
+ "cust_cd": "25921",
+ "cust_nm": "글람",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.00",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230821",
+ "sht_cd": "367480",
+ "opp_cust_cd": "36748",
+ "opp_cust_nm": "유안타제8호기업인수목적",
+ "cust_cd": "14606",
+ "cust_nm": "율촌",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.87",
+ "td_stop_dt": "2023/08/18 ~",
+ "list_dt": "20230908",
+ "odd_amt_pay_dt": "2023/09/14",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230808",
+ "sht_cd": "409570",
+ "opp_cust_cd": "40957",
+ "opp_cust_nm": "한국제10호기업인수목적",
+ "cust_cd": "35539",
+ "cust_nm": "크라우드웍스",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.09",
+ "td_stop_dt": "",
+ "list_dt": "20230831",
+ "odd_amt_pay_dt": "2023/09/07",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230807",
+ "sht_cd": "010050",
+ "opp_cust_cd": "01005",
+ "opp_cust_nm": "우리종합금융",
+ "cust_cd": "31614",
+ "cust_nm": "우리금융지주",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.06",
+ "td_stop_dt": "2023/08/04 ~ 2023/08/27",
+ "list_dt": "20230828",
+ "odd_amt_pay_dt": "2023/08/31",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230807",
+ "sht_cd": "298870",
+ "opp_cust_cd": "29887",
+ "opp_cust_nm": "우리벤처파트너스",
+ "cust_cd": "31614",
+ "cust_nm": "우리금융지주",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.22",
+ "td_stop_dt": "2023/08/04 ~ 2023/08/27",
+ "list_dt": "20230828",
+ "odd_amt_pay_dt": "2023/08/31",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230702",
+ "sht_cd": "390620",
+ "opp_cust_cd": "39062",
+ "opp_cust_nm": "엠리테일",
+ "cust_cd": "05788",
+ "cust_nm": "피에이치씨",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.00",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230630",
+ "sht_cd": "000480",
+ "opp_cust_cd": "00048",
+ "opp_cust_nm": "시알홀딩스",
+ "cust_cd": "46252",
+ "cust_nm": "조선내화",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.30",
+ "td_stop_dt": "2023/06/29 ~ 2023/07/27",
+ "list_dt": "20230728",
+ "odd_amt_pay_dt": "2023/08/04",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230630",
+ "sht_cd": "011870",
+ "opp_cust_cd": "01187",
+ "opp_cust_nm": "엘티삼보",
+ "cust_cd": "46220",
+ "cust_nm": "엘티",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.33",
+ "td_stop_dt": "2023/06/29 ~ 2023/07/30",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230626",
+ "sht_cd": "046110",
+ "opp_cust_cd": "04611",
+ "opp_cust_nm": "한일네트웍스",
+ "cust_cd": "03787",
+ "cust_nm": "유베이스",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.00",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230531",
+ "sht_cd": "001230",
+ "opp_cust_cd": "00123",
+ "opp_cust_nm": "동국홀딩스",
+ "cust_cd": "46086",
+ "cust_nm": "동국제강",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.52",
+ "td_stop_dt": "2023/05/30 ~ 2023/06/15",
+ "list_dt": "20230616",
+ "odd_amt_pay_dt": "2023/06/23",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230501",
+ "sht_cd": "388220",
+ "opp_cust_cd": "38822",
+ "opp_cust_nm": "하나금융19호기업인수목적",
+ "cust_cd": "27183",
+ "cust_nm": "팸텍",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.41",
+ "td_stop_dt": "2023/04/27 ~",
+ "list_dt": "20230523",
+ "odd_amt_pay_dt": "2023/05/30",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230428",
+ "sht_cd": "005950",
+ "opp_cust_cd": "00595",
+ "opp_cust_nm": "이수화학",
+ "cust_cd": "45719",
+ "cust_nm": "이수스페셜티케미컬",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.20",
+ "td_stop_dt": "2023/04/27 ~ 2023/05/30",
+ "list_dt": "20230531",
+ "odd_amt_pay_dt": "2023/06/14",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230428",
+ "sht_cd": "010060",
+ "opp_cust_cd": "01006",
+ "opp_cust_nm": "OCI홀딩스",
+ "cust_cd": "45604",
+ "cust_nm": "OCI",
+ "merge_type": "회사분할",
+ "merge_rate": " 0.31",
+ "td_stop_dt": "2023/04/27 ~ 2023/05/29",
+ "list_dt": "20230530",
+ "odd_amt_pay_dt": "2023/06/05",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230411",
+ "sht_cd": "246070",
+ "opp_cust_cd": "24607",
+ "opp_cust_nm": "딤채홀딩스",
+ "cust_cd": "00288",
+ "cust_nm": "대유에이텍",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.00",
+ "td_stop_dt": "",
+ "list_dt": "",
+ "odd_amt_pay_dt": "",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230410",
+ "sht_cd": "396770",
+ "opp_cust_cd": "39677",
+ "opp_cust_nm": "엔에이치기업인수목적22호",
+ "cust_cd": "29883",
+ "cust_nm": "슈어소프트테크",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.37",
+ "td_stop_dt": "2023/04/07 ~",
+ "list_dt": "20230428",
+ "odd_amt_pay_dt": "2023/05/04",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230410",
+ "sht_cd": "421750",
+ "opp_cust_cd": "42175",
+ "opp_cust_nm": "벨로크",
+ "cust_cd": "42476",
+ "cust_nm": "벨로크",
+ "merge_type": "흡수합병",
+ "merge_rate": " 5.12",
+ "td_stop_dt": "",
+ "list_dt": "20230428",
+ "odd_amt_pay_dt": "2023/05/04",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230404",
+ "sht_cd": "008560",
+ "opp_cust_cd": "00856",
+ "opp_cust_nm": "메리츠증권",
+ "cust_cd": "13804",
+ "cust_nm": "메리츠금융지주",
+ "merge_type": "주식교환",
+ "merge_rate": " 0.16",
+ "td_stop_dt": "2023/04/03 ~ 2023/04/24",
+ "list_dt": "20230425",
+ "odd_amt_pay_dt": "2023/04/28",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230403",
+ "sht_cd": "426670",
+ "opp_cust_cd": "42667",
+ "opp_cust_nm": "대신밸런스제12호기업인수목적",
+ "cust_cd": "31816",
+ "cust_nm": "셀바이오휴먼텍",
+ "merge_type": "흡수합병",
+ "merge_rate": " 0.33",
+ "td_stop_dt": "2023/03/31 ~",
+ "list_dt": "20230420",
+ "odd_amt_pay_dt": "2023/04/26",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ },
+ {
+ "record_date": "20230317",
+ "sht_cd": "062760",
+ "opp_cust_cd": "06276",
+ "opp_cust_nm": "코스텍시스",
+ "cust_cd": "35515",
+ "cust_nm": "코스텍시스",
+ "merge_type": "흡수합병",
+ "merge_rate": " 6.42",
+ "td_stop_dt": "2023/03/16 ~ 2023/04/02",
+ "list_dt": "20230403",
+ "odd_amt_pay_dt": "2023/04/10",
+ "tot_issue_stk_qty": " 0",
+ "issue_stk_qty": " 0",
+ "seq": "00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/108_국내주식-187_국내주식-종목추정실적.md b/docs/broker/kis/rest/국내주식/종목정보/108_국내주식-187_국내주식-종목추정실적.md
new file mode 100644
index 0000000..190c97c
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/108_국내주식-187_국내주식-종목추정실적.md
@@ -0,0 +1,235 @@
+# 국내주식 종목추정실적
+
+- 원본 시트명: 국내주식 종목추정실적
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: 국내주식-187
+- HTTP Method: GET
+- 실전 TR_ID: HHKST668300C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/estimate-perform
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 종목추정실적 API입니다.
+한국투자 HTS(eFriend Plus) > [0613] 종목추정실적 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 본 화면의 추정실적 및 투자의견은 당월 초의 애널리스트의 의견사항이므로 월중 변동 사항이 있을 수 있음을 유의하시기 바랍니다.
+※ 종목별 수익추정은 리서치본부에서 매월 발표되는 거래소, 코스닥 160여개 기업에 한정합니다. 구체적인 종목 리스트는 추정종목리스트를 참고하기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHKST668300C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SHT_CD | 종목코드 | string | Y | 2 | ex) 265520 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| sht_cd | ELW단축종목코드 | string | Y | 9 | |
+| item_kor_nm | HTS한글종목명 | string | Y | 40 | |
+| name1 | ELW현재가 | string | Y | 10 | |
+| name2 | 전일대비 | string | Y | 10 | |
+| estdate | 전일대비부호 | string | Y | 1 | |
+| rcmd_name | 전일대비율 | string | Y | 82 | |
+| capital | 누적거래량 | string | Y | 18 | |
+| forn_item_lmtrt | 행사가 | string | Y | 112 | |
+| output2 | 응답상세 | object array | Y | | '(추정손익계산서-6개 array)
매출액, 매출액증감율,
영업이익, 영업이익증감율,
순이익, 순이익증감율,' |
+| data1 | DATA1 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data2 | DATA2 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data3 | DATA3 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data4 | DATA4 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data5 | DATA5 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| output3 | 응답상세 | object array | Y | | '(투자지표-8개 array)
EBITDA(십억원), EPS(원),
EPS 증감율(0.1%), PER(배, 0.1%),
EV/EBITDA(배, 0.1), ROE(0.1%),
부채비율(0.1%), 이자보상배율(0.1%)' |
+| data1 | DATA1 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data2 | DATA2 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data3 | DATA3 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data4 | DATA4 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| data5 | DATA5 | string | Y | 15 | 결산연월(outblock4) 참조 |
+| output4 | 응답상세 | object array | Y | | array |
+| dt | 결산년월 | string | Y | 8 | DATA1 ~5 결산월 정보 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SHT_CD:005930
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "sht_cd": "A005930",
+ "item_kor_nm": "삼성전자",
+ "name1": "김한국",
+ "name2": "",
+ "estdate": "20240109",
+ "rcmd_name": "매수",
+ "capital": "8975.0",
+ "forn_item_lmtrt": "0.00"
+ },
+ "output2": [
+ {
+ "data1": "2796048.0",
+ "data2": "3022314.0",
+ "data3": "2581509.0",
+ "data4": "3048945.0",
+ "data5": "3295675.0"
+ },
+ {
+ "data1": "181.0",
+ "data2": "81.0",
+ "data3": "-146.0",
+ "data4": "181.0",
+ "data5": "81.0"
+ },
+ {
+ "data1": "516339.0",
+ "data2": "433766.0",
+ "data3": "65405.0",
+ "data4": "330172.0",
+ "data5": "555410.0"
+ },
+ {
+ "data1": "435.0",
+ "data2": "-160.0",
+ "data3": "-849.0",
+ "data4": "4048.0",
+ "data5": "682.0"
+ },
+ {
+ "data1": "392438.0",
+ "data2": "547300.0",
+ "data3": "106144.0",
+ "data4": "253332.0",
+ "data5": "422055.0"
+ },
+ {
+ "data1": "504.0",
+ "data2": "395.0",
+ "data3": "-806.0",
+ "data4": "1387.0",
+ "data5": "666.0"
+ }
+ ],
+ "output3": [
+ {
+ "data1": "858812.0",
+ "data2": "824843.0",
+ "data3": "483199.0",
+ "data4": "792602.0",
+ "data5": "1043367.0"
+ },
+ {
+ "data1": "57770.0",
+ "data2": "80570.0",
+ "data3": "15609.0",
+ "data4": "36983.0",
+ "data5": "61483.0"
+ },
+ {
+ "data1": "504.0",
+ "data2": "395.0",
+ "data3": "-806.0",
+ "data4": "1369.0",
+ "data5": "662.0"
+ },
+ {
+ "data1": "136.0",
+ "data2": "69.0",
+ "data3": "503.0",
+ "data4": "207.0",
+ "data5": "124.0"
+ },
+ {
+ "data1": "50.0",
+ "data2": "34.0",
+ "data3": "95.0",
+ "data4": "53.0",
+ "data5": "39.0"
+ },
+ {
+ "data1": "139.0",
+ "data2": "171.0",
+ "data3": "31.0",
+ "data4": "70.0",
+ "data5": "109.0"
+ },
+ {
+ "data1": "399.0",
+ "data2": "264.0",
+ "data3": "255.0",
+ "data4": "226.0",
+ "data5": "163.0"
+ },
+ {
+ "data1": "1197.0",
+ "data2": "568.0",
+ "data3": "58.0",
+ "data4": "232.0",
+ "data5": "655.0"
+ }
+ ],
+ "output4": [
+ {
+ "dt": "2021.12"
+ },
+ {
+ "dt": "2022.12"
+ },
+ {
+ "dt": "2023.12E"
+ },
+ {
+ "dt": "2024.12E"
+ },
+ {
+ "dt": "2025.12E"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/종목정보/109_v1_국내주식-082_국내주식-기타주요비율.md b/docs/broker/kis/rest/국내주식/종목정보/109_v1_국내주식-082_국내주식-기타주요비율.md
new file mode 100644
index 0000000..d90883b
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/종목정보/109_v1_국내주식-082_국내주식-기타주요비율.md
@@ -0,0 +1,304 @@
+# 국내주식 기타주요비율
+
+- 원본 시트명: 국내주식 기타주요비율
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 종목정보
+- API ID: v1_국내주식-082
+- HTTP Method: GET
+- 실전 TR_ID: FHKST66430500
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/finance/other-major-ratios
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 기타주요비율 API입니다.
+한국투자 HTS(eFriend Plus) > [0635] 재무분석종합 화면의 하단 '9. 기타주요비율' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST66430500 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
+| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
+| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stac_yymm | 결산 년월 | string | Y | 6 | |
+| payout_rate | 배당 성향 | string | Y | 92 | 비정상 출력되는 데이터로 무시 |
+| eva | EVA | string | Y | 82 | |
+| ebitda | EBITDA | string | Y | 82 | |
+| ev_ebitda | EV_EBITDA | string | Y | 82 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"fid_cond_mrkt_div_code":"J",
+"fid_input_iscd":"005930",
+"fid_div_cls_code":"1"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stac_yymm": "202309",
+ "payout_rate": "-0.02",
+ "eva": "0.00",
+ "ebitda": "23464.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202306",
+ "payout_rate": "-0.02",
+ "eva": "0.00",
+ "ebitda": "7851.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202303",
+ "payout_rate": "-0.05",
+ "eva": "0.00",
+ "ebitda": "1574.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202212",
+ "payout_rate": "0.05",
+ "eva": "-18075.00",
+ "ebitda": "209609.00",
+ "ev_ebitda": "3.48"
+ },
+ {
+ "stac_yymm": "202209",
+ "payout_rate": "0.02",
+ "eva": "0.00",
+ "ebitda": "191549.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202206",
+ "payout_rate": "0.02",
+ "eva": "0.00",
+ "ebitda": "139382.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202203",
+ "payout_rate": "0.06",
+ "eva": "0.00",
+ "ebitda": "62600.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202112",
+ "payout_rate": "0.01",
+ "eva": "40178.00",
+ "ebitda": "230671.00",
+ "ev_ebitda": "4.59"
+ },
+ {
+ "stac_yymm": "202109",
+ "payout_rate": "0.02",
+ "eva": "0.00",
+ "ebitda": "160524.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202106",
+ "payout_rate": "0.04",
+ "eva": "0.00",
+ "ebitda": "91711.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202103",
+ "payout_rate": "0.12",
+ "eva": "0.00",
+ "ebitda": "38610.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202012",
+ "payout_rate": "0.03",
+ "eva": "3789.00",
+ "ebitda": "147848.00",
+ "ev_ebitda": "6.37"
+ },
+ {
+ "stac_yymm": "202009",
+ "payout_rate": "0.04",
+ "eva": "0.00",
+ "ebitda": "112945.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202006",
+ "payout_rate": "0.06",
+ "eva": "0.00",
+ "ebitda": "75099.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "202003",
+ "payout_rate": "0.19",
+ "eva": "0.00",
+ "ebitda": "31351.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201912",
+ "payout_rate": "0.06",
+ "eva": "-24528.00",
+ "ebitda": "113396.00",
+ "ev_ebitda": "6.76"
+ },
+ {
+ "stac_yymm": "201909",
+ "payout_rate": "0.06",
+ "eva": "0.00",
+ "ebitda": "87849.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201906",
+ "payout_rate": "0.07",
+ "eva": "0.00",
+ "ebitda": "61528.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201903",
+ "payout_rate": "0.11",
+ "eva": "0.00",
+ "ebitda": "34045.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201812",
+ "payout_rate": "0.01",
+ "eva": "123025.00",
+ "ebitda": "272721.00",
+ "ev_ebitda": "1.62"
+ },
+ {
+ "stac_yymm": "201809",
+ "payout_rate": "0.01",
+ "eva": "0.00",
+ "ebitda": "210889.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201806",
+ "payout_rate": "0.02",
+ "eva": "0.00",
+ "ebitda": "129647.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201803",
+ "payout_rate": "0.04",
+ "eva": "0.00",
+ "ebitda": "58160.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201712",
+ "payout_rate": "0.01",
+ "eva": "77272.00",
+ "ebitda": "187476.00",
+ "ev_ebitda": "2.97"
+ },
+ {
+ "stac_yymm": "201709",
+ "payout_rate": "0.02",
+ "eva": "0.00",
+ "ebitda": "129433.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201706",
+ "payout_rate": "0.03",
+ "eva": "0.00",
+ "ebitda": "78973.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201703",
+ "payout_rate": "0.06",
+ "eva": "0.00",
+ "ebitda": "36327.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201612",
+ "payout_rate": "0.04",
+ "eva": "11971.00",
+ "ebitda": "77332.00",
+ "ev_ebitda": "4.23"
+ },
+ {
+ "stac_yymm": "201609",
+ "payout_rate": "0.09",
+ "eva": "0.00",
+ "ebitda": "50536.00",
+ "ev_ebitda": "0.00"
+ },
+ {
+ "stac_yymm": "201606",
+ "payout_rate": "0.16",
+ "eva": "0.00",
+ "ebitda": "32197.00",
+ "ev_ebitda": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/004_국내주식-211_기간별계좌권리현황조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/004_국내주식-211_기간별계좌권리현황조회.md
new file mode 100644
index 0000000..d1ef89a
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/004_국내주식-211_기간별계좌권리현황조회.md
@@ -0,0 +1,167 @@
+# 기간별계좌권리현황조회
+
+- 원본 시트명: 기간별계좌권리현황조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: 국내주식-211
+- HTTP Method: GET
+- 실전 TR_ID: CTRGA011R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/period-rights
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+기간별계좌권리현황조회 API입니다.
+한국투자 HTS(eFriend Plus) > [7344] 권리유형별 현황조회 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTRGA011R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 03 입력 |
+| CUST_RNCNO25 | 고객실명확인번호25 | string | Y | 25 | 공란 |
+| HMID | 홈넷ID | string | Y | 8 | 공란 |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 8자리 입력 (ex.12345678) |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 상품계좌번호 2자리 입력(ex. 01 or 22) |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 조회시작일자(YYYYMMDD) |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | 조회종료일자(YYYYMMDD) |
+| RGHT_TYPE_CD | 권리유형코드 | string | Y | 2 | 공란 |
+| PDNO | 상품번호 | string | Y | 12 | 공란 |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 공란 |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 다음조회시 입력 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 다음조회시 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| acno10 | 계좌번호10 | string | Y | 10 | |
+| rght_type_cd | 권리유형코드 | string | Y | 2 | 1 유상
2 무상
3 배당
4 매수청구
5 공개매수
6 주주총회
7 신주인수권증서
8 반대의사
9 신주인수권증권
11 합병
12 회사분할
13 주식교환
14 액면분할
15 액면병합
16 종목변경
17 감자
18 신구주합병
21 후합병
22 후회사분할
23 후주식교환
24 후액면분할
25 후액면병합
26 후종목변경
27 후감자
28 후신구주합병
31 뮤츄얼펀드
32 ETF
33 선박투자회사
34 투융자회사
35 해외자원
36 부동산신탁(Ritz)
37 상장수익증권
41 ELW만기
42 ELS분배
43 DLS분배
44 하일드펀드
45 ETN
51 전환청구
52 교환청구
53 BW청구
54 WRT청구
55 채권풋옵션청구
56 전환우선주청구
57 전환조건부청구
58 전자증권일괄입고
59 클라우드펀딩일괄입고
61 원리금상환
62 스트립채권
71 WRT소멸
72 WRT증권
73 DR전환
74 배당옵션
75 특별배당
76 ISINCODE변경
77 실권주청약
81 해외분배금(청산)
82 해외분배금(조기상환)
83 해외분배금(상장폐지)
84 DR FEE
85 SECTION 871M
86 종목전환
87 재매수
88 종목교환
89 기타이벤트
91 공모주
92 청약
93 환매
99 기타권리사유 |
+| bass_dt | 기준일자 | string | Y | 8 | |
+| rght_cblc_type_cd | 권리잔고유형코드 | string | Y | 2 | 1 입고
2 출고
3 출고입고
4 출고입금
5 출고출금
10 현금입금
11 단수주대금입금
12 교부금입금
13 유상감자대금입금
14 지연이자입금
15 이자지급
16 대주권리금출금
17 분할상환
18 만기상환
19 조기상환
20 출금
21 입고&입금
22 입고&입금&단수주대금입금
25 유상환불금입금
26 중도상환
27 분할합병세금출금 |
+| rptt_pdno | 대표상품번호 | string | Y | 12 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| cblc_qty | 잔고수량 | string | Y | 19 | |
+| last_alct_qty | 최종배정수량 | string | Y | 19 | |
+| excs_alct_qty | 초과배정수량 | string | Y | 19 | |
+| tot_alct_qty | 총배정수량 | string | Y | 19 | |
+| last_ftsk_qty | 최종단수주수량 | string | Y | 191 | |
+| last_alct_amt | 최종배정금액 | string | Y | 19 | |
+| last_ftsk_chgs | 최종단수주대금 | string | Y | 19 | |
+| rdpt_prca | 상환원금 | string | Y | 19 | |
+| dlay_int_amt | 지연이자금액 | string | Y | 19 | |
+| lstg_dt | 상장일자 | string | Y | 8 | |
+| sbsc_end_dt | 청약종료일자 | string | Y | 8 | |
+| cash_dfrm_dt | 현금지급일자 | string | Y | 8 | |
+| rqst_qty | 신청수량 | string | Y | 19 | |
+| rqst_amt | 신청금액 | string | Y | 19 | |
+| rqst_dt | 신청일자 | string | Y | 8 | |
+| rfnd_dt | 환불일자 | string | Y | 8 | |
+| rfnd_amt | 환불금액 | string | Y | 19 | |
+| lstg_stqt | 상장주수 | string | Y | 19 | |
+| tax_amt | 세금금액 | string | Y | 19 | |
+| sbsc_unpr | 청약단가 | string | Y | 224 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+INQR_DVSN:03
+CUST_RNCNO25:
+HMID:
+CANO:12345678
+ACNT_PRDT_CD:01
+INQR_STRT_DT:20240508
+INQR_END_DT:20241106
+RGHT_TYPE_CD:
+PDNO:
+PRDT_TYPE_CD:
+CTX_AREA_NK100:
+CTX_AREA_FK100:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk100": " ",
+ "ctx_area_fk100": "03!^!^!^12345678!^01!^20240508!^20241106!^!^!^ ",
+ "output": [
+ {
+ "acno10": "1234567801",
+ "rght_type_cd": "01",
+ "bass_dt": "20240919",
+ "rght_cblc_type_cd": "01",
+ "rptt_pdno": "00000A357880",
+ "pdno": "00000A357880",
+ "prdt_type_cd": "300",
+ "shtn_pdno": "357880",
+ "prdt_name": "비트나인",
+ "cblc_qty": "1000",
+ "last_alct_qty": "1050",
+ "excs_alct_qty": "0",
+ "tot_alct_qty": "1050",
+ "last_ftsk_qty": "0.0000000000",
+ "last_alct_amt": "0",
+ "last_ftsk_chgs": "0",
+ "rdpt_prca": "0",
+ "dlay_int_amt": "0",
+ "lstg_dt": "",
+ "sbsc_end_dt": "20241011",
+ "cash_dfrm_dt": "",
+ "rqst_qty": "1000",
+ "rqst_amt": "1865000",
+ "rqst_dt": "20241011",
+ "rfnd_dt": "",
+ "rfnd_amt": "0",
+ "lstg_stqt": "0",
+ "tax_amt": "0",
+ "sbsc_unpr": "1865.0000"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/005_v1_국내주식-048_투자계좌자산현황조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/005_v1_국내주식-048_투자계좌자산현황조회.md
new file mode 100644
index 0000000..9a4c5ef
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/005_v1_국내주식-048_투자계좌자산현황조회.md
@@ -0,0 +1,303 @@
+# 투자계좌자산현황조회
+
+- 원본 시트명: 투자계좌자산현황조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-048
+- HTTP Method: GET
+- 실전 TR_ID: CTRP6548R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-account-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+투자계좌자산현황조회 API입니다.
+
+output1은 한국투자 HTS(eFriend Plus) > [0891] 계좌 자산비중(결제기준) 화면 아래 테이블의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTRP6548R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| INQR_DVSN_1 | 조회구분1 | string | Y | 1 | 공백입력 |
+| BSPR_BF_DT_APLY_YN | 기준가이전일자적용여부 | string | Y | 1 | 공백입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output1 | 응답상세 | object array | Y | | Array [아래 순서대로 출력 : 20항목]
1: 주식
2: 펀드/MMW
3: IMA
4: 채권
5: ELS/DLS
6: WRAP
7: 신탁
8: RP/발행어음
9: 해외주식
10: 해외채권
11: 금현물
12: CD/CP
13: 전자단기사채
14: 타사상품
15: 외화전자단기사채
16: 외화 ELS/DLS
17: 외화
18: 예수금
19: 청약자예수금
20: 합계
[21번 계좌일 경우 : 17항목]
1: 수익증권
2: IMA
3: 채권
4: ELS/DLS
5: WRAP
6: 신탁
7: RP
8: 외화rp
9: 해외채권
10: CD/CP
11: 전자단기사채
12: 외화전자단기사채
13: 외화ELS/DLS
14: 외화평가금액
15: 예수금+cma
16: 청약자예수금
17: 합계 |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| crdt_lnd_amt | 신용대출금액 | string | Y | 19 | |
+| real_nass_amt | 실제순자산금액 | string | Y | 19 | |
+| whol_weit_rt | 전체비중율 | string | Y | 228 | |
+| Output2 | 응답상세2 | object | Y | | |
+| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | 유가매입금액 |
+| nass_tot_amt | 순자산총금액 | string | Y | 19 | |
+| loan_amt_smtl | 대출금액합계 | string | Y | 19 | |
+| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | 평가손익금액 |
+| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | 유가평가금액 |
+| tot_asst_amt | 총자산금액 | string | Y | 19 | 총 자산금액 |
+| tot_lnda_tot_ulst_lnda | 총대출금액총융자대출금액 | string | Y | 19 | |
+| cma_auto_loan_amt | CMA자동대출금액 | string | Y | 19 | |
+| tot_mgln_amt | 총담보대출금액 | string | Y | 19 | |
+| stln_evlu_amt | 대주평가금액 | string | Y | 19 | |
+| crdt_fncg_amt | 신용융자금액 | string | Y | 19 | |
+| ocl_apl_loan_amt | OCL_APL대출금액 | string | Y | 19 | |
+| pldg_stup_amt | 질권설정금액 | string | Y | 19 | |
+| frcr_evlu_tota | 외화평가총액 | string | Y | 19 | |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| dncl_amt | 예수금액 | string | Y | 19 | |
+| tot_sbst_amt | 총대용금액 | string | Y | 19 | |
+| thdt_rcvb_amt | 당일미수금액 | string | Y | 20 | |
+| ovrs_stck_evlu_amt1 | 해외주식평가금액1 | string | Y | 236 | |
+| ovrs_bond_evlu_amt | 해외채권평가금액 | string | Y | 236 | |
+| mmf_cma_mgge_loan_amt | MMFCMA담보대출금액 | string | Y | 19 | |
+| sbsc_dncl_amt | 청약예수금액 | string | Y | 19 | |
+| pbst_sbsc_fnds_loan_use_amt | 공모주청약자금대출사용금액 | string | Y | 20 | |
+| etpr_crdt_grnt_loan_amt | 기업신용공여대출금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"01",
+ "INQR_DVSN_1":"",
+ "BSPR_BF_DT_APLY_YN":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "pchs_amt": "129105",
+ "evlu_amt": "406000",
+ "evlu_pfls_amt": "276895",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "406000",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "161026228",
+ "evlu_amt": "185144504",
+ "evlu_pfls_amt": "24118276",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "185144504",
+ "whol_weit_rt": "0.01000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "1651434483743",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "1651434483743",
+ "whol_weit_rt": "99.97000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "249855300",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "249855300",
+ "whol_weit_rt": "0.01000000"
+ },
+ {
+ "pchs_amt": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "0",
+ "whol_weit_rt": "0.00000000"
+ },
+ {
+ "pchs_amt": "161155333",
+ "evlu_amt": "1651869889547",
+ "evlu_pfls_amt": "24395171",
+ "crdt_lnd_amt": "0",
+ "real_nass_amt": "1651869889547",
+ "whol_weit_rt": "100.00000000"
+ }
+ ],
+ "output2": {
+ "pchs_amt_smtl": "161155333",
+ "nass_tot_amt": "185550504",
+ "loan_amt_smtl": "0",
+ "evlu_pfls_amt_smtl": "24395171",
+ "evlu_amt_smtl": "185550504",
+ "tot_asst_amt": "1651869889547",
+ "tot_lnda_tot_ulst_lnda": "0",
+ "cma_auto_loan_amt": "0",
+ "tot_mgln_amt": "0",
+ "stln_evlu_amt": "0",
+ "crdt_fncg_amt": "0",
+ "ocl_apl_loan_amt": "0",
+ "pldg_stup_amt": "0",
+ "frcr_evlu_tota": "1651434483743",
+ "tot_dncl_amt": "249855300",
+ "cma_evlu_amt": "0",
+ "dncl_amt": "249855300",
+ "tot_sbst_amt": "0",
+ "thdt_rcvb_amt": "0",
+ "ovrs_stck_evlu_amt1": "185144504.000000",
+ "ovrs_bond_evlu_amt": "0.000000",
+ "mmf_cma_mgge_loan_amt": "0",
+ "sbsc_dncl_amt": "0",
+ "pbst_sbsc_fnds_loan_use_amt": "0",
+ "etpr_crdt_grnt_loan_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/006_v1_국내주식-035_퇴직연금-예수금조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/006_v1_국내주식-035_퇴직연금-예수금조회.md
new file mode 100644
index 0000000..749f442
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/006_v1_국내주식-035_퇴직연금-예수금조회.md
@@ -0,0 +1,97 @@
+# 퇴직연금 예수금조회
+
+- 원본 시트명: 퇴직연금 예수금조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-035
+- HTTP Method: GET
+- 실전 TR_ID: TTTC0506R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/pension/inquire-deposit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
+KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0506R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 29 |
+| ACCA_DVSN_CD | 적립금구분코드 | string | Y | 2 | 00 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| dnca_tota | 예수금총액 | string | Y | 19 | |
+| nxdy_excc_amt | 익일정산액 | string | Y | 19 | |
+| nxdy_sttl_amt | 익일결제금액 | string | Y | 19 | |
+| nx2_day_sttl_amt | 2익일결제금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"63512345",
+ "ACNT_PRDT_CD":"29",
+ "ACCA_DVSN_CD":"00"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "dnca_tota": "57622382",
+ "nxdy_excc_amt": "11054042",
+ "nxdy_sttl_amt": "0",
+ "nx2_day_sttl_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/007_v1_국내주식-018,019_주식예약주문정정취소.md b/docs/broker/kis/rest/국내주식/주문/계좌/007_v1_국내주식-018,019_주식예약주문정정취소.md
new file mode 100644
index 0000000..99995f9
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/007_v1_국내주식-018,019_주식예약주문정정취소.md
@@ -0,0 +1,124 @@
+# 주식예약주문정정취소
+
+- 원본 시트명: 주식예약주문정정취소
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-018,019
+- HTTP Method: POST
+- 실전 TR_ID: (예약취소) CTSC0009U (예약정정) CTSC0013U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/order-resv-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예약주문 정정/취소 API 입니다.
+* 정정주문은 취소주문에 비해 필수 입력값이 추가 됩니다.
+ 하단의 입력값을 참조하시기 바랍니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
CTSC0009U : 국내주식예약취소주문
CTSC0013U : 국내주식예약정정주문
* 모의투자 사용 불가 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | [정정/취소] 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | [정정/취소] 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 종목코드(6자리) | string | Y | 12 | [정정] |
+| ORD_QTY | 주문수량 | string | Y | 10 | [정정] 주문주식수 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | [정정] 1주당 가격
* 장전 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | [정정]
01 : 매도
02 : 매수 |
+| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | [정정]
00 : 지정가
01 : 시장가
02 : 조건부지정가
05 : 장전 시간외 |
+| ORD_OBJT_CBLC_DVSN_CD | 주문대상잔고구분코드 | string | Y | 2 | [정정]
10 : 현금
12 : 주식담보대출
14 : 대여상환
21 : 자기융자신규
22 : 유통대주신규
23 : 유통융자신규
24 : 자기대주신규
25 : 자기융자상환
26 : 유통대주상환
27 : 유통융자상환
28 : 자기대주상환 |
+| LOAN_DT | 대출일자 | string | N | 8 | [정정] |
+| RSVN_ORD_END_DT | 예약주문종료일자 | string | N | 8 | [정정] |
+| CTAL_TLNO | 연락전화번호 | string | N | 20 | [정정] |
+| RSVN_ORD_SEQ | 예약주문순번 | string | Y | 10 | [정정/취소] |
+| RSVN_ORD_ORGNO | 예약주문조직번호 | string | N | 5 | [정정/취소] |
+| RSVN_ORD_ORD_DT | 예약주문주문일자 | string | N | 8 | [정정/취소] |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | array | Y | | |
+| nrml_prcs_yn | 정상처리여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "_comment": "주식예약주문취소",
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "RSVN_ORD_ORD_DT": "20220427",
+ "RSVN_ORD_SEQ": "39447",
+ "RSVN_ORD_ORGNO": "00"
+}
+
+{
+ "_comment": "주식예약주문정정",
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "009150",
+ "ORD_QTY": "10",
+ "ORD_UNPR": "140000",
+ "SLL_BUY_DVSN_CD":"01",
+ "ORD_DVSN_CD":"00",
+ "ORD_OBJT_CBLC_DVSN_CD":"10",
+ "LOAN_DT":"",
+ "RSVN_ORD_END_DT":"",
+ "CTAC_TLNO": "",
+ "RSVN_ORD_SEQ":"39453",
+ "RSVN_ORD_ORGNO":"",
+ "RSVN_ORD_ORD_DT":"20220427"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "KIOK0430",
+ "msg1": "정상적으로 처리되었습니다",
+ "output": {
+ "NRML_PRCS_YN": "Y"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/008_v1_국내주식-042_신용매수가능조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/008_v1_국내주식-042_신용매수가능조회.md
new file mode 100644
index 0000000..2503193
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/008_v1_국내주식-042_신용매수가능조회.md
@@ -0,0 +1,123 @@
+# 신용매수가능조회
+
+- 원본 시트명: 신용매수가능조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-042
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8909R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-credit-psamount
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+신용매수가능조회 API입니다.
+신용매수주문 시 주문가능수량과 금액을 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8909R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드(6자리) |
+| ORD_UNPR | 주문단가 | string | Y | 19 | 1주당 가격
* 장전 시간외, 장후 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고 |
+| ORD_DVSN | 주문구분 | string | Y | 2 | 00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가 등 |
+| CRDT_TYPE | 신용유형 | string | Y | 2 | 21 : 자기융자신규
23 : 유통융자신규
26 : 유통대주상환
28 : 자기대주상환
25 : 자기융자상환
27 : 유통융자상환
22 : 유통대주신규
24 : 자기대주신규 |
+| CMA_EVLU_AMT_ICLD_YN | CMA평가금액포함여부 | string | Y | 1 | Y/N |
+| OVRS_ICLD_YN | 해외포함여부 | string | Y | 1 | Y/N |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메시지 |
+| output | 응답상세 | object | Y | | |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
+| ruse_psbl_amt | 재사용가능금액 | string | Y | 19 | |
+| fund_rpch_chgs | 펀드환매대금 | string | Y | 19 | |
+| psbl_qty_calc_unpr | 가능수량계산단가 | string | Y | 19 | |
+| nrcvb_buy_amt | 미수없는매수금액 | string | Y | 19 | |
+| nrcvb_buy_qty | 미수없는매수수량 | string | Y | 10 | |
+| max_buy_amt | 최대매수금액 | string | Y | 19 | |
+| max_buy_qty | 최대매수수량 | string | Y | 10 | |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| ovrs_re_use_amt_wcrc | 해외재사용금액원화 | string | Y | 19 | |
+| ord_psbl_frcr_amt_wcrc | 주문가능외화금액원화 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "12345678",
+"ACNT_PRDT_CD": "01",
+"PDNO": "005930",
+"ORD_UNPR" : "55000",
+"ORD_DVSN": "01",
+"CRDT_TYPE": "21",
+"CMA_EVLU_AMT_ICLD_YN": "N",
+"OVRS_ICLD_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "ord_psbl_cash": "99965177664",
+ "ord_psbl_sbst": "156772560",
+ "ruse_psbl_amt": "0",
+ "fund_rpch_chgs": "0",
+ "psbl_qty_calc_unpr": "69200",
+ "nrcvb_buy_amt": "0",
+ "nrcvb_buy_qty": "0",
+ "max_buy_amt": "0",
+ "max_buy_qty": "0",
+ "cma_evlu_amt": "0",
+ "ovrs_re_use_amt_wcrc": "0",
+ "ord_psbl_frcr_amt_wcrc": "157998704172856"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/009_국내주식-191_주식통합증거금-현황.md b/docs/broker/kis/rest/국내주식/주문/계좌/009_국내주식-191_주식통합증거금-현황.md
new file mode 100644
index 0000000..d7e12d2
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/009_국내주식-191_주식통합증거금-현황.md
@@ -0,0 +1,306 @@
+# 주식통합증거금 현황
+
+- 원본 시트명: 주식통합증거금 현황
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: 국내주식-191
+- HTTP Method: GET
+- 실전 TR_ID: TTTC0869R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/intgr-margin
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식통합증거금 현황 API입니다.
+한국투자 HTS(eFriend Plus) > [0867] 통합증거금조회 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 해당 화면은 일반계좌와 통합증거금 신청계좌에 대해서 국내 및 해외 주문가능금액을 간단하게 조회하는 화면입니다.
+※ 해외 국가별 상세한 증거금현황을 원하시면 [해외주식] 주문/계좌 > 해외증거금 통화별조회 API를 이용하여 주시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0869R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CMA_EVLU_AMT_ICLD_YN | CMA평가금액포함여부 | string | Y | 1 | N 입력 |
+| WCRC_FRCR_DVSN_CD | 원화외화구분코드 | string | Y | 2 | 01(외화기준),02(원화기준) |
+| FWEX_CTRT_FRCR_DVSN_CD | 선도환계약외화구분코드 | string | Y | 2 | 01(외화기준),02(원화기준) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| acmga_rt | 계좌증거금율 | string | Y | 114 | |
+| acmga_pct100_aptm_rson | 계좌증거금100퍼센트지정사유 | string | Y | 100 | |
+| stck_cash_objt_amt | 주식현금대상금액 | string | Y | 184 | |
+| stck_sbst_objt_amt | 주식대용대상금액 | string | Y | 184 | |
+| stck_evlu_objt_amt | 주식평가대상금액 | string | Y | 184 | |
+| stck_ruse_psbl_objt_amt | 주식재사용가능대상금액 | string | Y | 184 | |
+| stck_fund_rpch_chgs_objt_amt | 주식펀드환매대금대상금액 | string | Y | 184 | |
+| stck_fncg_rdpt_objt_atm | 주식융자상환금대상금액 | string | Y | 184 | |
+| bond_ruse_psbl_objt_amt | 채권재사용가능대상금액 | string | Y | 184 | |
+| stck_cash_use_amt | 주식현금사용금액 | string | Y | 184 | |
+| stck_sbst_use_amt | 주식대용사용금액 | string | Y | 184 | |
+| stck_evlu_use_amt | 주식평가사용금액 | string | Y | 184 | |
+| stck_ruse_psbl_amt_use_amt | 주식재사용가능금사용금액 | string | Y | 184 | |
+| stck_fund_rpch_chgs_use_amt | 주식펀드환매대금사용금액 | string | Y | 184 | |
+| stck_fncg_rdpt_amt_use_amt | 주식융자상환금사용금액 | string | Y | 184 | |
+| bond_ruse_psbl_amt_use_amt | 채권재사용가능금사용금액 | string | Y | 184 | |
+| stck_cash_ord_psbl_amt | 주식현금주문가능금액 | string | Y | 184 | |
+| stck_sbst_ord_psbl_amt | 주식대용주문가능금액 | string | Y | 184 | |
+| stck_evlu_ord_psbl_amt | 주식평가주문가능금액 | string | Y | 184 | |
+| stck_ruse_psbl_ord_psbl_amt | 주식재사용가능주문가능금액 | string | Y | 184 | |
+| stck_fund_rpch_ord_psbl_amt | 주식펀드환매주문가능금액 | string | Y | 184 | |
+| bond_ruse_psbl_ord_psbl_amt | 채권재사용가능주문가능금액 | string | Y | 184 | |
+| rcvb_amt | 미수금액 | string | Y | 19 | |
+| stck_loan_grta_ruse_psbl_amt | 주식대출보증금재사용가능금액 | string | Y | 184 | |
+| stck_cash20_max_ord_psbl_amt | 주식현금20최대주문가능금액 | string | Y | 184 | |
+| stck_cash30_max_ord_psbl_amt | 주식현금30최대주문가능금액 | string | Y | 184 | |
+| stck_cash40_max_ord_psbl_amt | 주식현금40최대주문가능금액 | string | Y | 184 | |
+| stck_cash50_max_ord_psbl_amt | 주식현금50최대주문가능금액 | string | Y | 184 | |
+| stck_cash60_max_ord_psbl_amt | 주식현금60최대주문가능금액 | string | Y | 184 | |
+| stck_cash100_max_ord_psbl_amt | 주식현금100최대주문가능금액 | string | Y | 184 | |
+| stck_rsip100_max_ord_psbl_amt | 주식재사용불가100최대주문가능 | string | Y | 184 | |
+| bond_max_ord_psbl_amt | 채권최대주문가능금액 | string | Y | 184 | |
+| stck_fncg45_max_ord_psbl_amt | 주식융자45최대주문가능금액 | string | Y | 182 | |
+| stck_fncg50_max_ord_psbl_amt | 주식융자50최대주문가능금액 | string | Y | 184 | |
+| stck_fncg60_max_ord_psbl_amt | 주식융자60최대주문가능금액 | string | Y | 184 | |
+| stck_fncg70_max_ord_psbl_amt | 주식융자70최대주문가능금액 | string | Y | 182 | |
+| stck_stln_max_ord_psbl_amt | 주식대주최대주문가능금액 | string | Y | 184 | |
+| lmt_amt | 한도금액 | string | Y | 19 | |
+| ovrs_stck_itgr_mgna_dvsn_name | 해외주식통합증거금구분명 | string | Y | 40 | |
+| usd_objt_amt | 미화대상금액 | string | Y | 182 | |
+| usd_use_amt | 미화사용금액 | string | Y | 182 | |
+| usd_ord_psbl_amt | 미화주문가능금액 | string | Y | 182 | |
+| hkd_objt_amt | 홍콩달러대상금액 | string | Y | 182 | |
+| hkd_use_amt | 홍콩달러사용금액 | string | Y | 182 | |
+| hkd_ord_psbl_amt | 홍콩달러주문가능금액 | string | Y | 182 | |
+| jpy_objt_amt | 엔화대상금액 | string | Y | 182 | |
+| jpy_use_amt | 엔화사용금액 | string | Y | 182 | |
+| jpy_ord_psbl_amt | 엔화주문가능금액 | string | Y | 182 | |
+| cny_objt_amt | 위안화대상금액 | string | Y | 182 | |
+| cny_use_amt | 위안화사용금액 | string | Y | 182 | |
+| cny_ord_psbl_amt | 위안화주문가능금액 | string | Y | 182 | |
+| usd_ruse_objt_amt | 미화재사용대상금액 | string | Y | 182 | |
+| usd_ruse_amt | 미화재사용금액 | string | Y | 182 | |
+| usd_ruse_ord_psbl_amt | 미화재사용주문가능금액 | string | Y | 182 | |
+| hkd_ruse_objt_amt | 홍콩달러재사용대상금액 | string | Y | 182 | |
+| hkd_ruse_amt | 홍콩달러재사용금액 | string | Y | 182 | |
+| hkd_ruse_ord_psbl_amt | 홍콩달러재사용주문가능금액 | string | Y | 172 | |
+| jpy_ruse_objt_amt | 엔화재사용대상금액 | string | Y | 182 | |
+| jpy_ruse_amt | 엔화재사용금액 | string | Y | 182 | |
+| jpy_ruse_ord_psbl_amt | 엔화재사용주문가능금액 | string | Y | 182 | |
+| cny_ruse_objt_amt | 위안화재사용대상금액 | string | Y | 182 | |
+| cny_ruse_amt | 위안화재사용금액 | string | Y | 182 | |
+| cny_ruse_ord_psbl_amt | 위안화재사용주문가능금액 | string | Y | 182 | |
+| usd_gnrl_ord_psbl_amt | 미화일반주문가능금액 | string | Y | 182 | |
+| usd_itgr_ord_psbl_amt | 미화통합주문가능금액 | string | Y | 182 | |
+| hkd_gnrl_ord_psbl_amt | 홍콩달러일반주문가능금액 | string | Y | 182 | |
+| hkd_itgr_ord_psbl_amt | 홍콩달러통합주문가능금액 | string | Y | 182 | |
+| jpy_gnrl_ord_psbl_amt | 엔화일반주문가능금액 | string | Y | 182 | |
+| jpy_itgr_ord_psbl_amt | 엔화통합주문가능금액 | string | Y | 182 | |
+| cny_gnrl_ord_psbl_amt | 위안화일반주문가능금액 | string | Y | 182 | |
+| cny_itgr_ord_psbl_amt | 위안화통합주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash20_ord_psbl_amt | 주식통합현금20주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash30_ord_psbl_amt | 주식통합현금30주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash40_ord_psbl_amt | 주식통합현금40주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash50_ord_psbl_amt | 주식통합현금50주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash60_ord_psbl_amt | 주식통합현금60주문가능금액 | string | Y | 182 | |
+| stck_itgr_cash100_ord_psbl_amt | 주식통합현금100주문가능금액 | string | Y | 182 | |
+| stck_itgr_100_ord_psbl_amt | 주식통합100주문가능금액 | string | Y | 182 | |
+| stck_itgr_fncg45_ord_psbl_amt | 주식통합융자45주문가능금액 | string | Y | 182 | |
+| stck_itgr_fncg50_ord_psbl_amt | 주식통합융자50주문가능금액 | string | Y | 182 | |
+| stck_itgr_fncg60_ord_psbl_amt | 주식통합융자60주문가능금액 | string | Y | 182 | |
+| stck_itgr_fncg70_ord_psbl_amt | 주식통합융자70주문가능금액 | string | Y | 182 | |
+| stck_itgr_stln_ord_psbl_amt | 주식통합대주주문가능금액 | string | Y | 182 | |
+| bond_itgr_ord_psbl_amt | 채권통합주문가능금액 | string | Y | 182 | |
+| stck_cash_ovrs_use_amt | 주식현금해외사용금액 | string | Y | 182 | |
+| stck_sbst_ovrs_use_amt | 주식대용해외사용금액 | string | Y | 182 | |
+| stck_evlu_ovrs_use_amt | 주식평가해외사용금액 | string | Y | 182 | |
+| stck_re_use_amt_ovrs_use_amt | 주식재사용금액해외사용금액 | string | Y | 182 | |
+| stck_fund_rpch_ovrs_use_amt | 주식펀드환매해외사용금액 | string | Y | 182 | |
+| stck_fncg_rdpt_ovrs_use_amt | 주식융자상환해외사용금액 | string | Y | 182 | |
+| bond_re_use_ovrs_use_amt | 채권재사용해외사용금액 | string | Y | 182 | |
+| usd_oth_mket_use_amt | 미화타시장사용금액 | string | Y | 182 | |
+| jpy_oth_mket_use_amt | 엔화타시장사용금액 | string | Y | 182 | |
+| cny_oth_mket_use_amt | 위안화타시장사용금액 | string | Y | 182 | |
+| hkd_oth_mket_use_amt | 홍콩달러타시장사용금액 | string | Y | 182 | |
+| usd_re_use_oth_mket_use_amt | 미화재사용타시장사용금액 | string | Y | 182 | |
+| jpy_re_use_oth_mket_use_amt | 엔화재사용타시장사용금액 | string | Y | 182 | |
+| cny_re_use_oth_mket_use_amt | 위안화재사용타시장사용금액 | string | Y | 182 | |
+| hkd_re_use_oth_mket_use_amt | 홍콩달러재사용타시장사용금액 | string | Y | 182 | |
+| hgkg_cny_re_use_amt | 홍콩위안화재사용금액 | string | Y | 182 | |
+| usd_frst_bltn_exrt | 미국달러최초고시환율 | string | Y | 23 | |
+| hkd_frst_bltn_exrt | 홍콩달러최초고시환율 | string | Y | 23 | |
+| jpy_frst_bltn_exrt | 일본엔화최초고시환율 | string | Y | 23 | |
+| cny_frst_bltn_exrt | 중국위안화최초고시환율 | string | Y | 23 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+CMA_EVLU_AMT_ICLD_YN:N
+WCRC_FRCR_DVSN_CD:01
+FWEX_CTRT_FRCR_DVSN_CD:01
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "acmga_rt": "100.0000",
+ "acmga_pct100_aptm_rson": "고객100%신청",
+ "stck_cash_objt_amt": "249855306.0000",
+ "stck_sbst_objt_amt": "137816.0000",
+ "stck_evlu_objt_amt": "176966.0000",
+ "stck_ruse_psbl_objt_amt": "261213.0000",
+ "stck_fund_rpch_chgs_objt_amt": "0.0000",
+ "stck_fncg_rdpt_objt_atm": "0.0000",
+ "bond_ruse_psbl_objt_amt": "1024.0000",
+ "stck_cash_use_amt": "240482730.0000",
+ "stck_sbst_use_amt": "20295.0000",
+ "stck_evlu_use_amt": "20295.0000",
+ "stck_ruse_psbl_amt_use_amt": "261213.0000",
+ "stck_fund_rpch_chgs_use_amt": "0.0000",
+ "stck_fncg_rdpt_amt_use_amt": "0.0000",
+ "bond_ruse_psbl_amt_use_amt": "1024.0000",
+ "stck_cash_ord_psbl_amt": "9372576.0000",
+ "stck_sbst_ord_psbl_amt": "117521.0000",
+ "stck_evlu_ord_psbl_amt": "156671.0000",
+ "stck_ruse_psbl_ord_psbl_amt": "0.0000",
+ "stck_fund_rpch_ord_psbl_amt": "0.0000",
+ "bond_ruse_psbl_ord_psbl_amt": "0.0000",
+ "rcvb_amt": "0",
+ "stck_loan_grta_ruse_psbl_amt": "0.0000",
+ "stck_cash20_max_ord_psbl_amt": "8128560.1990",
+ "stck_cash30_max_ord_psbl_amt": "8128560.1990",
+ "stck_cash40_max_ord_psbl_amt": "8128560.1990",
+ "stck_cash50_max_ord_psbl_amt": "8128560.1990",
+ "stck_cash60_max_ord_psbl_amt": "8128560.1990",
+ "stck_cash100_max_ord_psbl_amt": "8128560.1990",
+ "stck_rsip100_max_ord_psbl_amt": "8128560.1990",
+ "bond_max_ord_psbl_amt": "9316675.9443",
+ "stck_fncg45_max_ord_psbl_amt": "20942905.49",
+ "stck_fncg50_max_ord_psbl_amt": "18869350.4950",
+ "stck_fncg60_max_ord_psbl_amt": "15750449.5868",
+ "stck_fncg70_max_ord_psbl_amt": "13516343.26",
+ "stck_stln_max_ord_psbl_amt": "9307424.0318",
+ "lmt_amt": "0",
+ "ovrs_stck_itgr_mgna_dvsn_name": "",
+ "usd_objt_amt": "0.00",
+ "usd_use_amt": "0.00",
+ "usd_ord_psbl_amt": "0.00",
+ "hkd_objt_amt": "0.00",
+ "hkd_use_amt": "0.00",
+ "hkd_ord_psbl_amt": "0.00",
+ "jpy_objt_amt": "0.00",
+ "jpy_use_amt": "0.00",
+ "jpy_ord_psbl_amt": "0.00",
+ "cny_objt_amt": "0.00",
+ "cny_use_amt": "0.00",
+ "cny_ord_psbl_amt": "0.00",
+ "usd_ruse_objt_amt": "0.00",
+ "usd_ruse_amt": "0.00",
+ "usd_ruse_ord_psbl_amt": "0.00",
+ "hkd_ruse_objt_amt": "0.00",
+ "hkd_ruse_amt": "0.00",
+ "hkd_ruse_ord_psbl_amt": "0.00",
+ "jpy_ruse_objt_amt": "0.00",
+ "jpy_ruse_amt": "0.00",
+ "jpy_ruse_ord_psbl_amt": "0.00",
+ "cny_ruse_objt_amt": "0.00",
+ "cny_ruse_amt": "0.00",
+ "cny_ruse_ord_psbl_amt": "0.00",
+ "usd_gnrl_ord_psbl_amt": "0.00",
+ "usd_itgr_ord_psbl_amt": "0.00",
+ "hkd_gnrl_ord_psbl_amt": "0.00",
+ "hkd_itgr_ord_psbl_amt": "0.00",
+ "jpy_gnrl_ord_psbl_amt": "0.00",
+ "jpy_itgr_ord_psbl_amt": "0.00",
+ "cny_gnrl_ord_psbl_amt": "0.00",
+ "cny_itgr_ord_psbl_amt": "0.00",
+ "stck_itgr_cash20_ord_psbl_amt": "0.00",
+ "stck_itgr_cash30_ord_psbl_amt": "0.00",
+ "stck_itgr_cash40_ord_psbl_amt": "0.00",
+ "stck_itgr_cash50_ord_psbl_amt": "0.00",
+ "stck_itgr_cash60_ord_psbl_amt": "0.00",
+ "stck_itgr_cash100_ord_psbl_amt": "0.00",
+ "stck_itgr_100_ord_psbl_amt": "0.00",
+ "stck_itgr_fncg45_ord_psbl_amt": "0.00",
+ "stck_itgr_fncg50_ord_psbl_amt": "0.00",
+ "stck_itgr_fncg60_ord_psbl_amt": "0.00",
+ "stck_itgr_fncg70_ord_psbl_amt": "0.00",
+ "stck_itgr_stln_ord_psbl_amt": "0.00",
+ "bond_itgr_ord_psbl_amt": "0.00",
+ "stck_cash_ovrs_use_amt": "0.00",
+ "stck_sbst_ovrs_use_amt": "0.00",
+ "stck_evlu_ovrs_use_amt": "0.00",
+ "stck_re_use_amt_ovrs_use_amt": "0.00",
+ "stck_fund_rpch_ovrs_use_amt": "0.00",
+ "stck_fncg_rdpt_ovrs_use_amt": "0.00",
+ "bond_re_use_ovrs_use_amt": "0.00",
+ "usd_oth_mket_use_amt": "0.00",
+ "jpy_oth_mket_use_amt": "0.00",
+ "cny_oth_mket_use_amt": "0.00",
+ "hkd_oth_mket_use_amt": "0.00",
+ "usd_re_use_oth_mket_use_amt": "0.00",
+ "jpy_re_use_oth_mket_use_amt": "0.00",
+ "cny_re_use_oth_mket_use_amt": "0.00",
+ "hkd_re_use_oth_mket_use_amt": "0.00",
+ "hgkg_cny_re_use_amt": "0.00",
+ "hgkg_cny_re_use_objt_amt": "0.00",
+ "hgkg_cny_re_use_ord_psbl_amt": "0.00",
+ "hgkg_cny_re_use_oth_use_amt": "0.00"
+ "hgkg_cny_re_use_oth_use_amt": "0.00",
+ "usd_frst_bltn_exrt": "1467.00000000",
+ "hkd_frst_bltn_exrt": "188.61000000",
+ "jpy_frst_bltn_exrt": "10.06000000",
+ "cny_frst_bltn_exrt": "200.70000000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/010_v1_국내주식-033_퇴직연금-미체결내역.md b/docs/broker/kis/rest/국내주식/주문/계좌/010_v1_국내주식-033_퇴직연금-미체결내역.md
new file mode 100644
index 0000000..7c7be9d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/010_v1_국내주식-033_퇴직연금-미체결내역.md
@@ -0,0 +1,120 @@
+# 퇴직연금 미체결내역
+
+- 원본 시트명: 퇴직연금 미체결내역
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-033
+- HTTP Method: GET
+- 실전 TR_ID: TTTC2201R(기존 KRX만 가능), TTTC2210R (KRX,NXT/SOR)
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/pension/inquire-daily-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
+KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC2201R(기존 KRX만 가능), TTTC2210R (KRX,NXT/SOR) |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 29 |
+| USER_DVSN_CD | 사용자구분코드 | string | Y | 2 | %% |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 00 : 전체 / 01 : 매도 / 02 : 매수 |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | %% : 전체 / 01 : 체결 / 02 : 미체결 |
+| INQR_DVSN_3 | 조회구분3 | string | Y | 2 | 00 : 전체 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object array | Y | | Array |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| odno | 주문번호 | string | Y | 10 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| ord_unpr | 주문단가 | string | Y | 19 | |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| nccs_qty | 미체결수량 | string | Y | 10 | |
+| ord_dvsn_cd | 주문구분코드 | string | Y | 2 | |
+| ord_dvsn_name | 주문구분명 | string | Y | 60 | |
+| orgn_odno | 원주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+| objt_cust_dvsn_name | 대상고객구분명 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 184 | |
+| stpm_cndt_pric | 스톱지정가조건가격 | string | Y | 9 | 신규 API용 필드 |
+| stpm_efct_occr_dtmd | 스톱지정가효력발생상세시각 | string | Y | 9 | 신규 API용 필드 |
+| stpm_efct_occr_yn | 스톱지정가효력발생여부 | string | Y | 1 | 신규 API용 필드 |
+| excg_id_dvsn_cd | 거래소ID구분코드 | string | Y | 3 | 신규 API용 필드 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"63512345",
+ "ACNT_PRDT_CD":"29",
+ "USER_DVSN_CD":"%%",
+ "SLL_BUY_DVSN_CD":"00",
+ "CCLD_NCCS_DVSN":"%%",
+ "INQR_DVSN_3":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "63512345^29^%%^00^%%^00^ ",
+ "ctx_area_nk100": "^^ ",
+ "output": [],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0490",
+ "msg1": "조회가 계속됩니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/011_v1_국내주식-060_기간별매매손익현황조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/011_v1_국내주식-060_기간별매매손익현황조회.md
new file mode 100644
index 0000000..9de56bd
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/011_v1_국내주식-060_기간별매매손익현황조회.md
@@ -0,0 +1,1111 @@
+# 기간별매매손익현황조회
+
+- 원본 시트명: 기간별매매손익현황조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-060
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8715R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-period-trade-profit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+기간별매매손익현황조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0856] 기간별 매매손익 화면 에서 "종목별" 클릭 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8715R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| SORT_DVSN | 정렬구분 | string | Y | 2 | 00: 최근 순, 01: 과거 순, 02: 최근 순 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| PDNO | 상품번호 | string | Y | 12 | ""공란입력 시, 전체 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+| CBLC_DVSN | 잔고구분 | string | Y | 2 | 00: 전체 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| ctx_area_nk100 | 연속조회키100 | string | Y | 100 | |
+| ctx_area_fk100 | 연속조회검색조건100 | string | Y | 100 | |
+| output1 | 응답상세 | object array | Y | | array |
+| trad_dt | 매매일자 | string | Y | 8 | |
+| pdno | 상품번호 | string | Y | 12 | 종목번호(뒤 6자리만 해당) |
+| prdt_name | 상품명 | string | Y | 60 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| loan_dt | 대출일자 | string | Y | 8 | |
+| hldg_qty | 보유수량 | string | Y | 19 | |
+| pchs_unpr | 매입단가 | string | Y | 19 | |
+| buy_qty | 매수수량 | string | Y | 10 | |
+| buy_amt | 매수금액 | string | Y | 19 | |
+| sll_pric | 매도가격 | string | Y | 10 | |
+| sll_qty | 매도수량 | string | Y | 10 | |
+| sll_amt | 매도금액 | string | Y | 19 | |
+| rlzt_pfls | 실현손익 | string | Y | 19 | |
+| pfls_rt | 손익률 | string | Y | 238 | |
+| fee | 수수료 | string | Y | 19 | |
+| tl_tax | 제세금 | string | Y | 19 | |
+| loan_int | 대출이자 | string | Y | 19 | |
+| output2 | 응답상세2 | object | Y | | |
+| sll_qty_smtl | 매도수량합계 | string | Y | 19 | |
+| sll_tr_amt_smtl | 매도거래금액합계 | string | Y | 19 | |
+| sll_fee_smtl | 매도수수료합계 | string | Y | 19 | |
+| sll_tltx_smtl | 매도제세금합계 | string | Y | 19 | |
+| sll_excc_amt_smtl | 매도정산금액합계 | string | Y | 19 | |
+| buyqty_smtl | 매수수량합계 | string | Y | 8 | |
+| buy_tr_amt_smtl | 매수거래금액합계 | string | Y | 19 | |
+| buy_fee_smtl | 매수수수료합계 | string | Y | 19 | |
+| buy_tax_smtl | 매수제세금합계 | string | Y | 19 | |
+| buy_excc_amt_smtl | 매수정산금액합계 | string | Y | 19 | |
+| tot_qty | 총수량 | string | Y | 10 | |
+| tot_tr_amt | 총거래금액 | string | Y | 19 | |
+| tot_fee | 총수수료 | string | Y | 19 | |
+| tot_tltx | 총제세금 | string | Y | 19 | |
+| tot_excc_amt | 총정산금액 | string | Y | 19 | |
+| tot_rlzt_pfls | 총실현손익 | string | Y | 19 | |
+| loan_int | 대출이자 | string | Y | 19 | |
+| tot_pftrt | 총수익률 | string | Y | 238 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO":"12345678",
+"ACNT_PRDT_CD":"01",
+"PDNO":"",
+"INQR_STRT_DT":"20240216",
+"INQR_END_DT":"20240216",
+"SORT_DVSN":"02",
+"CBLC_DVSN":"00",
+"CTX_AREA_FK100":""
+"CTX_AREA_FK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": " ",
+ "ctx_area_nk100": "20240216^00000A000120^300^0^00000000^ ",
+ "output1": [
+ {
+ "trad_dt": "20240216",
+ "pdno": "000J2552221D",
+ "prdt_name": "SG 17WR",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "135",
+ "buy_qty": "2",
+ "buy_amt": "271",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "000J00532219",
+ "prdt_name": "국동 9WR",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "130",
+ "buy_qty": "10",
+ "buy_amt": "1300",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000Q520057",
+ "prdt_name": "미래에셋 인버스 2X 코스닥150 선물 ETN",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "1",
+ "pchs_unpr": "9365",
+ "buy_qty": "1",
+ "buy_amt": "9365",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A900270",
+ "prdt_name": "헝셩그룹",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "66",
+ "pchs_unpr": "322",
+ "buy_qty": "66",
+ "buy_amt": "21252",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A402340",
+ "prdt_name": "SK스퀘어",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "59000",
+ "buy_qty": "10",
+ "buy_amt": "590000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A373220",
+ "prdt_name": "LG에너지솔루션",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "552000",
+ "buy_qty": "10",
+ "buy_amt": "5520000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A361610",
+ "prdt_name": "SK아이이테크놀로지",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "110000",
+ "buy_qty": "10",
+ "buy_amt": "1100000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A352820",
+ "prdt_name": "하이브",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "383000",
+ "buy_qty": "2",
+ "buy_amt": "766000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A302440",
+ "prdt_name": "SK바이오사이언스",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "100000",
+ "buy_qty": "10",
+ "buy_amt": "1000000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A298050",
+ "prdt_name": "효성첨단소재",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "480000",
+ "buy_qty": "2",
+ "buy_amt": "960000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A298020",
+ "prdt_name": "효성티앤씨",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "365000",
+ "buy_qty": "2",
+ "buy_amt": "730000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A285130",
+ "prdt_name": "SK케미칼",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "100000",
+ "buy_qty": "10",
+ "buy_amt": "1000000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A136480",
+ "prdt_name": "하림",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "220",
+ "pchs_unpr": "2893",
+ "buy_qty": "226",
+ "buy_amt": "526563",
+ "sll_pric": "2936",
+ "sll_qty": "7",
+ "sll_amt": "20555",
+ "rlzt_pfls": "304",
+ "pfls_rt": "1.50116044",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A114090",
+ "prdt_name": "GKL",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "1",
+ "pchs_unpr": "15010",
+ "buy_qty": "1",
+ "buy_amt": "15010",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A097950",
+ "prdt_name": "CJ제일제당",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "210500",
+ "buy_qty": "10",
+ "buy_amt": "2105000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A096770",
+ "prdt_name": "SK이노베이션",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "228000",
+ "buy_qty": "10",
+ "buy_amt": "2280000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A093370",
+ "prdt_name": "후성",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "15510",
+ "buy_qty": "2",
+ "buy_amt": "31020",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A057050",
+ "prdt_name": "현대홈쇼핑",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "30100",
+ "buy_qty": "2",
+ "buy_amt": "60200",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A047050",
+ "prdt_name": "포스코인터내셔널",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "74400",
+ "buy_qty": "2",
+ "buy_amt": "148800",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A036460",
+ "prdt_name": "한국가스공사",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "27850",
+ "buy_qty": "2",
+ "buy_amt": "55700",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A035760",
+ "prdt_name": "CJ ENM",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "11",
+ "pchs_unpr": "58836",
+ "buy_qty": "11",
+ "buy_amt": "647200",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A035420",
+ "prdt_name": "NAVER",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "356000",
+ "buy_qty": "10",
+ "buy_amt": "3560000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A035250",
+ "prdt_name": "강원랜드",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "20950",
+ "buy_qty": "10",
+ "buy_amt": "209500",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A034730",
+ "prdt_name": "SK",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "182700",
+ "buy_qty": "10",
+ "buy_amt": "1827000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A030200",
+ "prdt_name": "KT",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "26050",
+ "buy_qty": "10",
+ "buy_amt": "260500",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A028670",
+ "prdt_name": "팬오션",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "4865",
+ "buy_qty": "2",
+ "buy_amt": "9730",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A028260",
+ "prdt_name": "삼성물산",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "5",
+ "pchs_unpr": "156100",
+ "buy_qty": "5",
+ "buy_amt": "780500",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A018260",
+ "prdt_name": "삼성에스디에스",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "250000",
+ "buy_qty": "2",
+ "buy_amt": "500000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A017670",
+ "prdt_name": "SK텔레콤",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "50100",
+ "buy_qty": "10",
+ "buy_amt": "501000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A015760",
+ "prdt_name": "한국전력",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "4",
+ "pchs_unpr": "8030",
+ "buy_qty": "4",
+ "buy_amt": "32120",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A011790",
+ "prdt_name": "SKC",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "49950",
+ "buy_qty": "10",
+ "buy_amt": "499500",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A011780",
+ "prdt_name": "금호석유",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "200000",
+ "buy_qty": "10",
+ "buy_amt": "2000000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A009540",
+ "prdt_name": "HD한국조선해양",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "170000",
+ "buy_qty": "10",
+ "buy_amt": "1700000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A008770",
+ "prdt_name": "호텔신라",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "99850",
+ "buy_qty": "2",
+ "buy_amt": "199700",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A006260",
+ "prdt_name": "LS",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "122000",
+ "buy_qty": "10",
+ "buy_amt": "1220000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A005940",
+ "prdt_name": "NH투자증권",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "11710",
+ "buy_qty": "10",
+ "buy_amt": "117100",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A005930",
+ "prdt_name": "삼성전자",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "1414",
+ "pchs_unpr": "53213",
+ "buy_qty": "1415",
+ "buy_amt": "75510700",
+ "sll_pric": "75900",
+ "sll_qty": "1",
+ "sll_amt": "75900",
+ "rlzt_pfls": "22687",
+ "pfls_rt": "42.63431868",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A005490",
+ "prdt_name": "POSCO홀딩스",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "133500",
+ "buy_qty": "10",
+ "buy_amt": "1335000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A005380",
+ "prdt_name": "현대차",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "240500",
+ "buy_qty": "2",
+ "buy_amt": "481000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A004800",
+ "prdt_name": "효성",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "66400",
+ "buy_qty": "2",
+ "buy_amt": "132800",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A003670",
+ "prdt_name": "포스코퓨처엠",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "531000",
+ "buy_qty": "2",
+ "buy_amt": "1062000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A003550",
+ "prdt_name": "LG",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "105600",
+ "buy_qty": "2",
+ "buy_amt": "211200",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A002380",
+ "prdt_name": "KCC",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "1",
+ "pchs_unpr": "252000",
+ "buy_qty": "1",
+ "buy_amt": "252000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A001120",
+ "prdt_name": "LX인터내셔널",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "1",
+ "pchs_unpr": "34050",
+ "buy_qty": "1",
+ "buy_amt": "34050",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000990",
+ "prdt_name": "DB하이텍",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "23000",
+ "buy_qty": "2",
+ "buy_amt": "46000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000670",
+ "prdt_name": "영풍",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "4",
+ "pchs_unpr": "640750",
+ "buy_qty": "4",
+ "buy_amt": "2563000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000660",
+ "prdt_name": "SK하이닉스",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "12",
+ "pchs_unpr": "122583",
+ "buy_qty": "10",
+ "buy_amt": "1345000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000270",
+ "prdt_name": "기아",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "84500",
+ "buy_qty": "10",
+ "buy_amt": "845000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000240",
+ "prdt_name": "한국앤컴퍼니",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "2",
+ "pchs_unpr": "23850",
+ "buy_qty": "2",
+ "buy_amt": "47700",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ },
+ {
+ "trad_dt": "20240216",
+ "pdno": "00000A000210",
+ "prdt_name": "DL",
+ "trad_dvsn_name": "현금",
+ "loan_dt": "",
+ "hldg_qty": "10",
+ "pchs_unpr": "50400",
+ "buy_qty": "10",
+ "buy_amt": "504000",
+ "sll_pric": "0",
+ "sll_qty": "0",
+ "sll_amt": "0",
+ "rlzt_pfls": "0",
+ "pfls_rt": "0.00000000",
+ "fee": "0",
+ "tl_tax": "0",
+ "loan_int": "0"
+ }
+ ],
+ "output2": {
+ "sll_qty_smtl": "8",
+ "sll_tr_amt_smtl": "96455",
+ "sll_fee_smtl": "0",
+ "sll_tltx_smtl": "0",
+ "sll_excc_amt_smtl": "96455",
+ "buyqty_smtl": "2003",
+ "buy_tr_amt_smtl": "116697331",
+ "buy_fee_smtl": "0",
+ "buy_tax_smtl": "0",
+ "buy_excc_amt_smtl": "116697331",
+ "tot_qty": "2011",
+ "tot_tr_amt": "116793786",
+ "tot_fee": "0",
+ "tot_tltx": "0",
+ "tot_excc_amt": "116793786",
+ "tot_rlzt_pfls": "22991",
+ "loan_int": "0",
+ "tot_pftrt": "31.29560057"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0500",
+ "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오. "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md b/docs/broker/kis/rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md
new file mode 100644
index 0000000..2f32c35
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/012_v1_국내주식-003_주식주문정정취소.md
@@ -0,0 +1,112 @@
+# 주식주문(정정취소)
+
+- 원본 시트명: 주식주문(정정취소)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-003
+- HTTP Method: POST
+- 실전 TR_ID: TTTC0013U
+- 모의 TR_ID: VTTC0013U
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/trading/order-rvsecncl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주문 건에 대하여 정정 및 취소하는 API입니다. 단, 이미 체결된 건은 정정 및 취소가 불가합니다.
+
+※ 정정은 원주문에 대한 주문단가 혹은 주문구분을 변경하는 사항으로, 정정이 가능한 수량은 원주문수량을 초과 할 수 없습니다.
+
+※ 주식주문(정정취소) 호출 전에 반드시 주식정정취소가능주문조회 호출을 통해 정정취소가능수량(output > psbl_qty)을 확인하신 후 정정취소주문 내시기 바랍니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
정정/취소 (구)TTTC0803U → (신)TTTC0013U
정정/취소 (모의투자) (구)VTTC0803U → (신)VTTC0013U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 종합계좌번호 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 상품유형코드 |
+| KRX_FWDG_ORD_ORGNO | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | 원주문번호 |
+| ORD_DVSN | 주문구분 | string | Y | 2 | [KRX]
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[NXT]
00 : 지정가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[SOR]
00 : 지정가
01 : 시장가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소) |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 01@정정
02@취소 |
+| ORD_QTY | 주문수량 | string | Y | 10 | 주문수량 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | 주문단가 |
+| QTY_ALL_ORD_YN | 잔량전부주문여부 | string | Y | 1 | 'Y@전량
N@일부' |
+| CNDT_PRIC | 조건가격 | string | N | 19 | 스탑지정가호가에서 사용 |
+| EXCG_ID_DVSN_CD | 거래소ID구분코드 | string | N | 3 | 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT
SOR (Smart Order Routing) : SOR
→ 미입력시 KRX로 진행되며, 모의투자는 KRX만 가능 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | single |
+| krx_fwdg_ord_orgno | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD": "01",
+"KRX_FWDG_ORD_ORGNO": "",
+"ORGN_ODNO": "0001566017",
+"ORD_DVSN": "00",
+"RVSE_CNCL_DVSN_CD": "01",
+"ORD_QTY": "1",
+"ORD_UNPR": "180000",
+"QTY_ALL_ORD_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "06010",
+ "ODNO": "0001569139",
+ "ORD_TMD": "131438"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/013_v1_국내주식-020_주식예약주문조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/013_v1_국내주식-020_주식예약주문조회.md
new file mode 100644
index 0000000..bcdd509
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/013_v1_국내주식-020_주식예약주문조회.md
@@ -0,0 +1,208 @@
+# 주식예약주문조회
+
+- 원본 시트명: 주식예약주문조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-020
+- HTTP Method: GET
+- 실전 TR_ID: CTSC0004R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/order-resv-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내예약주문 처리내역 조회 API 입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
CTSC0004R : 국내주식예약주문조회
* 모의투자 사용 불가 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| RSVN_ORD_ORD_DT | 예약주문시작일자 | string | Y | 8 | |
+| RSVN_ORD_END_DT | 예약주문종료일자 | string | Y | 8 | |
+| RSVN_ORD_SEQ | 예약주문순번 | string | Y | 10 | |
+| TMNL_MDIA_KIND_CD | 단말매체종류코드 | string | Y | 2 | "00" 입력 |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PRCS_DVSN_CD | 처리구분코드 | string | Y | 2 | 0: 전체
1: 처리내역
2: 미처리내역 |
+| CNCL_YN | 취소여부 | string | Y | 1 | "Y" 유효한 주문만 조회 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드(6자리) (공백 입력 시 전체 조회) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 다음 페이지 조회시 사용 |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 다음 페이지 조회시 사용 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | array | Y | | |
+| rsvn_ord_seq | 예약주문 순번 | string | N | 10 | |
+| rsvn_ord_ord_dt | 예약주문주문일자 | string | N | 8 | |
+| rsvn_ord_rcit_dt | 예약주문접수일자 | string | N | 8 | |
+| pdno | 상품번호 | string | N | 12 | |
+| ord_dvsn_cd | 주문구분코드 | string | N | 2 | |
+| ord_rsvn_qty | 주문예약수량 | string | N | 10 | |
+| tot_ccld_qty | 총체결수량 | string | N | 10 | |
+| cncl_ord_dt | 취소주문일자 | string | N | 8 | |
+| ord_tmd | 주문시각 | string | N | 6 | |
+| ctac_tlno | 연락전화번호 | string | N | 20 | |
+| rjct_rson2 | 거부사유2 | string | N | 200 | |
+| odno | 주문번호 | string | N | 10 | |
+| rsvn_ord_rcit_tmd | 예약주문접수시각 | string | N | 6 | |
+| kor_item_shtn_name | 한글종목단축명 | string | N | 60 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | |
+| ord_rsvn_unpr | 주문예약단가 | string | N | 19 | |
+| tot_ccld_amt | 총체결금액 | string | N | 19 | |
+| loan_dt | 대출일자 | string | N | 8 | |
+| cncl_rcit_tmd | 취소접수시각 | string | N | 6 | |
+| prcs_rslt | 처리결과 | string | N | 60 | |
+| ord_dvsn_name | 주문구분명 | string | N | 60 | |
+| tmnl_mdia_kind_cd | 단말매체종류코드 | string | N | 2 | |
+| rsvn_end_dt | 예약종료일자 | string | N | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "RSVN_ORD_ORD_DT":"20220520",
+ "RSVN_ORD_END_DT":"20220523",
+ "RSVN_ORD_SEQ":"",
+ "TMNL_MDIA_KIND_CD":"00",
+ "CANO":"81019970",
+ "ACNT_PRDT_CD":"01",
+
+ "PRCS_DVSN_CD":"0",
+ "CNCL_YN":"Y",
+ "PDNO":"",
+ "SLL_BUY_DVSN_CD":"",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "20220520!^null!^0!^Y!^!^ ",
+ "ctx_area_nk200": " !^ !^ ",
+ "output": [
+ {
+ "rsvn_ord_seq": "42401",
+ "rsvn_ord_ord_dt": "20220523",
+ "rsvn_ord_rcit_dt": "20220520",
+ "pdno": "005940",
+ "ord_dvsn_cd": "01",
+ "ord_rsvn_qty": "1",
+ "tot_ccld_qty": "0",
+ "cncl_ord_dt": "",
+ "ord_tmd": "",
+ "ctac_tlno": "0",
+ "rjct_rson2": "",
+ "odno": "",
+ "rsvn_ord_rcit_tmd": "165318",
+ "kor_item_shtn_name": "NH투자증권",
+ "sll_buy_dvsn_cd": "02",
+ "ord_rsvn_unpr": "6000",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "cncl_rcit_tmd": "",
+ "prcs_rslt": "미처리",
+ "ord_dvsn_name": "현금매수",
+ "tmnl_mdia_kind_cd": "31",
+ "rsvn_end_dt": "20220523"
+ },
+ {
+ "rsvn_ord_seq": "42405",
+ "rsvn_ord_ord_dt": "20220523",
+ "rsvn_ord_rcit_dt": "20220520",
+ "pdno": "005940",
+ "ord_dvsn_cd": "01",
+ "ord_rsvn_qty": "1",
+ "tot_ccld_qty": "0",
+ "cncl_ord_dt": "",
+ "ord_tmd": "",
+ "ctac_tlno": "0",
+ "rjct_rson2": "",
+ "odno": "",
+ "rsvn_ord_rcit_tmd": "170422",
+ "kor_item_shtn_name": "NH투자증권",
+ "sll_buy_dvsn_cd": "02",
+ "ord_rsvn_unpr": "6000",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "cncl_rcit_tmd": "",
+ "prcs_rslt": "미처리",
+ "ord_dvsn_name": "현금매수",
+ "tmnl_mdia_kind_cd": "31",
+ "rsvn_end_dt": ""
+ },
+ {
+ "rsvn_ord_seq": "42406",
+ "rsvn_ord_ord_dt": "20220523",
+ "rsvn_ord_rcit_dt": "20220520",
+ "pdno": "005940",
+ "ord_dvsn_cd": "01",
+ "ord_rsvn_qty": "1",
+ "tot_ccld_qty": "0",
+ "cncl_ord_dt": "",
+ "ord_tmd": "",
+ "ctac_tlno": "0",
+ "rjct_rson2": "",
+ "odno": "",
+ "rsvn_ord_rcit_tmd": "170453",
+ "kor_item_shtn_name": "NH투자증권",
+ "sll_buy_dvsn_cd": "02",
+ "ord_rsvn_unpr": "6000",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "cncl_rcit_tmd": "",
+ "prcs_rslt": "미처리",
+ "ord_dvsn_name": "현금매수",
+ "tmnl_mdia_kind_cd": "31",
+ "rsvn_end_dt": "20220523"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/014_v1_국내주식-034_퇴직연금-매수가능조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/014_v1_국내주식-034_퇴직연금-매수가능조회.md
new file mode 100644
index 0000000..f43073d
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/014_v1_국내주식-034_퇴직연금-매수가능조회.md
@@ -0,0 +1,107 @@
+# 퇴직연금 매수가능조회
+
+- 원본 시트명: 퇴직연금 매수가능조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-034
+- HTTP Method: GET
+- 실전 TR_ID: TTTC0503R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/pension/inquire-psbl-order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
+KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0503R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 29 |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ACCA_DVSN_CD | 적립금구분코드 | string | Y | 2 | 00 |
+| CMA_EVLU_AMT_ICLD_YN | CMA평가금액포함여부 | string | Y | 1 | |
+| ORD_DVSN | 주문구분 | string | Y | 2 | 00 : 지정가 / 01 : 시장가 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ruse_psbl_amt | 재사용가능금액 | string | Y | 19 | |
+| psbl_qty_calc_unpr | 가능수량계산단가 | string | Y | 19 | |
+| max_buy_amt | 최대매수금액 | string | Y | 19 | |
+| max_buy_qty | 최대매수수량 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"63512345",
+ "ACNT_PRDT_CD":"29",
+ "PDNO":"029513",
+ "ORD_UNPR":"55000",
+ "ORD_DVSN":"00",
+ "CMA_EVLU_AMT_ICLD_YN":"N",
+ "ACCA_DVSN_CD":"00"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "ord_psbl_cash": "11054042",
+ "ruse_psbl_amt": "0",
+ "psbl_qty_calc_unpr": "55000",
+ "max_buy_amt": "11054042",
+ "max_buy_qty": "200"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md
new file mode 100644
index 0000000..3dcf3d5
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md
@@ -0,0 +1,249 @@
+# 주식잔고조회
+
+- 원본 시트명: 주식잔고조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-006
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8434R
+- 모의 TR_ID: VTTC8434R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-balance
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식 잔고조회 API입니다.
+실전계좌의 경우, 한 번의 호출에 최대 50건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+모의계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+* 당일 전량매도한 잔고도 보유수량 0으로 보여질 수 있으나, 해당 보유수량 0인 잔고는 최종 D-2일 이후에는 잔고에서 사라집니다.
+
+※ 중요 : 해당 API는 제공 정보량이 많아 조회속도가 느린 API입니다. 주문 준비를 위해서는 주식매수/매도가능수량 조회 TR 사용을 권장 드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTC8434R : 주식 잔고 조회
[모의투자]
VTTC8434R : 주식 잔고 조회 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| AFHR_FLPR_YN | 시간외단일가, 거래소여부 | string | Y | 1 | N : 기본값,
Y : 시간외단일가,
X : NXT 정규장 (프리마켓, 메인, 애프터마켓)
※ NXT 선택 시 : NXT 거래종목만 시세 등 정보가 NXT 기준으로 변동됩니다. KRX 종목들은 그대로 유지 |
+| OFL_YN | 오프라인여부 | string | N | 1 | 공란(Default) |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 01 : 대출일별 |
+| UNPR_DVSN | 단가구분 | string | Y | 2 | 01 : 기본값 |
+| FUND_STTL_ICLD_YN | 펀드결제분포함여부 | string | Y | 1 | N : 포함하지 않음
Y : 포함 |
+| FNCG_AMT_AUTO_RDPT_YN | 융자금액자동상환여부 | string | Y | 1 | N : 기본값 |
+| PRCS_DVSN | 처리구분 | string | Y | 2 | 00 : 전일매매포함
01 : 전일매매미포함 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | N | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK100 | 연속조회키100 | string | N | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk100 | 연속조회검색조건100 | string | Y | 100 | |
+| ctx_area_nk100 | 연속조회키100 | string | Y | 100 | |
+| output1 | 응답상세1 | object array | Y | | Array |
+| pdno | 상품번호 | string | Y | 12 | 종목번호(뒷 6자리) |
+| prdt_name | 상품명 | string | Y | 60 | 종목명 |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | 매수매도구분 |
+| bfdy_buy_qty | 전일매수수량 | string | Y | 10 | |
+| bfdy_sll_qty | 전일매도수량 | string | Y | 10 | |
+| thdt_buyqty | 금일매수수량 | string | Y | 10 | |
+| thdt_sll_qty | 금일매도수량 | string | Y | 10 | |
+| hldg_qty | 보유수량 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 22 | 매입금액 / 보유수량 |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| prpr | 현재가 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | 평가금액 - 매입금액 |
+| evlu_pfls_rt | 평가손익율 | string | Y | 9 | |
+| evlu_erng_rt | 평가수익율 | string | Y | 31 | 미사용항목(0으로 출력) |
+| loan_dt | 대출일자 | string | Y | 8 | INQR_DVSN(조회구분)을 01(대출일별)로 설정해야 값이 나옴 |
+| loan_amt | 대출금액 | string | Y | 19 | |
+| stln_slng_chgs | 대주매각대금 | string | Y | 19 | |
+| expd_dt | 만기일자 | string | Y | 8 | |
+| fltt_rt | 등락율 | string | Y | 31 | |
+| bfdy_cprs_icdc | 전일대비증감 | string | Y | 19 | |
+| item_mgna_rt_name | 종목증거금율명 | string | Y | 20 | |
+| grta_rt_name | 보증금율명 | string | Y | 20 | |
+| sbst_pric | 대용가격 | string | Y | 19 | 증권매매의 위탁보증금으로서 현금 대신에 사용되는 유가증권 가격 |
+| stck_loan_unpr | 주식대출단가 | string | Y | 22 | |
+| output2 | 응답상세2 | object array | Y | | Array |
+| dnca_tot_amt | 예수금총금액 | string | Y | 19 | 예수금 |
+| nxdy_excc_amt | 익일정산금액 | string | Y | 19 | D+1 예수금 |
+| prvs_rcdl_excc_amt | 가수도정산금액 | string | Y | 19 | D+2 예수금 |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| bfdy_buy_amt | 전일매수금액 | string | Y | 19 | |
+| thdt_buy_amt | 금일매수금액 | string | Y | 19 | |
+| nxdy_auto_rdpt_amt | 익일자동상환금액 | string | Y | 19 | |
+| bfdy_sll_amt | 전일매도금액 | string | Y | 19 | |
+| thdt_sll_amt | 금일매도금액 | string | Y | 19 | |
+| d2_auto_rdpt_amt | D+2자동상환금액 | string | Y | 19 | |
+| bfdy_tlex_amt | 전일제비용금액 | string | Y | 19 | |
+| thdt_tlex_amt | 금일제비용금액 | string | Y | 19 | |
+| tot_loan_amt | 총대출금액 | string | Y | 19 | |
+| scts_evlu_amt | 유가평가금액 | string | Y | 19 | |
+| tot_evlu_amt | 총평가금액 | string | Y | 19 | 유가증권 평가금액 합계금액 + D+2 예수금 |
+| nass_amt | 순자산금액 | string | Y | 19 | |
+| fncg_gld_auto_rdpt_yn | 융자금자동상환여부 | string | Y | 1 | 보유현금에 대한 융자금만 차감여부
신용융자 매수체결 시점에서는 융자비율을 매매대금 100%로 계산 하였다가 수도결제일에 보증금에 해당하는 금액을 고객의 현금으로 충당하여 융자금을 감소시키는 업무 |
+| pchs_amt_smtl_amt | 매입금액합계금액 | string | Y | 19 | |
+| evlu_amt_smtl_amt | 평가금액합계금액 | string | Y | 19 | 유가증권 평가금액 합계금액 |
+| evlu_pfls_smtl_amt | 평가손익합계금액 | string | Y | 19 | |
+| tot_stln_slng_chgs | 총대주매각대금 | string | Y | 19 | |
+| bfdy_tot_asst_evlu_amt | 전일총자산평가금액 | string | Y | 19 | |
+| asst_icdc_amt | 자산증감액 | string | Y | 19 | |
+| asst_icdc_erng_rt | 자산증감수익율 | string | Y | 31 | 데이터 미제공 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "AFHR_FLPR_YN": "N",
+ "OFL_YN": "",
+ "INQR_DVSN": "01",
+ "UNPR_DVSN": "01",
+ "FUND_STTL_ICLD_YN": "N",
+ "FNCG_AMT_AUTO_RDPT_YN": "N",
+ "PRCS_DVSN": "01",
+ "CTX_AREA_FK100": "",
+ "CTX_AREA_NK100": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "81055689^01^N^N^01^01^N^ ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "pdno": "009150",
+ "prdt_name": "삼성전기",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "12",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "1686",
+ "thdt_sll_qty": "41",
+ "hldg_qty": "1657",
+ "ord_psbl_qty": "1611",
+ "pchs_avg_pric": "135440.2517",
+ "pchs_amt": "224424497",
+ "prpr": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "evlu_pfls_rt": "0.00",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "fltt_rt": "-100.00000000",
+ "bfdy_cprs_icdc": "-184500",
+ "item_mgna_rt_name": "",
+ "grta_rt_name": "",
+ "sbst_pric": "140220",
+ "stck_loan_unpr": "0.0000"
+ },
+ {
+ "pdno": "009150",
+ "prdt_name": "삼성전기",
+ "trad_dvsn_name": "자기융자",
+ "bfdy_buy_qty": "3",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "0",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "3",
+ "ord_psbl_qty": "3",
+ "pchs_avg_pric": "123000.0000",
+ "pchs_amt": "369000",
+ "prpr": "0",
+ "evlu_amt": "0",
+ "evlu_pfls_amt": "0",
+ "evlu_pfls_rt": "0.00",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "20211223",
+ "loan_amt": "369000",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "fltt_rt": "-100.00000000",
+ "bfdy_cprs_icdc": "-184500",
+ "item_mgna_rt_name": "",
+ "grta_rt_name": "",
+ "sbst_pric": "140220",
+ "stck_loan_unpr": "123000.0000"
+ }
+ ],
+ "output2": [
+ {
+ "dnca_tot_amt": "346455",
+ "nxdy_excc_amt": "346455",
+ "prvs_rcdl_excc_amt": "346455",
+ "cma_evlu_amt": "0",
+ "bfdy_buy_amt": "0",
+ "thdt_buy_amt": "0",
+ "nxdy_auto_rdpt_amt": "0",
+ "bfdy_sll_amt": "0",
+ "thdt_sll_amt": "0",
+ "d2_auto_rdpt_amt": "0",
+ "bfdy_tlex_amt": "0",
+ "thdt_tlex_amt": "0",
+ "tot_loan_amt": "0",
+ "scts_evlu_amt": "1759600",
+ "tot_evlu_amt": "2106055",
+ "nass_amt": "2106055",
+ "fncg_gld_auto_rdpt_yn": "",
+ "pchs_amt_smtl_amt": "2516522",
+ "evlu_amt_smtl_amt": "1759600",
+ "evlu_pfls_smtl_amt": "-756922",
+ "tot_stln_slng_chgs": "0",
+ "bfdy_tot_asst_evlu_amt": "2142945",
+ "asst_icdc_amt": "-36890",
+ "asst_icdc_erng_rt": "0.00000000"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/016_v1_국내주식-032_퇴직연금-체결기준잔고.md b/docs/broker/kis/rest/국내주식/주문/계좌/016_v1_국내주식-032_퇴직연금-체결기준잔고.md
new file mode 100644
index 0000000..2900464
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/016_v1_국내주식-032_퇴직연금-체결기준잔고.md
@@ -0,0 +1,156 @@
+# 퇴직연금 체결기준잔고
+
+- 원본 시트명: 퇴직연금 체결기준잔고
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-032
+- HTTP Method: GET
+- 실전 TR_ID: TTTC2202R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/pension/inquire-present-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
+KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC2202R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 29 |
+| USER_DVSN_CD | 사용자구분코드 | string | Y | 2 | 00 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+| PRCS_DVSN_CD | 처리구분코드 | string | N | 2 | 00 : 보유 주식 전체 조회
01 : 보유 주식 중 0주 주식 숨김 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object array | Y | | Array |
+| cblc_dvsn | 잔고구분 | string | Y | 2 | |
+| cblc_dvsn_name | 잔고구분명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| hldg_qty | 보유수량 | string | Y | 19 | |
+| slpsb_qty | 매도가능수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 184 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| evlu_pfls_rt | 평가손익율 | string | Y | 72 | |
+| prpr | 현재가 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| cblc_weit | 잔고비중 | string | Y | 238 | |
+| output2 | 응답상세2 | object array | Y | | Array |
+| pchs_amt_smtl_amt | 매입금액합계금액 | string | Y | 19 | |
+| evlu_amt_smtl_amt | 평가금액합계금액 | string | Y | 19 | |
+| evlu_pfls_smtl_amt | 평가손익합계금액 | string | Y | 19 | |
+| trad_pfls_smtl | 매매손익합계 | string | Y | 19 | |
+| thdt_tot_pfls_amt | 당일총손익금액 | string | Y | 19 | |
+| pftrt | 수익률 | string | Y | 238 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"63512345",
+ "ACNT_PRDT_CD":"29",
+ "USER_DVSN_CD":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "63512345^29^00^ ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "cblc_dvsn": "01",
+ "cblc_dvsn_name": "사용자",
+ "pdno": "069500",
+ "prdt_name": "KODEX 200",
+ "hldg_qty": "6",
+ "slpsb_qty": "6",
+ "pchs_avg_pric": "35670.0000",
+ "evlu_pfls_amt": "-3330",
+ "evlu_pfls_rt": "-1.56",
+ "prpr": "35115",
+ "evlu_amt": "210690",
+ "pchs_amt": "214020",
+ "cblc_weit": "53.06651890"
+ },
+ {
+ "cblc_dvsn": "01",
+ "cblc_dvsn_name": "사용자",
+ "pdno": "091160",
+ "prdt_name": "KODEX 반도체",
+ "hldg_qty": "7",
+ "slpsb_qty": "7",
+ "pchs_avg_pric": "35820.0000",
+ "evlu_pfls_amt": "-64400",
+ "evlu_pfls_rt": "-25.68",
+ "prpr": "26620",
+ "evlu_amt": "186340",
+ "pchs_amt": "250740",
+ "cblc_weit": "46.93348110"
+ }
+ ],
+ "output2": [
+ {
+ "pchs_amt_smtl_amt": "464760",
+ "evlu_amt_smtl_amt": "397030",
+ "evlu_pfls_smtl_amt": "-67730",
+ "trad_pfls_smtl": "0",
+ "thdt_tot_pfls_amt": "-67730",
+ "pftrt": "-14.57311300"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md
new file mode 100644
index 0000000..e2c24ed
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/017_v1_국내주식-007_매수가능조회.md
@@ -0,0 +1,136 @@
+# 매수가능조회
+
+- 원본 시트명: 매수가능조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-007
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8908R
+- 모의 TR_ID: VTTC8908R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-psbl-order
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+매수가능 조회 API입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 1건까지 확인 가능합니다.
+
+
+1) 매수가능금액 확인
+ . 미수 사용 X: nrcvb_buy_amt(미수없는매수금액) 확인
+ . 미수 사용 O: max_buy_amt(최대매수금액) 확인
+
+
+2) 매수가능수량 확인
+ . 특정 종목 전량매수 시 가능수량을 확인하실 경우 ORD_DVSN:00(지정가)는 종목증거금율이 반영되지 않습니다.
+ 따라서 "반드시" ORD_DVSN:01(시장가)로 지정하여 종목증거금율이 반영된 가능수량을 확인하시기 바랍니다.
+
+ (다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력하여 가능수량 확인)
+
+ . 미수 사용 X: ORD_DVSN:01(시장가) or 특정 주문구분(ex.IOC)로 지정하여 nrcvb_buy_qty(미수없는매수수량) 확인
+ . 미수 사용 O: ORD_DVSN:01(시장가) or 특정 주문구분(ex.IOC)로 지정하여 max_buy_qty(최대매수수량) 확인
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTC8908R : 매수 가능 조회
[모의투자]
VTTC8908R : 매수 가능 조회 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 상품번호 | string | Y | 12 | 종목번호(6자리)
* PDNO, ORD_UNPR 공란 입력 시, 매수수량 없이 매수금액만 조회됨 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | 1주당 가격
* 시장가(ORD_DVSN:01)로 조회 시, 공란으로 입력
* PDNO, ORD_UNPR 공란 입력 시, 매수수량 없이 매수금액만 조회됨 |
+| ORD_DVSN | 주문구분 | string | Y | 2 | * 특정 종목 전량매수 시 가능수량을 확인할 경우
00:지정가는 증거금율이 반영되지 않으므로
증거금율이 반영되는 01: 시장가로 조회
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력하여 가능수량 확인
* 종목별 매수가능수량 조회 없이 매수금액만 조회하고자 할 경우 임의값(00) 입력
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
08 : 자기주식
09 : 자기주식S-Option
10 : 자기주식금전신탁
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
51 : 장중대량
52 : 장중바스켓
62 : 장개시전 시간외대량
63 : 장개시전 시간외바스켓
67 : 장개시전 금전신탁자사주
69 : 장개시전 자기주식
72 : 시간외대량
77 : 시간외자사주신탁
79 : 시간외대량자기주식
80 : 바스켓 |
+| CMA_EVLU_AMT_ICLD_YN | CMA평가금액포함여부 | string | Y | 1 | Y : 포함
N : 포함하지 않음 |
+| OVRS_ICLD_YN | 해외포함여부 | string | Y | 1 | Y : 포함
N : 포함하지 않음 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | Single |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | 예수금으로 계산된 주문가능금액 |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
+| ruse_psbl_amt | 재사용가능금액 | string | Y | 19 | 전일/금일 매도대금으로 계산된 주문가능금액 |
+| fund_rpch_chgs | 펀드환매대금 | string | Y | 19 | |
+| psbl_qty_calc_unpr | 가능수량계산단가 | string | Y | 19 | |
+| nrcvb_buy_amt | 미수없는매수금액 | string | Y | 19 | 미수를 사용하지 않으실 경우 nrcvb_buy_amt(미수없는매수금액)을 확인 |
+| nrcvb_buy_qty | 미수없는매수수량 | string | Y | 10 | 미수를 사용하지 않으실 경우 nrcvb_buy_qty(미수없는매수수량)을 확인
* 특정 종목 전량매수 시 가능수량을 확인하실 경우
조회 시 ORD_DVSN:01(시장가)로 지정 필수
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력 |
+| max_buy_amt | 최대매수금액 | string | Y | 19 | 미수를 사용하시는 경우 max_buy_amt(최대매수금액)를 확인 |
+| max_buy_qty | 최대매수수량 | string | Y | 10 | 미수를 사용하시는 경우 max_buy_qty(최대매수수량)를 확인
* 특정 종목 전량매수 시 가능수량을 확인하실 경우
조회 시 ORD_DVSN:01(시장가)로 지정 필수
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력 |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| ovrs_re_use_amt_wcrc | 해외재사용금액원화 | string | Y | 19 | |
+| ord_psbl_frcr_amt_wcrc | 주문가능외화금액원화 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "005930",
+ "ORD_UNPR": "0",
+ "ORD_DVSN": "01",
+ "CMA_EVLU_AMT_ICLD_YN": "N",
+ "OVRS_ICLD_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "ord_psbl_cash": "741191178",
+ "ord_psbl_sbst": "0",
+ "ruse_psbl_amt": "0",
+ "fund_rpch_chgs": "0",
+ "psbl_qty_calc_unpr": "70000",
+ "nrcvb_buy_amt": "107177377",
+ "nrcvb_buy_qty": "1531",
+ "max_buy_amt": "1482382356",
+ "max_buy_qty": "21176",
+ "cma_evlu_amt": "0",
+ "ovrs_re_use_amt_wcrc": "0",
+ "ord_psbl_frcr_amt_wcrc": "1468797045293"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/018_v1_국내주식-052_기간별손익일별합산조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/018_v1_국내주식-052_기간별손익일별합산조회.md
new file mode 100644
index 0000000..e36c4bd
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/018_v1_국내주식-052_기간별손익일별합산조회.md
@@ -0,0 +1,164 @@
+# 기간별손익일별합산조회
+
+- 원본 시트명: 기간별손익일별합산조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-052
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8708R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-period-profit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+기간별손익일별합산조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0856] 기간별 매매손익 화면 에서 "일별" 클릭 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8708R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | |
+| PDNO | 상품번호 | string | Y | 12 | ""공란입력 시, 전체 |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | |
+| SORT_DVSN | 정렬구분 | string | Y | 2 | 00: 최근 순, 01: 과거 순, 02: 최근 순 |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 00 입력 |
+| CBLC_DVSN | 잔고구분 | string | Y | 2 | 00: 전체 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| trad_dt | 매매일자 | string | Y | 8 | |
+| buy_amt | 매수금액 | string | Y | 19 | |
+| sll_amt | 매도금액 | string | Y | 19 | |
+| rlzt_pfls | 실현손익 | string | Y | 19 | |
+| fee | 수수료 | string | Y | 19 | |
+| loan_int | 대출이자 | string | Y | 19 | |
+| tl_tax | 제세금 | string | Y | 19 | |
+| pfls_rt | 손익률 | string | Y | 238 | |
+| sll_qty1 | 매도수량1 | string | Y | 19 | |
+| buy_qty1 | 매수수량1 | string | Y | 9 | |
+| output2 | 응답상세2 | object | Y | | |
+| sll_qty_smtl | 매도수량합계 | string | Y | 19 | |
+| sll_tr_amt_smtl | 매도거래금액합계 | string | Y | 19 | |
+| sll_fee_smtl | 매도수수료합계 | string | Y | 19 | |
+| sll_tltx_smtl | 매도제세금합계 | string | Y | 19 | |
+| sll_excc_amt_smtl | 매도정산금액합계 | string | Y | 19 | |
+| buy_qty_smtl | 매수수량합계 | string | Y | 19 | |
+| buy_tr_amt_smtl | 매수거래금액합계 | string | Y | 19 | |
+| buy_fee_smtl | 매수수수료합계 | string | Y | 19 | |
+| buy_tax_smtl | 매수제세금합계 | string | Y | 19 | |
+| buy_excc_amt_smtl | 매수정산금액합계 | string | Y | 19 | |
+| tot_qty | 총수량 | string | Y | 10 | |
+| tot_tr_amt | 총거래금액 | string | Y | 19 | |
+| tot_fee | 총수수료 | string | Y | 19 | |
+| tot_tltx | 총제세금 | string | Y | 19 | |
+| tot_excc_amt | 총정산금액 | string | Y | 19 | |
+| tot_rlzt_pfls | 총실현손익 | string | Y | 19 | ※ HTS[0856] 기간별 매매손익 '일별' 화면의 우측 하단 '총손익률' 항목은
기간별매매손익현황조회(TTTC8715R) > output2 > tot_pftrt(총수익률) 으로 확인 가능 |
+| loan_int | 대출이자 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO":"12345678",
+"ACNT_PRDT_CD":"01",
+"PDNO":"",
+"INQR_STRT_DT":"20230101",
+"INQR_END_DT":"20240220",
+"SORT_DVSN":"00",
+"INQR_DVSN":"00",
+"CBLC_DVSN":"00",
+"CTX_AREA_FK100":"",
+"CTX_AREA_NK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": " ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "trad_dt": "20240220",
+ "buy_amt": "116697331",
+ "sll_amt": "96455",
+ "rlzt_pfls": "22991",
+ "fee": "0",
+ "loan_int": "0",
+ "tl_tax": "0",
+ "pfls_rt": "31.29560057",
+ "sll_qty1": "8",
+ "buy_qty1": "2003"
+ }
+ ],
+ "output2": {
+ "sll_qty_smtl": "8",
+ "sll_tr_amt_smtl": "96455",
+ "sll_fee_smtl": "0",
+ "sll_tltx_smtl": "0",
+ "sll_excc_amt_smtl": "96455",
+ "buy_qty_smtl": "2003",
+ "buy_tr_amt_smtl": "116697331",
+ "buy_fee_smtl": "0",
+ "buy_tax_smtl": "0",
+ "buy_excc_amt_smtl": "116697331",
+ "tot_qty": "2011",
+ "tot_tr_amt": "116793786",
+ "tot_fee": "0",
+ "tot_tltx": "0",
+ "tot_excc_amt": "116793786",
+ "tot_rlzt_pfls": "22991",
+ "loan_int": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md b/docs/broker/kis/rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md
new file mode 100644
index 0000000..780b4f7
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/019_v1_국내주식-001_주식주문현금.md
@@ -0,0 +1,113 @@
+# 주식주문(현금)
+
+- 원본 시트명: 주식주문(현금)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-001
+- HTTP Method: POST
+- 실전 TR_ID: (매도) TTTC0011U (매수) TTTC0012U
+- 모의 TR_ID: (매도) VTTC0011U (매수) VTTC0012U
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/trading/order-cash
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식주문(현금) API 입니다.
+
+※ TTC0802U(현금매수) 사용하셔서 미수매수 가능합니다. 단, 거래하시는 계좌가 증거금40%계좌로 신청이 되어있어야 가능합니다.
+※ 신용매수는 별도의 API가 준비되어 있습니다.
+
+※ ORD_QTY(주문수량), ORD_UNPR(주문단가) 등을 String으로 전달해야 함에 유의 부탁드립니다.
+
+※ ORD_UNPR(주문단가)가 없는 주문은 상한가로 주문금액을 선정하고 이후 체결이되면 체결금액로 정산됩니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
국내주식주문 매도 : (구)TTTC0801U → (신)TTTC0011U
국내주식주문 매도(모의투자) : (구)VTTC0801U → (신)VTTC0011U
국내주식주문 매수 : (구)TTTC0802U → (신)TTTC0012U
국내주식주문 매수(모의투자) : (구)VTTC0802U → (신)VTTC0012U' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 종합계좌번호 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 상품유형코드 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드(6자리) , ETN의 경우 7자리 입력 |
+| SLL_TYPE | 매도유형 (매도주문 시) | string | N | 2 | 01@일반매도
02@임의매매
05@대차매도
→ 미입력시 01 일반매도로 진행 |
+| ORD_DVSN | 주문구분 | string | Y | 2 | [KRX]
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[NXT]
00 : 지정가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[SOR]
00 : 지정가
01 : 시장가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소) |
+| ORD_QTY | 주문수량 | string | Y | 10 | 주문수량 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | 주문단가
시장가 등 주문시, "0"으로 입력 |
+| CNDT_PRIC | 조건가격 | string | N | 19 | 스탑지정가호가 주문 (ORD_DVSN이 22) 사용 시에만 필수 |
+| EXCG_ID_DVSN_CD | 거래소ID구분코드 | string | N | 3 | 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT
SOR (Smart Order Routing) : SOR
→ 미입력시 KRX로 진행되며, 모의투자는 KRX만 가능 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | single |
+| KRX_FWDG_ORD_ORGNO | 계좌관리점코드 | string | Y | 5 | |
+| ODNO | 주문번호 | string | Y | 10 | |
+| ORD_TMD | 주문시간 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "009150",
+ "ORD_DVSN": "00",
+ "ORD_QTY": "3",
+ "ORD_UNPR": "150000"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "06010",
+ "ODNO": "0001569157",
+ "ORD_TMD": "155211"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md
new file mode 100644
index 0000000..0a33e75
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/020_국내주식-165_매도가능수량조회.md
@@ -0,0 +1,116 @@
+# 매도가능수량조회
+
+- 원본 시트명: 매도가능수량조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: 국내주식-165
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8408R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-psbl-sell
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+매도가능수량조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0971] 주식 매도 화면에서 종목코드 입력 후 "가능" 클릭 시 매도가능수량이 확인되는 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+특정종목 매도가능수량 확인 시, 매도주문 내시려는 주문종목(PDNO)으로 API 호출 후
+output > ord_psbl_qty(주문가능수량) 확인하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8408R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 종합계좌번호 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌상품코드 |
+| PDNO | 종목번호 | string | Y | 12 | 보유종목 코드 ex)000660 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| buy_qty | 매수수량 | string | Y | 10 | |
+| sll_qty | 매도수량 | string | Y | 10 | |
+| cblc_qty | 잔고수량 | string | Y | 19 | |
+| nsvg_qty | 비저축수량 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 184 | |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| now_pric | 현재가 | string | Y | 8 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| evlu_pfls_rt | 평가손익율 | string | Y | 72 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+PDNO:005930
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "pdno": "005930",
+ "prdt_name": "삼성전자",
+ "buy_qty": "1746",
+ "sll_qty": "2",
+ "cblc_qty": "1744",
+ "nsvg_qty": "0",
+ "ord_psbl_qty": "1744",
+ "pchs_avg_pric": "54388.4874",
+ "pchs_amt": "0",
+ "now_pric": "75800",
+ "evlu_amt": "132195200",
+ "evlu_pfls_amt": "37341678",
+ "evlu_pfls_rt": "39.36"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0420",
+ "msg1": "정상적으로 조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/021_v1_국내주식-005_주식일별주문체결조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/021_v1_국내주식-005_주식일별주문체결조회.md
new file mode 100644
index 0000000..295dd79
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/021_v1_국내주식-005_주식일별주문체결조회.md
@@ -0,0 +1,240 @@
+# 주식일별주문체결조회
+
+- 원본 시트명: 주식일별주문체결조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-005
+- HTTP Method: GET
+- 실전 TR_ID: (3개월이내) TTTC0081R (3개월이전) CTSC9215R
+- 모의 TR_ID: (3개월이내) VTTC0081R (3개월이전) VTSC9215R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-daily-ccld
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식일별주문체결조회 API입니다.
+실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+모의계좌의 경우, 한 번의 호출에 최대 15건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+* 다만, 3개월 이전 체결내역 조회(CTSC9115R) 의 경우,
+장중에는 많은 거래량으로 인해 순간적으로 DB가 밀렸거나 응답을 늦게 받거나 하는 등의 이슈가 있을 수 있어
+① 가급적 장 종료 이후(15:30 이후) 조회하시고
+② 조회기간(INQR_STRT_DT와 INQR_END_DT 사이의 간격)을 보다 짧게 해서 조회하는 것을
+권유드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
3개월이내 (구)TTTC8001R → (신)TTTC0081R
3개월이전 (구)CTSC9115R → (신)CTSC9215R
[모의투자]
3개월이내 (구)VTTC8001R → (신)VTTC0081R
3개월이전 (구)VTSC9115R → (신)VTSC9215R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | YYYYMMDD |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | YYYYMMDD |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 00 : 전체 / 01 : 매도 / 02 : 매수 |
+| PDNO | 상품번호 | string | N | 12 | 종목번호(6자리) |
+| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| ODNO | 주문번호 | string | N | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| CCLD_DVSN | 체결구분 | string | Y | 2 | '00 전체
01 체결
02 미체결' |
+| INQR_DVSN | 조회구분 | string | Y | 2 | '00 역순
01 정순' |
+| INQR_DVSN_1 | 조회구분1 | string | Y | 1 | '없음: 전체
1: ELW
2: 프리보드' |
+| INQR_DVSN_3 | 조회구분3 | string | Y | 2 | '00 전체
01 현금
02 신용
03 담보
04 대주
05 대여
06 자기융자신규/상환
07 유통융자신규/상환' |
+| EXCG_ID_DVSN_CD | 거래소ID구분코드 | string | Y | 3 | 한국거래소 : KRX
대체거래소 (NXT) : NXT
SOR (Smart Order Routing) : SOR
ALL : 전체
※ 모의투자는 KRX만 제공 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | '공란 : 최초 조회시는
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)' |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | '공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| orgn_odno | 원주문번호 | string | Y | 10 | |
+| ord_dvsn_name | 주문구분명 | string | Y | 60 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| sll_buy_dvsn_cd_name | 매도매수구분코드명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| ord_unpr | 주문단가 | string | Y | 19 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| avg_prvs | 평균가 | string | Y | 19 | |
+| cncl_yn | 취소여부 | string | Y | 1 | |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| loan_dt | 대출일자 | string | Y | 8 | |
+| ordr_empno | 주문자사번 | string | Y | 60 | |
+| ord_dvsn_cd | 주문구분코드 | string | Y | 2 | |
+| cnc_cfrm_qty | 취소확인수량 | string | Y | 10 | |
+| rmn_qty | 잔여수량 | string | Y | 10 | |
+| rjct_qty | 거부수량 | string | Y | 10 | |
+| ccld_cndt_name | 체결조건명 | string | Y | 10 | |
+| inqr_ip_addr | 조회IP주소 | string | Y | 15 | |
+| cpbc_ordp_ord_rcit_dvsn_cd | 전산주문표주문접수구분코드 | string | Y | 2 | |
+| cpbc_ordp_infm_mthd_dvsn_cd | 전산주문표통보방법구분코드 | string | Y | 2 | |
+| infm_tmd | 통보시각 | string | Y | 6 | |
+| ctac_tlno | 연락전화번호 | string | Y | 20 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| excg_dvsn_cd | 거래소구분코드 | string | Y | 2 | |
+| cpbc_ordp_mtrl_dvsn_cd | 전산주문표자료구분코드 | string | Y | 2 | |
+| ord_orgno | 주문조직번호 | string | Y | 5 | |
+| rsvn_ord_end_dt | 예약주문종료일자 | string | Y | 8 | |
+| excg_id_dvsn_Cd | 거래소ID구분코드 | string | Y | 3 | |
+| stpm_cndt_pric | 스톱지정가조건가격 | string | Y | 9 | |
+| stpm_efct_occr_dtmd | 스톱지정가효력발생상세시각 | string | Y | 9 | |
+| output2 | 응답상세 | object | Y | | single |
+| tot_ord_qty | 총주문수량 | string | Y | 10 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| tot_ccld_amt | 매입평균가격 | string | Y | 19 | |
+| prsm_tlex_smtl | 총체결금액 | string | Y | 19 | |
+| pchs_avg_pric | 추정제비용합계 | string | Y | 184 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "12345678",
+ "ACNT_PRDT_CD": "01",
+ "INQR_STRT_DT": "20211101",
+ "INQR_END_DT": "20211101",
+ "SLL_BUY_DVSN_CD": "00",
+ "INQR_DVSN": "00",
+ "PDNO": "",
+ "CCLD_DVSN": "00",
+ "ORD_GNO_BRNO": "",
+ "ODNO": "",
+ "INQR_DVSN_3": "00",
+ "INQR_DVSN_1": "",
+ "CTX_AREA_FK100": "",
+ "CTX_AREA_NK100": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "12345678^01^20220103^20220103^ ^00^00^ ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "ord_dt": "20220103",
+ "ord_gno_brno": "06010",
+ "odno": "0001568197",
+ "orgn_odno": "",
+ "ord_dvsn_name": "Limit",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_cd_name": "BUY REJECT",
+ "pdno": "009150",
+ "prdt_name": "삼성전기",
+ "ord_qty": "10",
+ "ord_unpr": "150000",
+ "ord_tmd": "170100",
+ "tot_ccld_qty": "0",
+ "avg_prvs": "0",
+ "cncl_yn": "",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "ordr_empno": "Nsmart",
+ "ord_dvsn_cd": "00",
+ "cncl_cfrm_qty": "0",
+ "rmn_qty": "0",
+ "rjct_qty": "10",
+ "ccld_cndt_name": "None",
+ "inqr_ip_addr": "...",
+ "cpbc_ordp_ord_rcit_dvsn_cd": "",
+ "cpbc_ordp_infm_mthd_dvsn_cd": "",
+ "infm_tmd": "",
+ "ctac_tlno": "01047859775",
+ "prdt_type_cd": "300",
+ "excg_dvsn_cd": "02",
+ "cpbc_ordp_mtrl_dvsn_cd": "11",
+ "ord_orgno": "00000",
+ "rsvn_ord_end_dt": ""
+ },
+ {
+ "ord_dt": "20220103",
+ "ord_gno_brno": "06010",
+ "odno": "0001568196",
+ "orgn_odno": "",
+ "ord_dvsn_name": "Limit",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_cd_name": "BUY REJECT",
+ "pdno": "009150",
+ "prdt_name": "삼성전기",
+ "ord_qty": "10",
+ "ord_unpr": "150000",
+ "ord_tmd": "170038",
+ "tot_ccld_qty": "0",
+ "avg_prvs": "0",
+ "cncl_yn": "",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "ordr_empno": "Nsmart",
+ "ord_dvsn_cd": "00",
+ "cncl_cfrm_qty": "0",
+ "rmn_qty": "0",
+ "rjct_qty": "10",
+ "ccld_cndt_name": "None",
+ "inqr_ip_addr": "P01.012.345.678",
+ "cpbc_ordp_ord_rcit_dvsn_cd": "",
+ "cpbc_ordp_infm_mthd_dvsn_cd": "",
+ "infm_tmd": "",
+ "ctac_tlno": "01047859775",
+ "prdt_type_cd": "300",
+ "excg_dvsn_cd": "02",
+ "cpbc_ordp_mtrl_dvsn_cd": "11",
+ "ord_orgno": "00000",
+ "rsvn_ord_end_dt": ""
+ }
+ ],
+ "output2": {
+ "tot_ord_qty": "281",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "prsm_tlex_smtl": "0",
+ "pchs_avg_pric": "0.0000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md
new file mode 100644
index 0000000..416e05b
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/022_v1_국내주식-004_주식정정취소가능주문조회.md
@@ -0,0 +1,155 @@
+# 주식정정취소가능주문조회
+
+- 원본 시트명: 주식정정취소가능주문조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-004
+- HTTP Method: GET
+- 실전 TR_ID: TTTC0084R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-psbl-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식정정취소가능주문조회 API입니다. 한 번의 호출에 최대 50건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+※ 주식주문(정정취소) 호출 전에 반드시 주식정정취소가능주문조회 호출을 통해 정정취소가능수량(output > psbl_qty)을 확인하신 후 정정취소주문 내시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)TTTC8036R → (신)TTTC0084R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | '공란 : 최초 조회시는
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)' |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | '공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)' |
+| INQR_DVSN_1 | 조회구분1 | string | Y | 1 | '0 주문
1 종목' |
+| INQR_DVSN_2 | 조회구분2 | string | Y | 1 | '0 전체
1 매도
2 매수' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| odno | 주문번호 | string | Y | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| orgn_odno | 원주문번호 | string | Y | 6 | 정정/취소주문 인경우 원주문번호 |
+| ord_dvsn_name | 주문구분명 | string | Y | 5 | |
+| pdno | 상품번호 | string | Y | 10 | 종목번호(뒤 6자리만 해당) |
+| prdt_name | 상품명 | string | Y | 6 | 종목명 |
+| rvse_cncl_dvsn_name | 정정취소구분명 | string | Y | 5 | 정정 또는 취소 여부 표시 |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| ord_unpr | 주문단가 | string | Y | 6 | 1주당 주문가격 |
+| ord_tmd | 주문시각 | string | Y | 5 | 주문시각(시분초HHMMSS) |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | 주문 수량 중 체결된 수량 |
+| tot_ccld_amt | 총체결금액 | string | Y | 6 | 주문금액 중 체결금액 |
+| psbl_qty | 가능수량 | string | Y | 5 | 정정/취소 주문 가능 수량 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 10 | 01 : 매도 / 02 : 매수 |
+| ord_dvsn_cd | 주문구분코드 | string | Y | 6 | [KRX]
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[NXT]
00 : 지정가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[SOR]
00 : 지정가
01 : 시장가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소) |
+| mgco_aptm_odno | 운용사지정주문번호 | string | Y | 5 | |
+| excg_dvsn_cd | 거래소구분코드 | string | Y | 2 | |
+| excg_id_dvsn_cd | 거래소ID구분코드 | string | Y | 3 | |
+| excg_id_dvsn_name | 거래소ID구분명 | string | Y | 100 | |
+| stpm_cndt_pric | 스톱지정가조건가격 | string | Y | 9 | |
+| stpm_efct_occr_yn | 스톱지정가효력발생여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "ACNT_PRDT_CD": "01",
+ "CANO": "810XXXXX",
+ "CTX_AREA_FK100": "",
+ "CTX_AREA_NK100": "",
+ "INQR_DVSN_1": "0",
+ "INQR_DVSN_2": "0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "81055689^01^ ",
+ "ctx_area_nk100": " ",
+ "output": [
+ {
+ "ord_gno_brno": "06010",
+ "odno": "0001569139",
+ "orgn_odno": "0001569136",
+ "ord_dvsn_name": "지정가",
+ "pdno": "009150",
+ "prdt_name": "SamsungElecMech",
+ "rvse_cncl_dvsn_name": "BUY AMEND*",
+ "ord_qty": "1",
+ "ord_unpr": "140000",
+ "ord_tmd": "131438",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "psbl_qty": "1",
+ "sll_buy_dvsn_cd": "02",
+ "ord_dvsn_cd": "00",
+ "mgco_aptm_odno": ""
+ },
+ {
+ "ord_gno_brno": "06010",
+ "odno": "0001569138",
+ "orgn_odno": "",
+ "ord_dvsn_name": "지정가",
+ "pdno": "009150",
+ "prdt_name": "SamsungElecMech",
+ "rvse_cncl_dvsn_name": "",
+ "ord_qty": "1",
+ "ord_unpr": "200000",
+ "ord_tmd": "131421",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "psbl_qty": "1",
+ "sll_buy_dvsn_cd": "02",
+ "ord_dvsn_cd": "00",
+ "mgco_aptm_odno": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/023_v1_국내주식-017_주식예약주문.md b/docs/broker/kis/rest/국내주식/주문/계좌/023_v1_국내주식-017_주식예약주문.md
new file mode 100644
index 0000000..e3e65fb
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/023_v1_국내주식-017_주식예약주문.md
@@ -0,0 +1,134 @@
+# 주식예약주문
+
+- 원본 시트명: 주식예약주문
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-017
+- HTTP Method: POST
+- 실전 TR_ID: CTSC0008U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/order-resv
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 예약주문 매수/매도 API 입니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 유의사항
+ 1. 예약주문 가능시간 : 15시 40분 ~ 다음 영업일 7시 30분
+ (단, 서버 초기화 작업 시 예약주문 불가 : 23시 40분 ~ 00시 10분)
+ ※ 예약주문 처리내역은 통보되지 않으므로 주문처리일 장 시작전에 반드시 주문처리 결과를 확인하시기 바랍니다.
+
+ 2. 예약주문 안내
+ - 예약종료일 미입력 시 일반예약주문으로 최초 도래하는 영업일에 주문 전송됩니다.
+ - 예약종료일 입력 시 기간예약주문으로 최초 예약주문수량 중 미체결 된 수량에 대해 예약종료일까지 매 영업일 주문이
+ 실행됩니다. (예약종료일은 익영업일부터 달력일 기준으로 공휴일 포함하여 최대 30일이 되는 일자까지 입력가능)
+ - 예약주문 접수 처리순서는 일반/기간예약주문 중 신청일자가 빠른 주문이 우선합니다.
+ 단, 기간예약주문 자동배치시간(약 15시35분 ~ 15시55분)사이 접수되는 주문의 경우 당일에 한해 순서와 상관없이
+ 처리될 수 있습니다.
+ - 기간예약주문 자동배치시간(약 15시35분 ~ 15시55분)에는 예약주문 조회가 제한 될 수 있습니다.
+ - 기간예약주문은 계좌 당 주문건수 최대 1,000건으로 제한됩니다.
+
+3. 예약주문 접수내역 중 아래의 사유 등으로 인해 주문이 거부될 수 있사오니, 주문처리일 장 시작전에 반드시
+ 주문처리 결과를 확인하시기 바랍니다.
+ * 주문처리일 기준 : 매수가능금액 부족, 매도가능수량 부족, 주문수량/호가단위 오류, 대주 호가제한,
+ 신용/대주가능종목 변경, 상/하한폭 변경, 시가형성 종목(신규상장 등)의 시장가, 거래서비스 미신청 등
+
+ 4. 익일 예상 상/하한가는 조회시점의 현재가로 계산되며 익일의 유/무상증자, 배당, 감자, 합병, 액면변경 등에 의해
+ 변동될 수 있으며 이로 인해 상/하한가를 벗어나 주문이 거부되는 경우가 발생할 수 있사오니, 주문처리일 장 시작전에
+ 반드시 주문처리결과를 확인하시기 바랍니다.
+
+ 5. 정리매매종목, ELW, 신주인수권증권, 신주인수권증서 등은 가격제한폭(상/하한가) 적용 제외됩니다.
+
+ 6. 영업일 장 시작 후 [기간예약주문] 내역 취소는 해당시점 이후의 예약주문이 취소되는 것으로,
+ 일반주문으로 이미 전환된 주문에는 영향을 미치지 않습니다. 반드시 장 시작전 주문처리결과를 확인하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
CTSC0008U : 국내예약매수입력/주문예약매도입력 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 종목코드(6자리) | string | Y | 12 | |
+| ORD_QTY | 주문수량 | string | Y | 10 | 주문주식수 |
+| ORD_UNPR | 주문단가 | string | Y | 19 | 1주당 가격
* 장전 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | 00 : 지정가
01 : 시장가
02 : 조건부지정가
05 : 장전 시간외 |
+| ORD_OBJT_CBLC_DVSN_CD | 주문대상잔고구분코드 | string | Y | 2 | [매도매수구분코드 01:매도/02:매수시 사용]
10 : 현금
[매도매수구분코드 01:매도시 사용]
12 : 주식담보대출
14 : 대여상환
21 : 자기융자신규
22 : 유통대주신규
23 : 유통융자신규
24 : 자기대주신규
25 : 자기융자상환
26 : 유통대주상환
27 : 유통융자상환
28 : 자기대주상환 |
+| LOAN_DT | 대출일자 | string | N | 8 | |
+| RSVN_ORD_END_DT | 예약주문종료일자 | string | N | 8 | (YYYYMMDD) 현재 일자보다 이후로 설정해야 함
* RSVN_ORD_END_DT(예약주문종료일자)를 안 넣으면 다음날 주문처리되고 예약주문은 종료됨
* RSVN_ORD_END_DT(예약주문종료일자)는 익영업일부터 달력일 기준으로 공휴일 포함하여 최대 30일이 되는 일자까지 입력 가능 |
+| LDNG_DT | 대여일자 | string | N | 8 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | Array |
+| rsvn_ord_seq | 예약주문 순번 | string | N | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "009150",
+ "ORD_QTY": "10",
+ "ORD_UNPR": "160000",
+ "SLL_BUY_DVSN_CD":"02",
+ "ORD_DVSN_CD":"00",
+ "ORD_OBJT_CBLC_DVSN_CD":"10",
+ "LOAN_DT":"",
+ "RSVN_ORD_END_DT":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK2938",
+ "msg1": "예약주문이 접수되었습니다.",
+ "output": {
+ "RSVN_ORD_SEQ": "39607"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/024_v1_국내주식-002_주식주문신용.md b/docs/broker/kis/rest/국내주식/주문/계좌/024_v1_국내주식-002_주식주문신용.md
new file mode 100644
index 0000000..7392cdc
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/024_v1_국내주식-002_주식주문신용.md
@@ -0,0 +1,122 @@
+# 주식주문(신용)
+
+- 원본 시트명: 주식주문(신용)
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-002
+- HTTP Method: POST
+- 실전 TR_ID: (매도) TTTC0051U (매수) TTTC0052U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/order-credit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식주문(신용) API입니다.
+※ 모의투자는 사용 불가합니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
매도 : (구)TTTC0851U → (신)TTTC0051U
매수 : (구)TTTC0852U → (신)TTTC0052U
' |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 상품번호 | string | Y | 5 | 종목코드(6자리) |
+| SLL_TYPE | 매도유형 | string | N | 10 | 공란 입력 |
+| CRDT_TYPE | 신용유형 | string | Y | 2 | [매도] 22 : 유통대주신규, 24 : 자기대주신규, 25 : 자기융자상환, 27 : 유통융자상환
[매수] 21 : 자기융자신규, 23 : 유통융자신규 , 26 : 유통대주상환, 28 : 자기대주상환 |
+| LOAN_DT | 대출일자 | string | Y | 2 | [신용매수]
신규 대출로, 오늘날짜(yyyyMMdd)) 입력
[신용매도]
매도할 종목의 대출일자(yyyyMMdd)) 입력 |
+| ORD_DVSN | 주문구분 | string | Y | 8 | [KRX]
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[NXT]
00 : 지정가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[SOR]
00 : 지정가
01 : 시장가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소) |
+| ORD_QTY | 주문수량 | string | Y | 2 | |
+| ORD_UNPR | 주문단가 | string | Y | 5 | 1주당 가격
* 장전 시간외, 장후 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고 |
+| RSVN_ORD_YN | 예약주문여부 | string | N | 2 | 정규 증권시장이 열리지 않는 시간 (15:10분 ~ 익일 7:30분) 에 주문을 미리 설정 하여 다음 영업일 또는 설정한 기간 동안 아침 동시 호가에 주문하는 것
Y : 예약주문
N : 신용주문 |
+| EMGC_ORD_YN | 비상주문여부 | string | N | 2 | |
+| PGTR_DVSN | 프로그램매매구분 | string | N | 10 | |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | N | 19 | |
+| LQTY_TR_NGTN_DTL_NO | 대량거래협상상세번호 | string | N | 1 | |
+| LQTY_TR_AGMT_NO | 대량거래협정번호 | string | N | 20 | |
+| LQTY_TR_NGTN_ID | 대량거래협상자Id | string | N | 19 | |
+| LP_ORD_YN | LP주문여부 | string | N | 3 | |
+| MDIA_ODNO | 매체주문번호 | string | N | 10 | |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | N | 19 | |
+| PGM_NMPR_STMT_DVSN_CD | 프로그램호가신고구분코드 | string | N | 1 | |
+| CVRG_SLCT_RSON_CD | 반대매매선정사유코드 | string | N | 20 | |
+| CVRG_SEQ | 반대매매순번 | string | N | 19 | |
+| EXCG_ID_DVSN_CD | 거래소ID구분코드 | string | N | 3 | 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT
SOR (Smart Order Routing) : SOR
→ 미입력시 KRX로 진행되며, 모의투자는 KRX만 가능 |
+| CNDT_PRIC | 조건가격 | string | N | 19 | 스탑지정가호가에서 사용 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | single |
+| krx_fwdg_ord_orgno | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시간 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "009150",
+ "CRDT_TYPE": "21",
+ "LOAN_DT": "20211103",
+ "ORD_DVSN": "00",
+ "ORD_QTY": "1",
+ "ORD_UNPR": "130000",
+ "RSVN_ORD_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "06010",
+ "ODNO": "0001569138",
+ "ORD_TMD": "131421"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/025_v1_국내주식-036_퇴직연금-잔고조회.md b/docs/broker/kis/rest/국내주식/주문/계좌/025_v1_국내주식-036_퇴직연금-잔고조회.md
new file mode 100644
index 0000000..b553861
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/025_v1_국내주식-036_퇴직연금-잔고조회.md
@@ -0,0 +1,148 @@
+# 퇴직연금 잔고조회
+
+- 원본 시트명: 퇴직연금 잔고조회
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-036
+- HTTP Method: GET
+- 실전 TR_ID: TTTC2208R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/pension/inquire-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식, ETF, ETN만 조회 가능하며 펀드는 조회 불가합니다.
+
+※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
+KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC2208R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 29 |
+| ACCA_DVSN_CD | 적립금구분코드 | string | Y | 2 | 00 |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 00 : 전체 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | Array |
+| cblc_dvsn_name | 잔고구분명 | string | Y | 60 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| item_dvsn_name | 종목구분명 | string | Y | 60 | |
+| thdt_buyqty | 금일매수수량 | string | Y | 10 | |
+| thdt_sll_qty | 금일매도수량 | string | Y | 10 | |
+| hldg_qty | 보유수량 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 184 | |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| prpr | 현재가 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
+| evlu_erng_rt | 평가수익율 | string | Y | 238 | |
+| output2 | 응답상세2 | object | Y | | |
+| dnca_tot_amt | 예수금총금액 | string | Y | 19 | |
+| nxdy_excc_amt | 익일정산금액 | string | Y | 19 | |
+| prvs_rcdl_excc_amt | 가수도정산금액 | string | Y | 19 | |
+| thdt_buy_amt | 금일매수금액 | string | Y | 19 | |
+| thdt_sll_amt | 금일매도금액 | string | Y | 19 | |
+| thdt_tlex_amt | 금일제비용금액 | string | Y | 19 | |
+| scts_evlu_amt | 유가평가금액 | string | Y | 19 | |
+| tot_evlu_amt | 총평가금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"29",
+ "ACCA_DVSN_CD":"00",
+ "INQR_DVSN":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "12345678^29^00^00^ ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "cblc_dvsn_name": "사용자",
+ "prdt_name": "ACE 미국S&P500",
+ "pdno": "360200",
+ "item_dvsn_name": "현금",
+ "thdt_buyqty": "5",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "5",
+ "ord_psbl_qty": "5",
+ "pchs_avg_pric": "13235.0000",
+ "pchs_amt": "66175",
+ "prpr": "13235",
+ "evlu_amt": "66175",
+ "evlu_pfls_amt": "0",
+ "evlu_erng_rt": "0.00000000"
+ }
+ ],
+ "output2": {
+ "dnca_tot_amt": "100000",
+ "nxdy_excc_amt": "100000",
+ "prvs_rcdl_excc_amt": "33825",
+ "thdt_buy_amt": "66175",
+ "thdt_sll_amt": "0",
+ "thdt_tlex_amt": "0",
+ "scts_evlu_amt": "66175",
+ "tot_evlu_amt": "100000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/국내주식/주문/계좌/026_v1_국내주식-041_주식잔고조회_실현손익.md b/docs/broker/kis/rest/국내주식/주문/계좌/026_v1_국내주식-041_주식잔고조회_실현손익.md
new file mode 100644
index 0000000..772f3fa
--- /dev/null
+++ b/docs/broker/kis/rest/국내주식/주문/계좌/026_v1_국내주식-041_주식잔고조회_실현손익.md
@@ -0,0 +1,1128 @@
+# 주식잔고조회_실현손익
+
+- 원본 시트명: 주식잔고조회_실현손익
+- API 통신방식: REST
+- 메뉴 위치: [국내주식] 주문/계좌
+- API ID: v1_국내주식-041
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8494R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/trading/inquire-balance-rlz-pl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+주식잔고조회_실현손익 API입니다.
+한국투자 HTS(eFriend Plus) [0800] 국내 체결기준잔고 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+(참고: 포럼 - 공지사항 - 신규 API 추가 안내(주식잔고조회_실현손익 외 1건))
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8494R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| AFHR_FLPR_YN | 시간외단일가여부 | string | Y | 1 | 'N : 기본값
Y : 시간외단일가' |
+| OFL_YN | 오프라인여부 | string | Y | 1 | 공란 |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 00 : 전체 |
+| UNPR_DVSN | 단가구분 | string | Y | 2 | 01 : 기본값 |
+| FUND_STTL_ICLD_YN | 펀드결제포함여부 | string | Y | 1 | N : 포함하지 않음
Y : 포함 |
+| FNCG_AMT_AUTO_RDPT_YN | 융자금액자동상환여부 | string | Y | 1 | N : 기본값 |
+| PRCS_DVSN | PRCS_DVSN | string | Y | 2 | 00 : 전일매매포함
01 : 전일매매미포함 |
+| COST_ICLD_YN | 비용포함여부 | string | Y | 1 | |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | Array |
+| pdno | 상품번호 | string | Y | 12 | 종목번호(뒷 6자리) |
+| prdt_name | 상품명 | string | Y | 60 | 종목명 |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | 매수매도구분 |
+| bfdy_buy_qty | 전일매수수량 | string | Y | 10 | |
+| bfdy_sll_qty | 전일매도수량 | string | Y | 10 | |
+| thdt_buyqty | 금일매수수량 | string | Y | 10 | |
+| thdt_sll_qty | 금일매도수량 | string | Y | 10 | |
+| hldg_qty | 보유수량 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 23 | 매입금액 / 보유수량 |
+| pchs_amt | 매입금액 | string | Y | 19 | |
+| prpr | 현재가 | string | Y | 19 | |
+| evlu_amt | 평가금액 | string | Y | 19 | |
+| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | 평가금액 - 매입금액 |
+| evlu_pfls_rt | 평가손익율 | string | Y | 10 | |
+| evlu_erng_rt | 평가수익율 | string | Y | 32 | |
+| loan_dt | 대출일자 | string | Y | 8 | |
+| loan_amt | 대출금액 | string | Y | 19 | |
+| stln_slng_chgs | 대주매각대금 | string | Y | 19 | 신용 거래에서, 고객이 증권 회사로부터 대부받은 주식의 매각 대금 |
+| expd_dt | 만기일자 | string | Y | 8 | |
+| stck_loan_unpr | 주식대출단가 | string | Y | 23 | |
+| bfdy_cprs_icdc | 전일대비증감 | string | Y | 19 | |
+| fltt_rt | 등락율 | string | Y | 32 | |
+| output2 | 응답상세2 | object array | Y | | Array |
+| dnca_tot_amt | 예수금총금액 | string | Y | 19 | |
+| nxdy_excc_amt | 익일정산금액 | string | Y | 19 | |
+| prvs_rcdl_excc_amt | 가수도정산금액 | string | Y | 19 | |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| bfdy_buy_amt | 전일매수금액 | string | Y | 19 | |
+| thdt_buy_amt | 금일매수금액 | string | Y | 19 | |
+| nxdy_auto_rdpt_amt | 익일자동상환금액 | string | Y | 19 | |
+| bfdy_sll_amt | 전일매도금액 | string | Y | 19 | |
+| thdt_sll_amt | 금일매도금액 | string | Y | 19 | |
+| d2_auto_rdpt_amt | D+2자동상환금액 | string | Y | 19 | |
+| bfdy_tlex_amt | 전일제비용금액 | string | Y | 19 | |
+| thdt_tlex_amt | 금일제비용금액 | string | Y | 19 | |
+| tot_loan_amt | 총대출금액 | string | Y | 19 | |
+| scts_evlu_amt | 유가평가금액 | string | Y | 19 | |
+| tot_evlu_amt | 총평가금액 | string | Y | 19 | |
+| nass_amt | 순자산금액 | string | Y | 19 | |
+| fncg_gld_auto_rdpt_yn | 융자금자동상환여부 | string | Y | 1 | |
+| pchs_amt_smtl_amt | 매입금액합계금액 | string | Y | 19 | |
+| evlu_amt_smtl_amt | 평가금액합계금액 | string | Y | 19 | |
+| evlu_pfls_smtl_amt | 평가손익합계금액 | string | Y | 19 | |
+| tot_stln_slng_chgs | 총대주매각대금 | string | Y | 19 | |
+| bfdy_tot_asst_evlu_amt | 전일총자산평가금액 | string | Y | 19 | |
+| asst_icdc_amt | 자산증감액 | string | Y | 19 | |
+| asst_icdc_erng_rt | 자산증감수익율 | string | Y | 32 | |
+| rlzt_pfls | 실현손익 | string | Y | 19 | |
+| rlzt_erng_rt | 실현수익율 | string | Y | 32 | |
+| real_evlu_pfls | 실평가손익 | string | Y | 19 | |
+| real_evlu_pfls_erng_rt | 실평가손익수익율 | string | Y | 32 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO":"12345678",
+"ACNT_PRDT_CD":"01",
+"AFHR_FLPR_YN":"N",
+"OFL_YN":"",
+"INQR_DVSN":"02",
+"UNPR_DVSN":"01",
+"FUND_STTL_ICLD_YN":"N",
+"FNCG_AMT_AUTO_RDPT_YN":"N",
+"PRCS_DVSN":"01",
+"COST_ICLD_YN":"N",
+"CTX_AREA_FK100":"",
+"CTX_AREA_NK100":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "12345678^01^N^N^02^01^N^ ",
+ "ctx_area_nk100": "N^00000A900270^300^00000000^00^ ",
+ "output1": [
+ {
+ "pdno": "000080",
+ "prdt_name": "하이트진로",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "22975.0000",
+ "pchs_amt": "45950",
+ "prpr": "22600",
+ "evlu_amt": "45200",
+ "evlu_pfls_amt": "-750",
+ "evlu_pfls_rt": "-1.63",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "000100",
+ "prdt_name": "유한양행",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "64800.0000",
+ "pchs_amt": "129600",
+ "prpr": "67600",
+ "evlu_amt": "135200",
+ "evlu_pfls_amt": "5600",
+ "evlu_pfls_rt": "4.32",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "2900",
+ "fltt_rt": "4.48222566"
+ },
+ {
+ "pdno": "000120",
+ "prdt_name": "CJ대한통운",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "116800.0000",
+ "pchs_amt": "1168000",
+ "prpr": "129500",
+ "evlu_amt": "1295000",
+ "evlu_pfls_amt": "127000",
+ "evlu_pfls_rt": "10.87",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "500",
+ "fltt_rt": "0.38759690"
+ },
+ {
+ "pdno": "000210",
+ "prdt_name": "DL",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "50400.0000",
+ "pchs_amt": "504000",
+ "prpr": "45800",
+ "evlu_amt": "458000",
+ "evlu_pfls_amt": "-46000",
+ "evlu_pfls_rt": "-9.12",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "-5500",
+ "fltt_rt": "-10.72124756"
+ },
+ {
+ "pdno": "000240",
+ "prdt_name": "한국앤컴퍼니",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "23850.0000",
+ "pchs_amt": "47700",
+ "prpr": "17450",
+ "evlu_amt": "34900",
+ "evlu_pfls_amt": "-12800",
+ "evlu_pfls_rt": "-26.83",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "000270",
+ "prdt_name": "기아",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "84500.0000",
+ "pchs_amt": "845000",
+ "prpr": "89500",
+ "evlu_amt": "895000",
+ "evlu_pfls_amt": "50000",
+ "evlu_pfls_rt": "5.91",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "-35300",
+ "fltt_rt": "-28.28525641"
+ },
+ {
+ "pdno": "000660",
+ "prdt_name": "SK하이닉스",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "12",
+ "ord_psbl_qty": "12",
+ "pchs_avg_pric": "122583.3333",
+ "pchs_amt": "1471000",
+ "prpr": "161700",
+ "evlu_amt": "1940400",
+ "evlu_pfls_amt": "469400",
+ "evlu_pfls_rt": "31.91",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "1700",
+ "fltt_rt": "1.06250000"
+ },
+ {
+ "pdno": "000670",
+ "prdt_name": "영풍",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "4",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "4",
+ "ord_psbl_qty": "4",
+ "pchs_avg_pric": "640750.0000",
+ "pchs_amt": "2563000",
+ "prpr": "525000",
+ "evlu_amt": "2100000",
+ "evlu_pfls_amt": "-463000",
+ "evlu_pfls_rt": "-18.06",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "000990",
+ "prdt_name": "DB하이텍",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "23000.0000",
+ "pchs_amt": "46000",
+ "prpr": "49600",
+ "evlu_amt": "99200",
+ "evlu_pfls_amt": "53200",
+ "evlu_pfls_rt": "115.65",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "001120",
+ "prdt_name": "LX인터내셔널",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "1",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "1",
+ "ord_psbl_qty": "1",
+ "pchs_avg_pric": "34050.0000",
+ "pchs_amt": "34050",
+ "prpr": "28950",
+ "evlu_amt": "28950",
+ "evlu_pfls_amt": "-5100",
+ "evlu_pfls_rt": "-14.97",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "002380",
+ "prdt_name": "KCC",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "1",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "1",
+ "ord_psbl_qty": "1",
+ "pchs_avg_pric": "252000.0000",
+ "pchs_amt": "252000",
+ "prpr": "250000",
+ "evlu_amt": "250000",
+ "evlu_pfls_amt": "-2000",
+ "evlu_pfls_rt": "-0.79",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "003550",
+ "prdt_name": "LG",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "105600.0000",
+ "pchs_amt": "211200",
+ "prpr": "85000",
+ "evlu_amt": "170000",
+ "evlu_pfls_amt": "-41200",
+ "evlu_pfls_rt": "-19.50",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "-16200",
+ "fltt_rt": "-16.00790514"
+ },
+ {
+ "pdno": "003670",
+ "prdt_name": "포스코퓨처엠",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "531000.0000",
+ "pchs_amt": "1062000",
+ "prpr": "296000",
+ "evlu_amt": "592000",
+ "evlu_pfls_amt": "-470000",
+ "evlu_pfls_rt": "-44.25",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "004800",
+ "prdt_name": "효성",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "66400.0000",
+ "pchs_amt": "132800",
+ "prpr": "64700",
+ "evlu_amt": "129400",
+ "evlu_pfls_amt": "-3400",
+ "evlu_pfls_rt": "-2.56",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "005380",
+ "prdt_name": "현대차",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "240500.0000",
+ "pchs_amt": "481000",
+ "prpr": "244000",
+ "evlu_amt": "488000",
+ "evlu_pfls_amt": "7000",
+ "evlu_pfls_rt": "1.45",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "22000",
+ "fltt_rt": "9.90990991"
+ },
+ {
+ "pdno": "005490",
+ "prdt_name": "POSCO홀딩스",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "133500.0000",
+ "pchs_amt": "1335000",
+ "prpr": "421500",
+ "evlu_amt": "4215000",
+ "evlu_pfls_amt": "2880000",
+ "evlu_pfls_rt": "215.73",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "005930",
+ "prdt_name": "삼성전자",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "1417",
+ "thdt_sll_qty": "2",
+ "hldg_qty": "1415",
+ "ord_psbl_qty": "1415",
+ "pchs_avg_pric": "53397.8247",
+ "pchs_amt": "75557922",
+ "prpr": "73900",
+ "evlu_amt": "104568500",
+ "evlu_pfls_amt": "29010578",
+ "evlu_pfls_rt": "38.39",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "-400",
+ "fltt_rt": "-0.53835801"
+ },
+ {
+ "pdno": "005930",
+ "prdt_name": "삼성전자",
+ "trad_dvsn_name": "자기융자",
+ "bfdy_buy_qty": "1",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "0",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "1",
+ "ord_psbl_qty": "1",
+ "pchs_avg_pric": "45100.0000",
+ "pchs_amt": "45100",
+ "prpr": "73900",
+ "evlu_amt": "73900",
+ "evlu_pfls_amt": "28800",
+ "evlu_pfls_rt": "63.85",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "45100",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "45100.0000",
+ "bfdy_cprs_icdc": "-400",
+ "fltt_rt": "-0.53835801"
+ },
+ {
+ "pdno": "005940",
+ "prdt_name": "NH투자증권",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "11710.0000",
+ "pchs_amt": "117100",
+ "prpr": "10650",
+ "evlu_amt": "106500",
+ "evlu_pfls_amt": "-10600",
+ "evlu_pfls_rt": "-9.05",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "006260",
+ "prdt_name": "LS",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "122000.0000",
+ "pchs_amt": "1220000",
+ "prpr": "96600",
+ "evlu_amt": "966000",
+ "evlu_pfls_amt": "-254000",
+ "evlu_pfls_rt": "-20.81",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "008770",
+ "prdt_name": "호텔신라",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "99850.0000",
+ "pchs_amt": "199700",
+ "prpr": "59300",
+ "evlu_amt": "118600",
+ "evlu_pfls_amt": "-81100",
+ "evlu_pfls_rt": "-40.61",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "-2100",
+ "fltt_rt": "-3.42019544"
+ },
+ {
+ "pdno": "009540",
+ "prdt_name": "HD한국조선해양",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "170000.0000",
+ "pchs_amt": "1700000",
+ "prpr": "126000",
+ "evlu_amt": "1260000",
+ "evlu_pfls_amt": "-440000",
+ "evlu_pfls_rt": "-25.88",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "1000",
+ "fltt_rt": "0.80000000"
+ },
+ {
+ "pdno": "011780",
+ "prdt_name": "금호석유",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "200000.0000",
+ "pchs_amt": "2000000",
+ "prpr": "151900",
+ "evlu_amt": "1519000",
+ "evlu_pfls_amt": "-481000",
+ "evlu_pfls_rt": "-24.05",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "011790",
+ "prdt_name": "SKC",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "49950.0000",
+ "pchs_amt": "499500",
+ "prpr": "92100",
+ "evlu_amt": "921000",
+ "evlu_pfls_amt": "421500",
+ "evlu_pfls_rt": "84.38",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "015760",
+ "prdt_name": "한국전력",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "4",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "4",
+ "ord_psbl_qty": "4",
+ "pchs_avg_pric": "8030.0000",
+ "pchs_amt": "32120",
+ "prpr": "23000",
+ "evlu_amt": "92000",
+ "evlu_pfls_amt": "59880",
+ "evlu_pfls_rt": "186.42",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "017670",
+ "prdt_name": "SK텔레콤",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "50100.0000",
+ "pchs_amt": "501000",
+ "prpr": "53200",
+ "evlu_amt": "532000",
+ "evlu_pfls_amt": "31000",
+ "evlu_pfls_rt": "6.18",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "018260",
+ "prdt_name": "삼성에스디에스",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "250000.0000",
+ "pchs_amt": "500000",
+ "prpr": "174000",
+ "evlu_amt": "348000",
+ "evlu_pfls_amt": "-152000",
+ "evlu_pfls_rt": "-30.40",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "3200",
+ "fltt_rt": "1.87353630"
+ },
+ {
+ "pdno": "028260",
+ "prdt_name": "삼성물산",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "5",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "5",
+ "ord_psbl_qty": "5",
+ "pchs_avg_pric": "156100.0000",
+ "pchs_amt": "780500",
+ "prpr": "128000",
+ "evlu_amt": "640000",
+ "evlu_pfls_amt": "-140500",
+ "evlu_pfls_rt": "-18.00",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "028670",
+ "prdt_name": "팬오션",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "4865.0000",
+ "pchs_amt": "9730",
+ "prpr": "5000",
+ "evlu_amt": "10000",
+ "evlu_pfls_amt": "270",
+ "evlu_pfls_rt": "2.77",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "385",
+ "fltt_rt": "8.34236186"
+ },
+ {
+ "pdno": "030200",
+ "prdt_name": "KT",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "26050.0000",
+ "pchs_amt": "260500",
+ "prpr": "40650",
+ "evlu_amt": "406500",
+ "evlu_pfls_amt": "146000",
+ "evlu_pfls_rt": "56.04",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "034730",
+ "prdt_name": "SK",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "182700.0000",
+ "pchs_amt": "1827000",
+ "prpr": "207000",
+ "evlu_amt": "2070000",
+ "evlu_pfls_amt": "243000",
+ "evlu_pfls_rt": "13.30",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "035250",
+ "prdt_name": "강원랜드",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "20950.0000",
+ "pchs_amt": "209500",
+ "prpr": "19000",
+ "evlu_amt": "190000",
+ "evlu_pfls_amt": "-19500",
+ "evlu_pfls_rt": "-9.30",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "1230",
+ "fltt_rt": "6.92177828"
+ },
+ {
+ "pdno": "035420",
+ "prdt_name": "NAVER",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "356000.0000",
+ "pchs_amt": "3560000",
+ "prpr": "270000",
+ "evlu_amt": "2700000",
+ "evlu_pfls_amt": "-860000",
+ "evlu_pfls_rt": "-24.15",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "61000",
+ "fltt_rt": "29.18660287"
+ },
+ {
+ "pdno": "035760",
+ "prdt_name": "CJ ENM",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "11",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "11",
+ "ord_psbl_qty": "11",
+ "pchs_avg_pric": "58836.3636",
+ "pchs_amt": "647199",
+ "prpr": "82200",
+ "evlu_amt": "904200",
+ "evlu_pfls_amt": "257000",
+ "evlu_pfls_rt": "39.70",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "036460",
+ "prdt_name": "한국가스공사",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "27850.0000",
+ "pchs_amt": "55700",
+ "prpr": "30400",
+ "evlu_amt": "60800",
+ "evlu_pfls_amt": "5100",
+ "evlu_pfls_rt": "9.15",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "047050",
+ "prdt_name": "포스코인터내셔널",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "74400.0000",
+ "pchs_amt": "148800",
+ "prpr": "58400",
+ "evlu_amt": "116800",
+ "evlu_pfls_amt": "-32000",
+ "evlu_pfls_rt": "-21.50",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "057050",
+ "prdt_name": "현대홈쇼핑",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "30100.0000",
+ "pchs_amt": "60200",
+ "prpr": "46850",
+ "evlu_amt": "93700",
+ "evlu_pfls_amt": "33500",
+ "evlu_pfls_rt": "55.64",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "093370",
+ "prdt_name": "후성",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "2",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "2",
+ "ord_psbl_qty": "2",
+ "pchs_avg_pric": "15510.0000",
+ "pchs_amt": "31020",
+ "prpr": "9000",
+ "evlu_amt": "18000",
+ "evlu_pfls_amt": "-13020",
+ "evlu_pfls_rt": "-41.97",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt": "",
+ "stck_loan_unpr": "0.0000",
+ "bfdy_cprs_icdc": "0",
+ "fltt_rt": "0.00000000"
+ },
+ {
+ "pdno": "096770",
+ "prdt_name": "SK이노베이션",
+ "trad_dvsn_name": "현금",
+ "bfdy_buy_qty": "0",
+ "bfdy_sll_qty": "0",
+ "thdt_buyqty": "10",
+ "thdt_sll_qty": "0",
+ "hldg_qty": "10",
+ "ord_psbl_qty": "10",
+ "pchs_avg_pric": "228000.0000",
+ "pchs_amt": "2280000",
+ "prpr": "124100",
+ "evlu_amt": "1241000",
+ "evlu_pfls_amt": "-1039000",
+ "evlu_pfls_rt": "-45.57",
+ "evlu_erng_rt": "0.00000000",
+ "loan_dt": "",
+ "loan_amt": "0",
+ "stln_slng_chgs": "0",
+ "expd_dt
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/327_국내주식-132_장내채권현재가호가.md b/docs/broker/kis/rest/장내채권/기본시세/327_국내주식-132_장내채권현재가호가.md
new file mode 100644
index 0000000..0f2798b
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/327_국내주식-132_장내채권현재가호가.md
@@ -0,0 +1,153 @@
+# 장내채권현재가(호가)
+
+- 원본 시트명: 장내채권현재가(호가)
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-132
+- HTTP Method: GET
+- 실전 TR_ID: FHKBJ773401C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/inquire-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권현재가(호가) API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 "우측 호가창" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKBJ773401C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | B: 장내 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 채권종목코드
ex. KR2088012A16 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| aspr_acpt_hour | 호가 접수 시간 | string | Y | 6 | |
+| bond_askp1 | 채권 매도호가1 | string | Y | 112 | |
+| bond_askp2 | 채권 매도호가2 | string | Y | 112 | |
+| bond_askp3 | 채권 매도호가3 | string | Y | 112 | |
+| bond_askp4 | 채권 매도호가4 | string | Y | 112 | |
+| bond_askp5 | 채권 매도호가5 | string | Y | 112 | |
+| bond_bidp1 | 채권 매수호가1 | string | Y | 112 | |
+| bond_bidp2 | 채권 매수호가2 | string | Y | 112 | |
+| bond_bidp3 | 채권 매수호가3 | string | Y | 112 | |
+| bond_bidp4 | 채권 매수호가4 | string | Y | 112 | |
+| bond_bidp5 | 채권 매수호가5 | string | Y | 112 | |
+| askp_rsqn1 | 매도호가 잔량1 | string | Y | 12 | |
+| askp_rsqn2 | 매도호가 잔량2 | string | Y | 12 | |
+| askp_rsqn3 | 매도호가 잔량3 | string | Y | 12 | |
+| askp_rsqn4 | 매도호가 잔량4 | string | Y | 12 | |
+| askp_rsqn5 | 매도호가 잔량5 | string | Y | 12 | |
+| bidp_rsqn1 | 매수호가 잔량1 | string | Y | 12 | |
+| bidp_rsqn2 | 매수호가 잔량2 | string | Y | 12 | |
+| bidp_rsqn3 | 매수호가 잔량3 | string | Y | 12 | |
+| bidp_rsqn4 | 매수호가 잔량4 | string | Y | 12 | |
+| bidp_rsqn5 | 매수호가 잔량5 | string | Y | 12 | |
+| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
+| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
+| ntby_aspr_rsqn | 순매수 호가 잔량 | string | Y | 12 | |
+| seln_ernn_rate1 | 매도 수익 비율1 | string | Y | 84 | |
+| seln_ernn_rate2 | 매도 수익 비율2 | string | Y | 84 | |
+| seln_ernn_rate3 | 매도 수익 비율3 | string | Y | 84 | |
+| seln_ernn_rate4 | 매도 수익 비율4 | string | Y | 84 | |
+| seln_ernn_rate5 | 매도 수익 비율5 | string | Y | 84 | |
+| shnu_ernn_rate1 | 매수2 수익 비율1 | string | Y | 84 | |
+| shnu_ernn_rate2 | 매수2 수익 비율2 | string | Y | 84 | |
+| shnu_ernn_rate3 | 매수2 수익 비율3 | string | Y | 84 | |
+| shnu_ernn_rate4 | 매수2 수익 비율4 | string | Y | 84 | |
+| shnu_ernn_rate5 | 매수2 수익 비율5 | string | Y | 84 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:B
+FID_INPUT_ISCD:KR2088012A16
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "aspr_acpt_hour": "094618",
+ "bond_askp1": "0.00",
+ "bond_askp2": "0.00",
+ "bond_askp3": "0.00",
+ "bond_askp4": "0.00",
+ "bond_askp5": "0.00",
+ "bond_bidp1": "10190.20",
+ "bond_bidp2": "10189.70",
+ "bond_bidp3": "10189.40",
+ "bond_bidp4": "10188.90",
+ "bond_bidp5": "10188.60",
+ "askp_rsqn1": "0",
+ "askp_rsqn2": "0",
+ "askp_rsqn3": "0",
+ "askp_rsqn4": "0",
+ "askp_rsqn5": "0",
+ "bidp_rsqn1": "320138",
+ "bidp_rsqn2": "53685",
+ "bidp_rsqn3": "9081",
+ "bidp_rsqn4": "8232",
+ "bidp_rsqn5": "4020",
+ "total_askp_rsqn": "0",
+ "total_bidp_rsqn": "425156",
+ "ntby_aspr_rsqn": "425156",
+ "seln_ernn_rate1": "0.000",
+ "seln_ernn_rate2": "0.000",
+ "seln_ernn_rate3": "0.000",
+ "seln_ernn_rate4": "0.000",
+ "seln_ernn_rate5": "0.000",
+ "shnu_ernn_rate1": "4.549",
+ "shnu_ernn_rate2": "4.556",
+ "shnu_ernn_rate3": "4.560",
+ "shnu_ernn_rate4": "4.567",
+ "shnu_ernn_rate5": "4.571"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/328_국내주식-200_장내채권현재가시세.md b/docs/broker/kis/rest/장내채권/기본시세/328_국내주식-200_장내채권현재가시세.md
new file mode 100644
index 0000000..1beec01
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/328_국내주식-200_장내채권현재가시세.md
@@ -0,0 +1,119 @@
+# 장내채권현재가(시세)
+
+- 원본 시트명: 장내채권현재가(시세)
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-200
+- HTTP Method: GET
+- 실전 TR_ID: FHKBJ773400C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/inquire-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권현재가(시세) API입니다.
+장내채권의 기본시세(시가,고가,저가,종가)를 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKBJ773400C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | B (업종코드) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 채권종목코드(ex KR2033022D33) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| stnd_iscd | 표준종목코드 | string | Y | 12 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| bond_prpr | 채권현재가 | string | Y | 112 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| bond_prdy_vrss | 채권전일대비 | string | Y | 112 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| bond_prdy_clpr | 채권전일종가 | string | Y | 112 | |
+| bond_oprc | 채권시가2 | string | Y | 112 | |
+| bond_hgpr | 채권고가 | string | Y | 112 | |
+| bond_lwpr | 채권저가 | string | Y | 112 | |
+| ernn_rate | 수익비율 | string | Y | 84 | |
+| oprc_ert | 시가2수익률 | string | Y | 72 | |
+| hgpr_ert | 최고가수익률 | string | Y | 72 | |
+| lwpr_ert | 최저가수익률 | string | Y | 72 | |
+| bond_mxpr | 채권상한가 | string | Y | 112 | |
+| bond_llam | 채권하한가 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:B
+FID_INPUT_ISCD:KR6095572D81
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "stnd_iscd": "KR6095572D81",
+ "hts_kor_isnm": "AJ네트웍스63-2",
+ "bond_prpr": "10265.00",
+ "prdy_vrss_sign": "5",
+ "bond_prdy_vrss": "-15.00",
+ "prdy_ctrt": "-0.15",
+ "acml_vol": "110000",
+ "bond_prdy_clpr": "10280.00",
+ "bond_oprc": "10265.00",
+ "bond_hgpr": "10265.00",
+ "bond_lwpr": "10265.00",
+ "ernn_rate": "4.478",
+ "oprc_ert": "4.478",
+ "hgpr_ert": "4.478",
+ "lwpr_ert": "4.478",
+ "bond_mxpr": "13364.00",
+ "bond_llam": "7196.00"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/329_국내주식-201_장내채권현재가체결.md b/docs/broker/kis/rest/장내채권/기본시세/329_국내주식-201_장내채권현재가체결.md
new file mode 100644
index 0000000..ea55596
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/329_국내주식-201_장내채권현재가체결.md
@@ -0,0 +1,101 @@
+# 장내채권현재가(체결)
+
+- 원본 시트명: 장내채권현재가(체결)
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-201
+- HTTP Method: GET
+- 실전 TR_ID: FHKBJ773403C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/inquire-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권현재가(체결) API입니다
+장내채권의 체결데이터를 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKBJ773403C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | B (업종코드) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 채권종목코드(ex KR2033022D33) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
+| bond_prpr | 채권 현재가 | string | Y | 112 | |
+| bond_prdy_vrss | 채권 전일 대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:B
+FID_INPUT_ISCD:KR6095572D81
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_cntg_hour": "091632",
+ "bond_prpr": "10265.00",
+ "bond_prdy_vrss": "-15.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.15",
+ "cntg_vol": "110000",
+ "acml_vol": "110000"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/330_국내주식-202_장내채권현재가일별.md b/docs/broker/kis/rest/장내채권/기본시세/330_국내주식-202_장내채권현재가일별.md
new file mode 100644
index 0000000..bb69a52
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/330_국내주식-202_장내채권현재가일별.md
@@ -0,0 +1,271 @@
+# 장내채권현재가(일별)
+
+- 원본 시트명: 장내채권현재가(일별)
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-202
+- HTTP Method: GET
+- 실전 TR_ID: FHKBJ773404C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/inquire-daily-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권현재가(일별) API입니다.
+장내채권의 일별 시세데이터를 최근 100건까지 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKBJ773404C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | B (업종코드) |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 채권종목코드(ex KR2033022D33) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| bond_prpr | 채권현재가 | string | Y | 112 | |
+| bond_prdy_vrss | 채권전일대비 | string | Y | 112 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| prdy_ctrt | 전일대비율 | string | Y | 82 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+| bond_oprc | 채권시가2 | string | Y | 112 | |
+| bond_hgpr | 채권고가 | string | Y | 112 | |
+| bond_lwpr | 채권저가 | string | Y | 112 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:B
+FID_INPUT_ISCD:KR6095572D81
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240503",
+ "bond_prpr": "10265.00",
+ "bond_prdy_vrss": "-15.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.15",
+ "acml_vol": "110000",
+ "bond_oprc": "10265.00",
+ "bond_hgpr": "10265.00",
+ "bond_lwpr": "10265.00"
+ },
+ {
+ "stck_bsop_date": "20240502",
+ "bond_prpr": "10280.00",
+ "bond_prdy_vrss": "-145.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-1.39",
+ "acml_vol": "61278",
+ "bond_oprc": "10280.00",
+ "bond_hgpr": "10280.00",
+ "bond_lwpr": "10280.00"
+ },
+ {
+ "stck_bsop_date": "20240430",
+ "bond_prpr": "10425.00",
+ "bond_prdy_vrss": "5.00",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.05",
+ "acml_vol": "5012",
+ "bond_oprc": "10425.00",
+ "bond_hgpr": "10425.00",
+ "bond_lwpr": "10425.00"
+ },
+ {
+ "stck_bsop_date": "20240429",
+ "bond_prpr": "10420.00",
+ "bond_prdy_vrss": "-30.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.29",
+ "acml_vol": "9999",
+ "bond_oprc": "10420.00",
+ "bond_hgpr": "10420.00",
+ "bond_lwpr": "10420.00"
+ },
+ {
+ "stck_bsop_date": "20240426",
+ "bond_prpr": "10450.00",
+ "bond_prdy_vrss": "10.30",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.10",
+ "acml_vol": "102001",
+ "bond_oprc": "10430.00",
+ "bond_hgpr": "10450.00",
+ "bond_lwpr": "10430.00"
+ },
+ {
+ "stck_bsop_date": "20240425",
+ "bond_prpr": "10439.70",
+ "bond_prdy_vrss": "39.70",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.38",
+ "acml_vol": "5718",
+ "bond_oprc": "10290.00",
+ "bond_hgpr": "10439.70",
+ "bond_lwpr": "10290.00"
+ },
+ {
+ "stck_bsop_date": "20240424",
+ "bond_prpr": "10400.00",
+ "bond_prdy_vrss": "-100.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.95",
+ "acml_vol": "3000",
+ "bond_oprc": "10400.00",
+ "bond_hgpr": "10400.00",
+ "bond_lwpr": "10400.00"
+ },
+ {
+ "stck_bsop_date": "20240423",
+ "bond_prpr": "10500.00",
+ "bond_prdy_vrss": "50.00",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.48",
+ "acml_vol": "10023",
+ "bond_oprc": "10400.00",
+ "bond_hgpr": "10500.00",
+ "bond_lwpr": "10400.00"
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "bond_prpr": "10450.00",
+ "bond_prdy_vrss": "50.00",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.48",
+ "acml_vol": "185887",
+ "bond_oprc": "10450.00",
+ "bond_hgpr": "10500.00",
+ "bond_lwpr": "10449.90"
+ },
+ {
+ "stck_bsop_date": "20240416",
+ "bond_prpr": "10400.00",
+ "bond_prdy_vrss": "41.00",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.40",
+ "acml_vol": "16204",
+ "bond_oprc": "10270.10",
+ "bond_hgpr": "10400.00",
+ "bond_lwpr": "10270.10"
+ },
+ {
+ "stck_bsop_date": "20240409",
+ "bond_prpr": "10359.00",
+ "bond_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "25500",
+ "bond_oprc": "10270.00",
+ "bond_hgpr": "10359.00",
+ "bond_lwpr": "10270.00"
+ },
+ {
+ "stck_bsop_date": "20240408",
+ "bond_prpr": "10359.00",
+ "bond_prdy_vrss": "98.90",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.96",
+ "acml_vol": "3908",
+ "bond_oprc": "10270.00",
+ "bond_hgpr": "10359.00",
+ "bond_lwpr": "10201.40"
+ },
+ {
+ "stck_bsop_date": "20240405",
+ "bond_prpr": "10260.10",
+ "bond_prdy_vrss": "10.10",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "0.10",
+ "acml_vol": "86102",
+ "bond_oprc": "10260.00",
+ "bond_hgpr": "10369.70",
+ "bond_lwpr": "10260.00"
+ },
+ {
+ "stck_bsop_date": "20240404",
+ "bond_prpr": "10250.00",
+ "bond_prdy_vrss": "0.00",
+ "prdy_vrss_sign": "3",
+ "prdy_ctrt": "0.00",
+ "acml_vol": "160002",
+ "bond_oprc": "10370.00",
+ "bond_hgpr": "10370.00",
+ "bond_lwpr": "10250.00"
+ },
+ {
+ "stck_bsop_date": "20240403",
+ "bond_prpr": "10250.00",
+ "bond_prdy_vrss": "-10.00",
+ "prdy_vrss_sign": "5",
+ "prdy_ctrt": "-0.10",
+ "acml_vol": "15003",
+ "bond_oprc": "10200.00",
+ "bond_hgpr": "10250.00",
+ "bond_lwpr": "10200.00"
+ },
+ {
+ "stck_bsop_date": "20240402",
+ "bond_prpr": "10260.00",
+ "bond_prdy_vrss": "120.00",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "1.18",
+ "acml_vol": "50000",
+ "bond_oprc": "10260.00",
+ "bond_hgpr": "10260.00",
+ "bond_lwpr": "10260.00"
+ },
+ ...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/331_국내주식-159_장내채권-기간별시세일.md b/docs/broker/kis/rest/장내채권/기본시세/331_국내주식-159_장내채권-기간별시세일.md
new file mode 100644
index 0000000..76ec8c9
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/331_국내주식-159_장내채권-기간별시세일.md
@@ -0,0 +1,333 @@
+# 장내채권 기간별시세(일)
+
+- 원본 시트명: 장내채권 기간별시세(일)
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-159
+- HTTP Method: GET
+- 실전 TR_ID: FHKBJ773701C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/inquire-daily-itemchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 기간별시세(일) API입니다.
+한국투자 HTS(eFriend Plus) > [0979] 장내채권종합주문 화면 가운데 "일별" 클릭 시 시세 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+최근 30건까지 데이터 확인이 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKBJ773701C0 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 구분 코드 | string | Y | 6 | Unique key(B) |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
+| bond_oprc | 채권시가2 | string | Y | 112 | |
+| bond_hgpr | 채권고가 | string | Y | 112 | |
+| bond_lwpr | 채권저가 | string | Y | 112 | |
+| bond_prpr | 채권현재가 | string | Y | 112 | |
+| acml_vol | 누적거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_MRKT_DIV_CODE:B
+FID_INPUT_ISCD:KR101501D967
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "stck_bsop_date": "20240610",
+ "bond_oprc": "0.00",
+ "bond_hgpr": "0.00",
+ "bond_lwpr": "0.00",
+ "bond_prpr": "10997.10",
+ "acml_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240607",
+ "bond_oprc": "10997.10",
+ "bond_hgpr": "10997.10",
+ "bond_lwpr": "10997.10",
+ "bond_prpr": "10997.10",
+ "acml_vol": "119"
+ },
+ {
+ "stck_bsop_date": "20240605",
+ "bond_oprc": "10997.50",
+ "bond_hgpr": "10997.50",
+ "bond_lwpr": "10997.50",
+ "bond_prpr": "10997.50",
+ "acml_vol": "97"
+ },
+ {
+ "stck_bsop_date": "20240530",
+ "bond_oprc": "10860.00",
+ "bond_hgpr": "10860.00",
+ "bond_lwpr": "10860.00",
+ "bond_prpr": "10860.00",
+ "acml_vol": "46"
+ },
+ {
+ "stck_bsop_date": "20240529",
+ "bond_oprc": "10873.00",
+ "bond_hgpr": "10873.00",
+ "bond_lwpr": "10873.00",
+ "bond_prpr": "10873.00",
+ "acml_vol": "3"
+ },
+ {
+ "stck_bsop_date": "20240528",
+ "bond_oprc": "8540.00",
+ "bond_hgpr": "10700.00",
+ "bond_lwpr": "8540.00",
+ "bond_prpr": "10700.00",
+ "acml_vol": "49"
+ },
+ {
+ "stck_bsop_date": "20240520",
+ "bond_oprc": "10867.70",
+ "bond_hgpr": "10867.70",
+ "bond_lwpr": "10867.70",
+ "bond_prpr": "10867.70",
+ "acml_vol": "14"
+ },
+ {
+ "stck_bsop_date": "20240517",
+ "bond_oprc": "10850.40",
+ "bond_hgpr": "10850.40",
+ "bond_lwpr": "10850.40",
+ "bond_prpr": "10850.40",
+ "acml_vol": "1015"
+ },
+ {
+ "stck_bsop_date": "20240514",
+ "bond_oprc": "10861.80",
+ "bond_hgpr": "10863.50",
+ "bond_lwpr": "10861.80",
+ "bond_prpr": "10863.50",
+ "acml_vol": "17549"
+ },
+ {
+ "stck_bsop_date": "20240513",
+ "bond_oprc": "10844.30",
+ "bond_hgpr": "10861.10",
+ "bond_lwpr": "10844.30",
+ "bond_prpr": "10861.10",
+ "acml_vol": "1963"
+ },
+ {
+ "stck_bsop_date": "20240510",
+ "bond_oprc": "10858.00",
+ "bond_hgpr": "10858.00",
+ "bond_lwpr": "10858.00",
+ "bond_prpr": "10858.00",
+ "acml_vol": "12"
+ },
+ {
+ "stck_bsop_date": "20240509",
+ "bond_oprc": "10857.00",
+ "bond_hgpr": "10857.00",
+ "bond_lwpr": "10857.00",
+ "bond_prpr": "10857.00",
+ "acml_vol": "2"
+ },
+ {
+ "stck_bsop_date": "20240508",
+ "bond_oprc": "10856.20",
+ "bond_hgpr": "10856.20",
+ "bond_lwpr": "10856.20",
+ "bond_prpr": "10856.20",
+ "acml_vol": "11"
+ },
+ {
+ "stck_bsop_date": "20240424",
+ "bond_oprc": "10820.70",
+ "bond_hgpr": "10820.70",
+ "bond_lwpr": "10820.70",
+ "bond_prpr": "10820.70",
+ "acml_vol": "931"
+ },
+ {
+ "stck_bsop_date": "20240423",
+ "bond_oprc": "10818.60",
+ "bond_hgpr": "10819.00",
+ "bond_lwpr": "10818.60",
+ "bond_prpr": "10819.00",
+ "acml_vol": "3708"
+ },
+ {
+ "stck_bsop_date": "20240422",
+ "bond_oprc": "10817.60",
+ "bond_hgpr": "10823.00",
+ "bond_lwpr": "10817.60",
+ "bond_prpr": "10823.00",
+ "acml_vol": "13959"
+ },
+ {
+ "stck_bsop_date": "20240308",
+ "bond_oprc": "10756.00",
+ "bond_hgpr": "10788.00",
+ "bond_lwpr": "10756.00",
+ "bond_prpr": "10788.00",
+ "acml_vol": "20"
+ },
+ {
+ "stck_bsop_date": "20231108",
+ "bond_oprc": "10600.00",
+ "bond_hgpr": "10600.00",
+ "bond_lwpr": "10600.00",
+ "bond_prpr": "10600.00",
+ "acml_vol": "949"
+ },
+ {
+ "stck_bsop_date": "20231018",
+ "bond_oprc": "10570.00",
+ "bond_hgpr": "10620.00",
+ "bond_lwpr": "10570.00",
+ "bond_prpr": "10620.00",
+ "acml_vol": "1890"
+ },
+ {
+ "stck_bsop_date": "20231013",
+ "bond_oprc": "10592.00",
+ "bond_hgpr": "10630.00",
+ "bond_lwpr": "10592.00",
+ "bond_prpr": "10630.00",
+ "acml_vol": "10714"
+ },
+ {
+ "stck_bsop_date": "20231012",
+ "bond_oprc": "10541.00",
+ "bond_hgpr": "10592.00",
+ "bond_lwpr": "10541.00",
+ "bond_prpr": "10592.00",
+ "acml_vol": "5691"
+ },
+ {
+ "stck_bsop_date": "20230926",
+ "bond_oprc": "10615.70",
+ "bond_hgpr": "10615.70",
+ "bond_lwpr": "10615.70",
+ "bond_prpr": "10615.70",
+ "acml_vol": "4731"
+ },
+ {
+ "stck_bsop_date": "20230914",
+ "bond_oprc": "10579.00",
+ "bond_hgpr": "10579.00",
+ "bond_lwpr": "10579.00",
+ "bond_prpr": "10579.00",
+ "acml_vol": "10"
+ },
+ {
+ "stck_bsop_date": "20230913",
+ "bond_oprc": "10501.00",
+ "bond_hgpr": "10501.00",
+ "bond_lwpr": "10501.00",
+ "bond_prpr": "10501.00",
+ "acml_vol": "9"
+ },
+ {
+ "stck_bsop_date": "20230912",
+ "bond_oprc": "10499.10",
+ "bond_hgpr": "10540.00",
+ "bond_lwpr": "10499.10",
+ "bond_prpr": "10499.10",
+ "acml_vol": "30"
+ },
+ {
+ "stck_bsop_date": "20230829",
+ "bond_oprc": "10389.00",
+ "bond_hgpr": "10389.00",
+ "bond_lwpr": "10389.00",
+ "bond_prpr": "10389.00",
+ "acml_vol": "4761"
+ },
+ {
+ "stck_bsop_date": "20230825",
+ "bond_oprc": "10550.00",
+ "bond_hgpr": "10550.00",
+ "bond_lwpr": "10550.00",
+ "bond_prpr": "10550.00",
+ "acml_vol": "12555"
+ },
+ {
+ "stck_bsop_date": "20230818",
+ "bond_oprc": "10299.20",
+ "bond_hgpr": "10299.20",
+ "bond_lwpr": "10299.20",
+ "bond_prpr": "10299.20",
+ "acml_vol": "2838"
+ },
+ {
+ "stck_bsop_date": "20230814",
+ "bond_oprc": "10350.00",
+ "bond_hgpr": "10450.00",
+ "bond_lwpr": "10350.00",
+ "bond_prpr": "10450.00",
+ "acml_vol": "2838"
+ },
+ {
+ "stck_bsop_date": "20230720",
+ "bond_oprc": "10527.00",
+ "bond_hgpr": "10527.00",
+ "bond_lwpr": "10527.00",
+ "bond_prpr": "10527.00",
+ "acml_vol": "18"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/332_국내주식-158_장내채권-평균단가조회.md b/docs/broker/kis/rest/장내채권/기본시세/332_국내주식-158_장내채권-평균단가조회.md
new file mode 100644
index 0000000..25460a8
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/332_국내주식-158_장내채권-평균단가조회.md
@@ -0,0 +1,650 @@
+# 장내채권 평균단가조회
+
+- 원본 시트명: 장내채권 평균단가조회
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-158
+- HTTP Method: GET
+- 실전 TR_ID: CTPF2005R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/avg-unit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 평균단가조회 API입니다.
+한국투자 HTS(eFriend Plus) > [7216] 채권 발행정보 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF2005R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 일자 ~ |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | ~ 일자 |
+| PDNO | 상품번호 | string | Y | 12 | 공백: 전체, 특정종목 조회시 : 종목코드 |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | Unique key(302) |
+| VRFC_KIND_CD | 검증종류코드 | string | Y | 2 | Unique key(00) |
+| CTX_AREA_NK30 | 연속조회키30 | string | Y | 30 | 공백 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| evlu_dt | 평가일자 | string | Y | 245 | |
+| pdno | 상품번호 | string | Y | 202 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 238 | |
+| prdt_name | 상품명 | string | Y | 1 | |
+| kis_unpr | 한국신용평가단가 | string | Y | 8 | |
+| kbp_unpr | 한국채권평가단가 | string | Y | 500 | |
+| nice_evlu_unpr | 한국신용정보평가단가 | string | Y | 238 | |
+| fnp_unpr | 에프앤자산평가단가 | string | Y | 202 | |
+| avg_evlu_unpr | 평균평가단가 | string | Y | 500 | |
+| kis_crdt_grad_text | 한국신용평가신용등급내용 | string | Y | 238 | |
+| kbp_crdt_grad_text | 한국채권평가신용등급내용 | string | Y | 202 | |
+| nice_crdt_grad_text | 한국신용정보신용등급내용 | string | Y | 238 | |
+| fnp_crdt_grad_text | 에프앤자산평가신용등급내용 | string | Y | 500 | |
+| chng_yn | 변경여부 | string | Y | 238 | |
+| kis_erng_rt | 한국신용평가수익율 | string | Y | 202 | |
+| kbp_erng_rt | 한국채권평가수익율 | string | Y | 238 | |
+| nice_evlu_erng_rt | 한국신용정보평가수익율 | string | Y | 500 | |
+| fnp_erng_rt | 에프앤자산평가수익율 | string | Y | 179 | |
+| avg_evlu_erng_rt | 평균평가수익율 | string | Y | 202 | |
+| kis_rf_unpr | 한국신용평가RF단가 | string | Y | 238 | |
+| kbp_rf_unpr | 한국채권평가RF단가 | string | Y | 12 | |
+| nice_evlu_rf_unpr | 한국신용정보평가RF단가 | string | Y | 60 | |
+| avg_evlu_rf_unpr | 평균평가RF단가 | string | Y | 3 | |
+| output2 | 응답상세 | object array | Y | | array |
+| evlu_dt | 평가일자 | string | Y | 19 | |
+| pdno | 상품번호 | string | Y | 1 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 8 | |
+| prdt_name | 상품명 | string | Y | 19 | |
+| kis_evlu_amt | 한국신용평가평가금액 | string | Y | 19 | |
+| kbp_evlu_amt | 한국채권평가평가금액 | string | Y | 19 | |
+| nice_evlu_amt | 한국신용정보평가금액 | string | Y | 19 | |
+| fnp_evlu_amt | 에프앤자산평가평가금액 | string | Y | 12 | |
+| avg_evlu_amt | 평균평가금액 | string | Y | 60 | |
+| chng_yn | 변경여부 | string | Y | 3 | |
+| output3 | 응답상세 | object array | Y | | array |
+| evlu_dt | 평가일자 | string | Y | 236 | |
+| pdno | 상품번호 | string | Y | 19 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 1 | |
+| prdt_name | 상품명 | string | Y | 8 | |
+| kis_crcy_cd | 한국신용평가통화코드 | string | Y | 3 | |
+| kis_evlu_unit_pric | 한국신용평가평가단위가격 | string | Y | 236 | |
+| kis_evlu_pric | 한국신용평가평가가격 | string | Y | 19 | |
+| kbp_crcy_cd | 한국채권평가통화코드 | string | Y | 3 | |
+| kbp_evlu_unit_pric | 한국채권평가평가단위가격 | string | Y | 236 | |
+| kbp_evlu_pric | 한국채권평가평가가격 | string | Y | 19 | |
+| nice_crcy_cd | 한국신용정보통화코드 | string | Y | 3 | |
+| nice_evlu_unit_pric | 한국신용정보평가단위가격 | string | Y | 236 | |
+| nice_evlu_pric | 한국신용정보평가가격 | string | Y | 19 | |
+| avg_evlu_unit_pric | 평균평가단위가격 | string | Y | 12 | |
+| avg_evlu_pric | 평균평가가격 | string | Y | 60 | |
+| chng_yn | 변경여부 | string | Y | 3 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+INQR_STRT_DT:20240101
+INQR_END_DT:20240425
+PDNO:KR2033022D33
+PRDT_TYPE_CD:302
+VRFC_KIND_CD:00
+CTX_AREA_NK30:
+CTX_AREA_FK100:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk30": "20240406!^KR2033022D33!^302 ",
+ "ctx_area_fk100": "20240101!^20240425!^KR2033022D33!^302!^00 ",
+ "output1": [
+ {
+ "evlu_dt": "20240425",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9745.69000000",
+ "kbp_unpr": "9760.39000000",
+ "nice_evlu_unpr": "9767.78000000",
+ "fnp_unpr": "9760.76",
+ "avg_evlu_unpr": "9758.65000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.87000000",
+ "kbp_erng_rt": "3.83000000",
+ "nice_evlu_erng_rt": "3.810000000",
+ "fnp_erng_rt": "3.82900000",
+ "avg_evlu_erng_rt": "3.83480",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240424",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9757.62000000",
+ "kbp_unpr": "9771.98000000",
+ "nice_evlu_unpr": "9780.14000000",
+ "fnp_unpr": "9773.46",
+ "avg_evlu_unpr": "9770.80000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.83500000",
+ "kbp_erng_rt": "3.79600000",
+ "nice_evlu_erng_rt": "3.774000000",
+ "fnp_erng_rt": "3.79200000",
+ "avg_evlu_erng_rt": "3.79930",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240423",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9764.04000000",
+ "kbp_unpr": "9778.42000000",
+ "nice_evlu_unpr": "9785.84000000",
+ "fnp_unpr": "9779.90",
+ "avg_evlu_unpr": "9777.05000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.81500000",
+ "kbp_erng_rt": "3.77600000",
+ "nice_evlu_erng_rt": "3.756000000",
+ "fnp_erng_rt": "3.77200000",
+ "avg_evlu_erng_rt": "3.77980",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240422",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9753.79000000",
+ "kbp_unpr": "9768.17000000",
+ "nice_evlu_unpr": "9777.44000000",
+ "fnp_unpr": "9769.65",
+ "avg_evlu_unpr": "9767.26000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.84000000",
+ "kbp_erng_rt": "3.80100000",
+ "nice_evlu_erng_rt": "3.776000000",
+ "fnp_erng_rt": "3.79700000",
+ "avg_evlu_erng_rt": "3.80350",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240421",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9765.77000000",
+ "kbp_unpr": "9780.18000000",
+ "nice_evlu_unpr": "9789.47000000",
+ "fnp_unpr": "9781.66",
+ "avg_evlu_unpr": "9779.27000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.80500000",
+ "kbp_erng_rt": "3.76600000",
+ "nice_evlu_erng_rt": "3.741000000",
+ "fnp_erng_rt": "3.76200000",
+ "avg_evlu_erng_rt": "3.76850",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240420",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9764.79000000",
+ "kbp_unpr": "9779.20000000",
+ "nice_evlu_unpr": "9788.50000000",
+ "fnp_unpr": "9780.69",
+ "avg_evlu_unpr": "9778.29000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.80500000",
+ "kbp_erng_rt": "3.76600000",
+ "nice_evlu_erng_rt": "3.741000000",
+ "fnp_erng_rt": "3.76200000",
+ "avg_evlu_erng_rt": "3.76850",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240419",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9763.81000000",
+ "kbp_unpr": "9778.23000000",
+ "nice_evlu_unpr": "9787.53000000",
+ "fnp_unpr": "9779.72",
+ "avg_evlu_unpr": "9777.32000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.80500000",
+ "kbp_erng_rt": "3.76600000",
+ "nice_evlu_erng_rt": "3.741000000",
+ "fnp_erng_rt": "3.76200000",
+ "avg_evlu_erng_rt": "3.76850",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240418",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9782.54000000",
+ "kbp_unpr": "9793.65000000",
+ "nice_evlu_unpr": "9805.22000000",
+ "fnp_unpr": "9798.50",
+ "avg_evlu_unpr": "9794.97000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.75200000",
+ "kbp_erng_rt": "3.72200000",
+ "nice_evlu_erng_rt": "3.691000000",
+ "fnp_erng_rt": "3.70900000",
+ "avg_evlu_erng_rt": "3.71850",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240417",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9770.02000000",
+ "kbp_unpr": "9777.77000000",
+ "nice_evlu_unpr": "9791.94000000",
+ "fnp_unpr": "9784.10",
+ "avg_evlu_unpr": "9780.95000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.78300000",
+ "kbp_erng_rt": "3.76200000",
+ "nice_evlu_erng_rt": "3.724000000",
+ "fnp_erng_rt": "3.74500000",
+ "avg_evlu_erng_rt": "3.75350",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240416",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9767.18000000",
+ "kbp_unpr": "9774.93000000",
+ "nice_evlu_unpr": "9788.73000000",
+ "fnp_unpr": "9782.02",
+ "avg_evlu_unpr": "9778.21000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.78800000",
+ "kbp_erng_rt": "3.76700000",
+ "nice_evlu_erng_rt": "3.730000000",
+ "fnp_erng_rt": "3.74800000",
+ "avg_evlu_erng_rt": "3.75830",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240415",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9778.13000000",
+ "kbp_unpr": "9787.02000000",
+ "nice_evlu_unpr": "9798.98000000",
+ "fnp_unpr": "9794.12",
+ "avg_evlu_unpr": "9789.56000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.75600000",
+ "kbp_erng_rt": "3.73200000",
+ "nice_evlu_erng_rt": "3.700000000",
+ "fnp_erng_rt": "3.71300000",
+ "avg_evlu_erng_rt": "3.72530",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240414",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9795.10000000",
+ "kbp_unpr": "9802.13000000",
+ "nice_evlu_unpr": "9812.25000000",
+ "fnp_unpr": "9808.13",
+ "avg_evlu_unpr": "9804.40000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.70800000",
+ "kbp_erng_rt": "3.68900000",
+ "nice_evlu_erng_rt": "3.662000000",
+ "fnp_erng_rt": "3.67300000",
+ "avg_evlu_erng_rt": "3.68300",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240413",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9794.13000000",
+ "kbp_unpr": "9801.18000000",
+ "nice_evlu_unpr": "9811.30000000",
+ "fnp_unpr": "9807.17",
+ "avg_evlu_unpr": "9803.44000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.70800000",
+ "kbp_erng_rt": "3.68900000",
+ "nice_evlu_erng_rt": "3.662000000",
+ "fnp_erng_rt": "3.67300000",
+ "avg_evlu_erng_rt": "3.68300",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240412",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9793.17000000",
+ "kbp_unpr": "9800.22000000",
+ "nice_evlu_unpr": "9810.35000000",
+ "fnp_unpr": "9806.22",
+ "avg_evlu_unpr": "9802.49000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.70800000",
+ "kbp_erng_rt": "3.68900000",
+ "nice_evlu_erng_rt": "3.662000000",
+ "fnp_erng_rt": "3.67300000",
+ "avg_evlu_erng_rt": "3.68300",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240411",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9764.91000000",
+ "kbp_unpr": "9773.80000000",
+ "nice_evlu_unpr": "9783.16000000",
+ "fnp_unpr": "9778.67",
+ "avg_evlu_unpr": "9775.13000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.78100000",
+ "kbp_erng_rt": "3.75700000",
+ "nice_evlu_erng_rt": "3.732000000",
+ "fnp_erng_rt": "3.74400000",
+ "avg_evlu_erng_rt": "3.75350",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240410",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9793.13000000",
+ "kbp_unpr": "9799.81000000",
+ "nice_evlu_unpr": "9809.20000000",
+ "fnp_unpr": "9804.69",
+ "avg_evlu_unpr": "9801.70000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.70300000",
+ "kbp_erng_rt": "3.68500000",
+ "nice_evlu_erng_rt": "3.660000000",
+ "fnp_erng_rt": "3.67200000",
+ "avg_evlu_erng_rt": "3.68000",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240409",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9792.17000000",
+ "kbp_unpr": "9798.85000000",
+ "nice_evlu_unpr": "9808.25000000",
+ "fnp_unpr": "9803.74",
+ "avg_evlu_unpr": "9800.75000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.70300000",
+ "kbp_erng_rt": "3.68500000",
+ "nice_evlu_erng_rt": "3.660000000",
+ "fnp_erng_rt": "3.67200000",
+ "avg_evlu_erng_rt": "3.68000",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240408",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9796.84000000",
+ "kbp_unpr": "9802.41000000",
+ "nice_evlu_unpr": "9812.94000000",
+ "fnp_unpr": "9806.92",
+ "avg_evlu_unpr": "9804.77000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.68800000",
+ "kbp_erng_rt": "3.67300000",
+ "nice_evlu_erng_rt": "3.645000000",
+ "fnp_erng_rt": "3.66100000",
+ "avg_evlu_erng_rt": "3.66680",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240407",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9814.71000000",
+ "kbp_unpr": "9818.40000000",
+ "nice_evlu_unpr": "9830.10000000",
+ "fnp_unpr": "9822.93",
+ "avg_evlu_unpr": "9821.53000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.63800000",
+ "kbp_erng_rt": "3.62800000",
+ "nice_evlu_erng_rt": "3.597000000",
+ "fnp_erng_rt": "3.61600000",
+ "avg_evlu_erng_rt": "3.61980",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ },
+ {
+ "evlu_dt": "20240406",
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "prdt_name": "충북지역개발채권23-03",
+ "kis_unpr": "9813.76000000",
+ "kbp_unpr": "9817.46000000",
+ "nice_evlu_unpr": "9829.16000000",
+ "fnp_unpr": "9821.99",
+ "avg_evlu_unpr": "9820.59000000",
+ "kis_crdt_grad_text": "",
+ "kbp_crdt_grad_text": "",
+ "nice_crdt_grad_text": "",
+ "fnp_crdt_grad_text": "",
+ "chng_yn": "N",
+ "kis_erng_rt": "3.63800000",
+ "kbp_erng_rt": "3.62800000",
+ "nice_evlu_erng_rt": "3.597000000",
+ "fnp_erng_rt": "3.61600000",
+ "avg_evlu_erng_rt": "3.61980",
+ "kis_rf_unpr": "0.00",
+ "kbp_rf_unpr": "0.00",
+ "nice_evlu_rf_unpr": "0.00",
+ "avg_evlu_rf_unpr": "0.00"
+ }
+ ],
+ "output2": [],
+ "output3": [],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0500",
+ "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오. "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/333_국내주식-156_장내채권-발행정보.md b/docs/broker/kis/rest/장내채권/기본시세/333_국내주식-156_장내채권-발행정보.md
new file mode 100644
index 0000000..2217785
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/333_국내주식-156_장내채권-발행정보.md
@@ -0,0 +1,256 @@
+# 장내채권 발행정보
+
+- 원본 시트명: 장내채권 발행정보
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-156
+- HTTP Method: GET
+- 실전 TR_ID: CTPF1101R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/issue-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 발행정보 API입니다.
+한국투자 HTS(eFriend Plus) > [7216] 채권 발행정보 화면의 상단 채권정보 데이터를 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF1101R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PDNO | 사용자권한정보 | string | Y | 12 | 채권 종목번호(ex. KR6449111CB8) |
+| PRDT_TYPE_CD | 거래소코드 | string | Y | 3 | Unique key(302) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_eng_name | 상품영문명 | string | Y | 60 | |
+| ivst_heed_prdt_yn | 투자유의상품여부 | string | Y | 1 | |
+| exts_yn | 연장여부 | string | Y | 1 | |
+| bond_clsf_cd | 채권분류코드 | string | Y | 6 | |
+| bond_clsf_kor_name | 채권분류한글명 | string | Y | 60 | |
+| papr | 액면가 | string | Y | 19 | |
+| int_mned_dvsn_cd | 이자월말구분코드 | string | Y | 1 | |
+| rvnu_shap_cd | 매출형태코드 | string | Y | 1 | |
+| issu_amt | 발행금액 | string | Y | 19 | |
+| lstg_rmnd | 상장잔액 | string | Y | 19 | |
+| int_dfrm_mcnt | 이자지급개월수 | string | Y | 6 | |
+| bond_int_dfrm_mthd_cd | 채권이자지급방법코드 | string | Y | 2 | |
+| splt_rdpt_rcnt | 분할상환횟수 | string | Y | 6 | |
+| prca_dfmt_term_mcnt | 원금거치기간개월수 | string | Y | 6 | |
+| int_anap_dvsn_cd | 이자선후급구분코드 | string | Y | 1 | |
+| bond_rght_dvsn_cd | 채권권리구분코드 | string | Y | 2 | |
+| prdt_pclc_text | 상품특성내용 | string | Y | 500 | |
+| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
+| prdt_eng_abrv_name | 상품영문약어명 | string | Y | 60 | |
+| sprx_psbl_yn | 분리과세가능여부 | string | Y | 1 | |
+| pbff_pplc_ofrg_mthd_cd | 공모사모모집방법코드 | string | Y | 2 | |
+| cmco_cd | 주간사코드 | string | Y | 4 | |
+| issu_istt_cd | 발행기관코드 | string | Y | 5 | |
+| issu_istt_name | 발행기관명 | string | Y | 60 | |
+| pnia_dfrm_agcy_istt_cd | 원리금지급대행기관코드 | string | Y | 4 | |
+| dsct_ec_rt | 할인할증율 | string | Y | 238 | |
+| srfc_inrt | 표면이율 | string | Y | 238 | |
+| expd_rdpt_rt | 만기상환율 | string | Y | 238 | |
+| expd_asrc_erng_rt | 만기보장수익율 | string | Y | 238 | |
+| bond_grte_istt_name | 채권보증기관명 | string | Y | 60 | |
+| int_dfrm_day_type_cd | 이자지급일유형코드 | string | Y | 2 | |
+| ksd_int_calc_unit_cd | 증권예탁결제원이자계산단위코드 | string | Y | 1 | |
+| int_wunt_uder_prcs_dvsn_cd | 이자원화단위미만처리구분코드 | string | Y | 1 | |
+| rvnu_dt | 매출일자 | string | Y | 8 | |
+| issu_dt | 발행일자 | string | Y | 8 | |
+| lstg_dt | 상장일자 | string | Y | 8 | |
+| expd_dt | 만기일자 | string | Y | 8 | |
+| rdpt_dt | 상환일자 | string | Y | 8 | |
+| sbst_pric | 대용가격 | string | Y | 19 | |
+| rgbf_int_dfrm_dt | 직전이자지급일자 | string | Y | 8 | |
+| nxtm_int_dfrm_dt | 차기이자지급일자 | string | Y | 8 | |
+| frst_int_dfrm_dt | 최초이자지급일자 | string | Y | 8 | |
+| ecis_pric | 행사가격 | string | Y | 19 | |
+| rght_stck_std_pdno | 권리주식표준상품번호 | string | Y | 12 | |
+| ecis_opng_dt | 행사개시일자 | string | Y | 8 | |
+| ecis_end_dt | 행사종료일자 | string | Y | 8 | |
+| bond_rvnu_mthd_cd | 채권매출방법코드 | string | Y | 2 | |
+| oprt_stfno | 조작직원번호 | string | Y | 6 | |
+| oprt_stff_name | 조작직원명 | string | Y | 60 | |
+| rgbf_int_dfrm_wday | 직전이자지급요일 | string | Y | 2 | |
+| nxtm_int_dfrm_wday | 차기이자지급요일 | string | Y | 2 | |
+| kis_crdt_grad_text | 한국신용평가신용등급내용 | string | Y | 500 | |
+| kbp_crdt_grad_text | 한국채권평가신용등급내용 | string | Y | 500 | |
+| nice_crdt_grad_text | 한국신용정보신용등급내용 | string | Y | 500 | |
+| fnp_crdt_grad_text | 에프앤자산평가신용등급내용 | string | Y | 500 | |
+| dpsi_psbl_yn | 예탁가능여부 | string | Y | 1 | |
+| pnia_int_calc_unpr | 원리금이자계산단가 | string | Y | 234 | |
+| prcm_idx_bond_yn | 물가지수채권여부 | string | Y | 1 | |
+| expd_exts_srdp_rcnt | 만기연장분할상환횟수 | string | Y | 10 | |
+| expd_exts_srdp_rt | 만기연장분할상환율 | string | Y | 2212 | |
+| loan_psbl_yn | 대출가능여부 | string | Y | 1 | |
+| grte_dvsn_cd | 보증구분코드 | string | Y | 1 | |
+| fnrr_rank_dvsn_cd | 선후순위구분코드 | string | Y | 1 | |
+| krx_lstg_abol_dvsn_cd | 한국거래소상장폐지구분코드 | string | Y | 1 | |
+| asst_rqdi_dvsn_cd | 자산유동화구분코드 | string | Y | 2 | |
+| opcb_dvsn_cd | 옵션부사채구분코드 | string | Y | 1 | |
+| crfd_item_yn | 크라우드펀딩종목여부 | string | Y | 1 | |
+| crfd_item_rstc_cclc_dt | 크라우드펀딩종목제한해지일자 | string | Y | 8 | |
+| bond_nmpr_unit_pric | 채권호가단위가격 | string | Y | 202 | |
+| ivst_heed_bond_dvsn_name | 투자유의채권구분명 | string | Y | 60 | |
+| add_erng_rt | 추가수익율 | string | Y | 238 | |
+| add_erng_rt_aply_dt | 추가수익율적용일자 | string | Y | 8 | |
+| bond_tr_stop_dvsn_cd | 채권거래정지구분코드 | string | Y | 1 | |
+| ivst_heed_bond_dvsn_cd | 투자유의채권구분코드 | string | Y | 1 | |
+| pclr_cndt_text | 특이조건내용 | string | Y | 500 | |
+| hbbd_yn | 하이브리드채권여부 | string | Y | 1 | |
+| cdtl_cptl_scty_type_cd | 조건부자본증권유형코드 | string | Y | 1 | |
+| elec_scty_yn | 전자증권여부 | string | Y | 1 | |
+| sq1_clop_ecis_opng_dt | 1차콜옵션행사개시일자 | string | Y | 8 | |
+| frst_erlm_stfno | 최초등록직원번호 | string | Y | 6 | |
+| frst_erlm_dt | 최초등록일자 | string | Y | 8 | |
+| frst_erlm_tmd | 최초등록시각 | string | Y | 6 | |
+| tlg_rcvg_dtl_dtime | 전문수신상세일시 | string | Y | 17 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+PDNO:KR6449111CB8
+PRDT_TYPE_CD:302
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "pdno": "KR6449111CB8",
+ "prdt_type_cd": "302",
+ "prdt_name": "2022기보제일차유동화전문1-1(사)",
+ "prdt_eng_name": "2022 KIBO 1st Securitization Specialty1-1(S)",
+ "ivst_heed_prdt_yn": "N",
+ "exts_yn": "N",
+ "bond_clsf_cd": "116100",
+ "bond_clsf_kor_name": "일반사채",
+ "papr": "10000",
+ "int_mned_dvsn_cd": "1",
+ "rvnu_shap_cd": "2",
+ "issu_amt": "77839700000",
+ "lstg_rmnd": "77839700000",
+ "int_dfrm_mcnt": "3",
+ "bond_int_dfrm_mthd_cd": "03",
+ "splt_rdpt_rcnt": "0",
+ "prca_dfmt_term_mcnt": "0",
+ "int_anap_dvsn_cd": "2",
+ "bond_rght_dvsn_cd": "",
+ "prdt_pclc_text": "",
+ "prdt_abrv_name": "2022기보제일차유1-1(사)",
+ "prdt_eng_abrv_name": "2022 KIBO 1st SEC1-1(S)",
+ "sprx_psbl_yn": "N",
+ "pbff_pplc_ofrg_mthd_cd": "01",
+ "cmco_cd": "2117",
+ "issu_istt_cd": "44911",
+ "issu_istt_name": "2022기보제일차유동화전문 유한회사",
+ "pnia_dfrm_agcy_istt_cd": "1105",
+ "dsct_ec_rt": "0.000000",
+ "srfc_inrt": "5.931000",
+ "expd_rdpt_rt": "0.000000",
+ "expd_asrc_erng_rt": "0.000000",
+ "bond_grte_istt_name": "2022기보제일차유동화전문 유한회사",
+ "int_dfrm_day_type_cd": "01",
+ "ksd_int_calc_unit_cd": "1",
+ "int_wunt_uder_prcs_dvsn_cd": "1",
+ "rvnu_dt": "",
+ "issu_dt": "20221116",
+ "lstg_dt": "20221116",
+ "expd_dt": "20241116",
+ "rdpt_dt": "20241116",
+ "sbst_pric": "8900",
+ "rgbf_int_dfrm_dt": "20240516",
+ "nxtm_int_dfrm_dt": "20240816",
+ "frst_int_dfrm_dt": "",
+ "ecis_pric": "0",
+ "rght_stck_std_pdno": "",
+ "ecis_opng_dt": "",
+ "ecis_end_dt": "",
+ "bond_rvnu_mthd_cd": "",
+ "oprt_stfno": "BATCH",
+ "oprt_stff_name": "",
+ "rgbf_int_dfrm_wday": "05",
+ "nxtm_int_dfrm_wday": "06",
+ "kis_crdt_grad_text": "AAA",
+ "kbp_crdt_grad_text": "AAA",
+ "nice_crdt_grad_text": "AAA",
+ "fnp_crdt_grad_text": "AAA",
+ "dpsi_psbl_yn": "Y",
+ "pnia_int_calc_unpr": "0",
+ "prcm_idx_bond_yn": "N",
+ "expd_exts_srdp_rcnt": "0",
+ "expd_exts_srdp_rt": "0",
+ "loan_psbl_yn": "N",
+ "grte_dvsn_cd": "4",
+ "fnrr_rank_dvsn_cd": "1",
+ "krx_lstg_abol_dvsn_cd": "Y",
+ "asst_rqdi_dvsn_cd": "11",
+ "opcb_dvsn_cd": "",
+ "crfd_item_yn": "N",
+ "crfd_item_rstc_cclc_dt": "",
+ "bond_nmpr_unit_pric": "0.100000",
+ "ivst_heed_bond_dvsn_name": "",
+ "add_erng_rt": "0.000000",
+ "add_erng_rt_aply_dt": "",
+ "bond_tr_stop_dvsn_cd": "N",
+ "ivst_heed_bond_dvsn_cd": "0",
+ "pclr_cndt_text": "",
+ "hbbd_yn": "N",
+ "cdtl_cptl_scty_type_cd": "",
+ "elec_scty_yn": "Y",
+ "sq1_clop_ecis_opng_dt": "",
+ "frst_erlm_stfno": "",
+ "frst_erlm_dt": "",
+ "frst_erlm_tmd": ""
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/기본시세/334_국내주식-129_장내채권-기본조회.md b/docs/broker/kis/rest/장내채권/기본시세/334_국내주식-129_장내채권-기본조회.md
new file mode 100644
index 0000000..4562a79
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/기본시세/334_국내주식-129_장내채권-기본조회.md
@@ -0,0 +1,247 @@
+# 장내채권 기본조회
+
+- 원본 시트명: 장내채권 기본조회
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 기본시세
+- API ID: 국내주식-129
+- HTTP Method: GET
+- 실전 TR_ID: CTPF1114R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/quotations/search-bond-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 기본조회 API입니다.
+장내채권의 상품정보를 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF1114R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PDNO | 상품번호 | string | Y | 12 | 상품번호 |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | Unique key(302) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| ksd_bond_item_name | 증권예탁결제원채권종목명 | string | Y | 100 | |
+| ksd_bond_item_eng_name | 증권예탁결제원채권종목영문명 | string | Y | 100 | |
+| ksd_bond_lstg_type_cd | 증권예탁결제원채권상장유형코드 | string | Y | 2 | |
+| ksd_ofrg_dvsn_cd | 증권예탁결제원모집구분코드 | string | Y | 2 | |
+| ksd_bond_int_dfrm_dvsn_cd | 증권예탁결제원채권이자지급구분 | string | Y | 1 | |
+| issu_dt | 발행일자 | string | Y | 8 | |
+| rdpt_dt | 상환일자 | string | Y | 8 | |
+| rvnu_dt | 매출일자 | string | Y | 8 | |
+| iso_crcy_cd | 통화코드 | string | Y | 3 | |
+| mdwy_rdpt_dt | 중도상환일자 | string | Y | 8 | |
+| ksd_rcvg_bond_dsct_rt | 증권예탁결제원수신채권할인율 | string | Y | 2212 | |
+| ksd_rcvg_bond_srfc_inrt | 증권예탁결제원수신채권표면이율 | string | Y | 2012 | |
+| bond_expd_rdpt_rt | 채권만기상환율 | string | Y | 2212 | |
+| ksd_prca_rdpt_mthd_cd | 증권예탁결제원원금상환방법코드 | string | Y | 2 | |
+| int_caltm_mcnt | 이자계산기간개월수 | string | Y | 10 | |
+| ksd_int_calc_unit_cd | 증권예탁결제원이자계산단위코드 | string | Y | 1 | 1.발행금액
2.만원
3.십만원
4.백만원 |
+| uval_cut_dvsn_cd | 절상절사구분코드 | string | Y | 1 | |
+| uval_cut_dcpt_dgit | 절상절사소수점자릿수 | string | Y | 10 | |
+| ksd_dydv_caltm_aply_dvsn_cd | 증권예탁결제원일할계산기간적용 | string | Y | 1 | |
+| dydv_calc_dcnt | 일할계산일수 | string | Y | 5 | |
+| bond_expd_asrc_erng_rt | 채권만기보장수익율 | string | Y | 2212 | |
+| padf_plac_hdof_name | 원리금지급장소본점명 | string | Y | 60 | |
+| lstg_dt | 상장일자 | string | Y | 8 | |
+| lstg_abol_dt | 상장폐지일자 | string | Y | 8 | |
+| ksd_bond_issu_mthd_cd | 증권예탁결제원채권발행방법코드 | string | Y | 1 | |
+| laps_indf_yn | 경과이자지급여부 | string | Y | 1 | |
+| ksd_lhdy_pnia_dfrm_mthd_cd | 증권예탁결제원공휴일원리금지급 | string | Y | 1 | |
+| frst_int_dfrm_dt | 최초이자지급일자 | string | Y | 8 | |
+| ksd_prcm_lnkg_gvbd_yn | 증권예탁결제원물가연동국고채여 | string | Y | 1 | |
+| dpsi_end_dt | 예탁종료일자 | string | Y | 8 | |
+| dpsi_strt_dt | 예탁시작일자 | string | Y | 8 | |
+| dpsi_psbl_yn | 예탁가능여부 | string | Y | 1 | |
+| atyp_rdpt_bond_erlm_yn | 비정형상환채권등록여부 | string | Y | 1 | |
+| dshn_occr_yn | 부도발생여부 | string | Y | 1 | |
+| expd_exts_yn | 만기연장여부 | string | Y | 1 | |
+| pclr_ptcr_text | 특이사항내용 | string | Y | 500 | |
+| dpsi_psbl_excp_stat_cd | 예탁가능예외상태코드 | string | Y | 2 | |
+| expd_exts_srdp_rcnt | 만기연장분할상환횟수 | string | Y | 10 | |
+| expd_exts_srdp_rt | 만기연장분할상환율 | string | Y | 2212 | |
+| expd_rdpt_rt | 만기상환율 | string | Y | 238 | |
+| expd_asrc_erng_rt | 만기보장수익율 | string | Y | 238 | |
+| bond_int_dfrm_mthd_cd | 채권이자지급방법코드 | string | Y | 2 | 01.할인채
02.복리채
03.이표채.확정금리
04.이표채.금리연동
05.이표채.변동금리
06.단리채
07.분할채
09.복5단2
19.기타.고정금리
29.기타.변동금리 |
+| int_dfrm_day_type_cd | 이자지급일유형코드 | string | Y | 2 | 01.발행일
02.만기일
03.특정일 |
+| prca_dfmt_term_mcnt | 원금거치기간개월수 | string | Y | 6 | |
+| splt_rdpt_rcnt | 분할상환횟수 | string | Y | 6 | |
+| rgbf_int_dfrm_dt | 직전이자지급일자 | string | Y | 8 | |
+| nxtm_int_dfrm_dt | 차기이자지급일자 | string | Y | 8 | |
+| sprx_psbl_yn | 분리과세가능여부 | string | Y | 1 | |
+| ictx_rt_dvsn_cd | 소득세율구분코드 | string | Y | 2 | |
+| bond_clsf_cd | 채권분류코드 | string | Y | 6 | |
+| bond_clsf_kor_name | 채권분류한글명 | string | Y | 60 | |
+| int_mned_dvsn_cd | 이자월말구분코드 | string | Y | 1 | 1.일자기준
2.말일기준 |
+| pnia_int_calc_unpr | 원리금이자계산단가 | string | Y | 234 | |
+| frn_intr | FRN금리 | string | Y | 1512 | |
+| aply_day_prcm_idx_lnkg_cefc | 적용일물가지수연동계수 | string | Y | 151 | |
+| ksd_expd_dydv_calc_bass_cd | 증권예탁결제원만기일할계산기준 | string | Y | 1 | |
+| expd_dydv_calc_dcnt | 만기일할계산일수 | string | Y | 7 | |
+| ksd_cbbw_dvsn_cd | 증권예탁결제원신종사채구분코드 | string | Y | 1 | |
+| crfd_item_yn | 크라우드펀딩종목여부 | string | Y | 1 | |
+| pnia_bank_ofdy_dfrm_mthd_cd | 원리금은행휴무일지급방법코드 | string | Y | 1 | |
+| qib_yn | QIB여부 | string | Y | 1 | |
+| qib_cclc_dt | QIB해지일자 | string | Y | 8 | |
+| csbd_yn | 영구채여부 | string | Y | 1 | |
+| csbd_cclc_dt | 영구채해지일자 | string | Y | 8 | |
+| ksd_opcb_yn | 증권예탁결제원옵션부사채여부 | string | Y | 1 | |
+| ksd_sodn_yn | 증권예탁결제원후순위채권여부 | string | Y | 1 | |
+| ksd_rqdi_scty_yn | 증권예탁결제원유동화증권여부 | string | Y | 1 | |
+| elec_scty_yn | 전자증권여부 | string | Y | 1 | |
+| rght_ecis_mbdy_dvsn_cd | 권리행사주체구분코드 | string | Y | 1 | |
+| int_rkng_mthd_dvsn_cd | 이자산정방법구분코드 | string | Y | 1 | |
+| ofrg_dvsn_cd | 모집구분코드 | string | Y | 2 | |
+| ksd_tot_issu_amt | 증권예탁결제원총발행금액 | string | Y | 202 | |
+| next_indf_chk_ecls_yn | 다음이자지급체크제외여부 | string | Y | 1 | |
+| ksd_bond_intr_dvsn_cd | 증권예탁결제원채권금리구분코드 | string | Y | 1 | |
+| ksd_inrt_aply_dvsn_cd | 증권예탁결제원이율적용구분코드 | string | Y | 1 | |
+| krx_issu_istt_cd | KRX발행기관코드 | string | Y | 5 | |
+| ksd_indf_frqc_uder_calc_cd | 증권예탁결제원이자지급주기미만 | string | Y | 1 | |
+| ksd_indf_frqc_uder_calc_dcnt | 증권예탁결제원이자지급주기미만 | string | Y | 4 | |
+| tlg_rcvg_dtl_dtime | 전문수신상세일시 | string | Y | 17 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+PDNO:KR2033022D33
+PRDT_TYPE_CD:302
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "pdno": "KR2033022D33",
+ "prdt_type_cd": "302",
+ "ksd_bond_item_name": "충북지역개발채권 23-03",
+ "ksd_bond_item_eng_name": "CHUNGBUK PROVINCIAL DEVELOPMENT 23-03",
+ "ksd_bond_lstg_type_cd": "11",
+ "ksd_ofrg_dvsn_cd": "11",
+ "ksd_bond_int_dfrm_dvsn_cd": "3",
+ "issu_dt": "20230331",
+ "rdpt_dt": "20280331",
+ "rvnu_dt": "20230302",
+ "iso_crcy_cd": "KRW",
+ "mdwy_rdpt_dt": "00000000",
+ "ksd_rcvg_bond_dsct_rt": "0.000000000000",
+ "ksd_rcvg_bond_srfc_inrt": "2.500000000000",
+ "bond_expd_rdpt_rt": "100.000000000000",
+ "ksd_prca_rdpt_mthd_cd": "11",
+ "int_caltm_mcnt": "12",
+ "ksd_int_calc_unit_cd": "1",
+ "uval_cut_dvsn_cd": "2",
+ "uval_cut_dcpt_dgit": "0",
+ "ksd_dydv_caltm_aply_dvsn_cd": "1",
+ "dydv_calc_dcnt": "0",
+ "bond_expd_asrc_erng_rt": "0.000000000000",
+ "padf_plac_hdof_name": "농협은행",
+ "lstg_dt": "20230302",
+ "lstg_abol_dt": "20280401",
+ "ksd_bond_issu_mthd_cd": "2",
+ "laps_indf_yn": "Y",
+ "ksd_lhdy_pnia_dfrm_mthd_cd": "2",
+ "frst_int_dfrm_dt": "00000000",
+ "ksd_prcm_lnkg_gvbd_yn": "N",
+ "dpsi_end_dt": "20280401",
+ "dpsi_strt_dt": "20230302",
+ "dpsi_psbl_yn": "Y",
+ "atyp_rdpt_bond_erlm_yn": "N",
+ "dshn_occr_yn": "N",
+ "expd_exts_yn": "N",
+ "pclr_ptcr_text": "",
+ "dpsi_psbl_excp_stat_cd": "",
+ "expd_exts_srdp_rcnt": "0",
+ "expd_exts_srdp_rt": "0.000000000000",
+ "expd_rdpt_rt": "0.00000000",
+ "expd_asrc_erng_rt": "0.00000000",
+ "bond_int_dfrm_mthd_cd": "02",
+ "int_dfrm_day_type_cd": "02",
+ "prca_dfmt_term_mcnt": "0",
+ "splt_rdpt_rcnt": "0",
+ "rgbf_int_dfrm_dt": "",
+ "nxtm_int_dfrm_dt": "20280331",
+ "sprx_psbl_yn": "N",
+ "ictx_rt_dvsn_cd": "",
+ "bond_clsf_cd": "112555",
+ "bond_clsf_kor_name": "충북지역개발채권",
+ "int_mned_dvsn_cd": "2",
+ "pnia_int_calc_unpr": "0.0000",
+ "frn_intr": "0.000000000000",
+ "aply_day_prcm_idx_lnkg_cefc": "0.0000000000",
+ "ksd_expd_dydv_calc_bass_cd": "",
+ "expd_dydv_calc_dcnt": "0",
+ "ksd_cbbw_dvsn_cd": "9",
+ "crfd_item_yn": "N",
+ "pnia_bank_ofdy_dfrm_mthd_cd": "1",
+ "qib_yn": "N",
+ "qib_cclc_dt": "00000000",
+ "csbd_yn": "N",
+ "csbd_cclc_dt": "00000000",
+ "ksd_opcb_yn": "N",
+ "ksd_sodn_yn": "N",
+ "ksd_rqdi_scty_yn": "N",
+ "elec_scty_yn": "Y",
+ "rght_ecis_mbdy_dvsn_cd": "1",
+ "int_rkng_mthd_dvsn_cd": "1",
+ "ofrg_dvsn_cd": "",
+ "ksd_tot_issu_amt": "17303560000.00",
+ "next_indf_chk_ecls_yn": "N",
+ "ksd_bond_intr_dvsn_cd": "1",
+ "ksd_inrt_aply_dvsn_cd": "1",
+ "krx_issu_istt_cd": "MB033",
+ "ksd_indf_frqc_uder_calc_cd": "1",
+ "ksd_indf_frqc_uder_calc_dcnt": "0",
+ "tlg_rcvg_dtl_dtime": "20240625060514023"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/320_국내주식-124_장내채권-매수주문.md b/docs/broker/kis/rest/장내채권/주문/계좌/320_국내주식-124_장내채권-매수주문.md
new file mode 100644
index 0000000..8ff68aa
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/320_국내주식-124_장내채권-매수주문.md
@@ -0,0 +1,108 @@
+# 장내채권 매수주문
+
+- 원본 시트명: 장내채권 매수주문
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-124
+- HTTP Method: POST
+- 실전 TR_ID: TTTC0952U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/buy
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 매수주문 API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 '채권매수' 탭의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0952U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ORD_QTY2 | 주문수량2 | string | Y | 19 | SAMT_MKET_PTCI_YN(소액시장참여여부) : N(일반시장) 입력 시 10단위 입력 |
+| BOND_ORD_UNPR | 채권주문단가 | string | Y | 182 | |
+| SAMT_MKET_PTCI_YN | 소액시장참여여부 | string | Y | 1 | N: 일반시장, Y: 소액시장 |
+| BOND_RTL_MKET_YN | 채권소매시장여부 | string | Y | 1 | Y, N |
+| IDCR_STFNO | 유치자직원번호 | string | Y | 6 | 공백 |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | Y | 12 | 공백 |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | Unique key(0) |
+| CTAC_TLNO | 연락전화번호 | string | Y | 20 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| krx_fwdg_ord_orgno | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "12345678",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "KR6095572D81",
+ "ORD_QTY2": "1",
+ "BOND_ORD_UNPR":"10000",
+ "SAMT_MKET_PTCI_YN":"N",
+ "BOND_RTL_MKET_YN":"N",
+ "IDCR_STFNO":"",
+ "MGCO_APTM_ODNO":"",
+ "ORD_SVR_DVSN_CD":"0",
+ "CTAC_TLNO":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000015401",
+ "ORD_TMD": "104258"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/321_국내주식-123_장내채권-매도주문.md b/docs/broker/kis/rest/장내채권/주문/계좌/321_국내주식-123_장내채권-매도주문.md
new file mode 100644
index 0000000..b03478b
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/321_국내주식-123_장내채권-매도주문.md
@@ -0,0 +1,116 @@
+# 장내채권 매도주문
+
+- 원본 시트명: 장내채권 매도주문
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-123
+- HTTP Method: POST
+- 실전 TR_ID: TTTC0958U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/sell
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 매도주문 API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 '채권매도' 탭의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0958U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| ORD_DVSN | 주문구분 | string | Y | 2 | '01: 종목별 (매수일자, 매수순번 공백입력)
02: 일자별 (매수순번: 0 입력)
03: 체결가별 ' |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ORD_QTY2 | 주문수량2 | string | Y | 4 | SAMT_MKET_PTCI_YN(소액시장참여여부) : N(일반시장) 입력 시 10단위 입력 |
+| BOND_ORD_UNPR | 주문단가 | string | Y | 8 | |
+| SPRX_YN | 분리과세여부 | string | Y | 1 | N: 종합과세, Y:분리과세 |
+| BUY_DT | 매수일자 | string | Y | 8 | (잔고조회 참조) |
+| BUY_SEQ | 매수순번 | string | Y | 10 | (잔고조회 참조) |
+| SAMT_MKET_PTCI_YN | 소액시장참여여부 | string | Y | 1 | N: 일반시장, Y: 소액시장 |
+| SLL_AGCO_OPPS_SLL_YN | 매도대행사반대매도여부 | string | Y | 1 | N |
+| BOND_RTL_MKET_YN | 채권소매시장여부 | string | Y | 1 | N |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | Y | 12 | 공백 |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | Unique key(0) |
+| CTAC_TLNO | 연락전화번호 | string | Y | 20 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| krx_fwdg_ord_orgno | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "12345678",
+ "ACNT_PRDT_CD": "01",
+ "ORD_DVSN":"01",
+ "PDNO":"KR6095572D81",
+ "ORD_QTY2":"1",
+ "BOND_ORD_UNPR":"10450",
+ "SPRX_YN":"N",
+ "BUY_DT":"",
+ "BUY_SEQ":"",
+ "SAMT_MKET_PTCI_YN":"N",
+ "SLL_AGCO_OPPS_SLL_YN":"N",
+ "BOND_RTL_MKET_YN":"N",
+ "MGCO_APTM_ODNO":"",
+ "ORD_SVR_DVSN_CD":"0",
+ "CTAC_TLNO":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000015402",
+ "ORD_TMD": "104347"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/322_국내주식-125_장내채권-정정취소주문.md b/docs/broker/kis/rest/장내채권/주문/계좌/322_국내주식-125_장내채권-정정취소주문.md
new file mode 100644
index 0000000..8d72bce
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/322_국내주식-125_장내채권-정정취소주문.md
@@ -0,0 +1,108 @@
+# 장내채권 정정취소주문
+
+- 원본 시트명: 장내채권 정정취소주문
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-125
+- HTTP Method: POST
+- 실전 TR_ID: TTTC0953U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/order-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 정정취소주문 API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 '채권정정/취소' 탭의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC0953U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | - |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | - |
+| PDNO | 상품번호 | string | Y | 12 | - |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | - |
+| ORD_QTY2 | 주문수량2 | string | Y | 19 | 원주문이 일반시장 주문일 시 10단위 입력 |
+| BOND_ORD_UNPR | 채권주문단가 | string | Y | 182 | - |
+| QTY_ALL_ORD_YN | 잔량전부주문여부 | string | Y | 1 | Y: 잔량전부(주문수량 입력안함), |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 01: 정정, 02: 취소 |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | Y | 12 | 공백 |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | Unique key(0) |
+| CTAC_TLNO | 연락전화번호 | string | Y | 20 | - |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| krx_fwdg_ord_orgno | 한국거래소전송주문조직번호 | string | Y | 5 | |
+| odno | 주문번호 | string | Y | 10 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "12345678",
+ "ACNT_PRDT_CD": "01",
+ "PDNO": "KR6095572D81",
+ "ORGN_ODNO": "0000015402",
+ "ORD_QTY2": "2",
+ "BOND_ORD_UNPR": "10460",
+ "QTY_ALL_ORD_YN": "Y",
+ "RVSE_CNCL_DVSN_CD": "01",
+ "MGCO_APTM_ODNO": "",
+ "ORD_SVR_DVSN_CD": "0",
+ "CTAC_TLNO": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000015403",
+ "ORD_TMD": "104448"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/323_국내주식-126_채권정정취소가능주문조회.md b/docs/broker/kis/rest/장내채권/주문/계좌/323_국내주식-126_채권정정취소가능주문조회.md
new file mode 100644
index 0000000..76221fd
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/323_국내주식-126_채권정정취소가능주문조회.md
@@ -0,0 +1,144 @@
+# 채권정정취소가능주문조회
+
+- 원본 시트명: 채권정정취소가능주문조회
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-126
+- HTTP Method: GET
+- 실전 TR_ID: CTSC8035R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/inquire-psbl-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+채권정정취소가능주문조회 API입니다.
+정정취소가능한 채권주문 목록을 확인할 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTSC8035R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| ORD_DT | 주문일자 | string | Y | 8 | |
+| ODNO | 주문번호 | string | Y | 10 | |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| odno | 주문번호 | string | Y | 10 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| rvse_cncl_dvsn_name | 정정취소구분명 | string | Y | 60 | |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| bond_ord_unpr | 채권주문단가 | string | Y | 182 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+| orgn_odno | 원주문번호 | string | Y | 10 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| ord_dvsn_cd | 주문구분코드 | string | Y | 2 | |
+| mgco_aptm_odno | 운용사지정주문번호 | string | Y | 12 | |
+| samt_mket_ptci_yn | 소액시장참여여부 | string | Y | 1 | |
+| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+ORD_DT:
+ODNO:
+CTX_AREA_FK200:
+CTX_AREA_NK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "0!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null ",
+ "ctx_area_nk200": " ",
+ "output": [
+ {
+ "odno": "0000015401",
+ "pdno": "KR6095572D81",
+ "rvse_cncl_dvsn_name": "현금매수",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10000.00",
+ "ord_tmd": "104258",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "ord_psbl_qty": "1",
+ "orgn_odno": "",
+ "sll_buy_dvsn_cd": "02",
+ "ord_dvsn_cd": "01",
+ "mgco_aptm_odno": "",
+ "samt_mket_ptci_yn": "N",
+ "prdt_abrv_name": "AJ네트웍스63-2"
+ },
+ {
+ "odno": "0000015403",
+ "pdno": "KR6095572D81",
+ "rvse_cncl_dvsn_name": "현금매도",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10460.00",
+ "ord_tmd": "104448",
+ "tot_ccld_qty": "0",
+ "tot_ccld_amt": "0",
+ "ord_psbl_qty": "1",
+ "orgn_odno": "0000015402",
+ "sll_buy_dvsn_cd": "01",
+ "ord_dvsn_cd": "01",
+ "mgco_aptm_odno": "",
+ "samt_mket_ptci_yn": "N",
+ "prdt_abrv_name": "AJ네트웍스63-2"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/324_국내주식-127_장내채권-주문체결내역.md b/docs/broker/kis/rest/장내채권/주문/계좌/324_국내주식-127_장내채권-주문체결내역.md
new file mode 100644
index 0000000..a09a1b7
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/324_국내주식-127_장내채권-주문체결내역.md
@@ -0,0 +1,411 @@
+# 장내채권 주문체결내역
+
+- 원본 시트명: 장내채권 주문체결내역
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-127
+- HTTP Method: GET
+- 실전 TR_ID: CTSC8013R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/inquire-daily-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 주문체결내역 API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 '채권주문체결' 탭의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTSC8013R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 종합계좌번호 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌상품코드 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 일자 ~ (1주일 이내) |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | ~ 일자 (조회 당일) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %(전체), 01(매도), 02(매수) |
+| SORT_SQN_DVSN | 정렬순서구분 | string | Y | 2 | 01(주문순서), 02(주문역순) |
+| PDNO | 상품번호 | string | Y | 12 | |
+| NCCS_YN | 미체결여부 | string | Y | 1 | N(전체), C(체결), Y(미체결) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | |
+| tot_ord_qty | 총주문수량 | string | Y | 10 | |
+| tot_ccld_qty_smtl | 총체결수량합계 | string | Y | 19 | |
+| tot_bond_ccld_avg_unpr | 총채권체결평균단가 | string | Y | 182 | |
+| tot_ccld_amt_smtl | 총체결금액합계 | string | Y | 19 | |
+| output2 | 응답상세 | object | Y | | array |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| odno | 주문번호 | string | Y | 10 | |
+| orgn_odno | 원주문번호 | string | Y | 10 | |
+| ord_dvsn_name | 주문구분명 | string | Y | 60 | |
+| sll_buy_dvsn_cd_name | 매도매수구분코드명 | string | Y | 60 | |
+| shtn_pdno | 단축상품번호 | string | Y | 12 | |
+| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
+| ord_qty | 주문수량 | string | Y | 10 | |
+| bond_ord_unpr | 채권주문단가 | string | Y | 182 | |
+| ord_tmd | 주문시각 | string | Y | 6 | |
+| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
+| bond_avg_unpr | 채권평균단가 | string | Y | 182 | |
+| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
+| loan_dt | 대출일자 | string | Y | 8 | |
+| buy_dt | 매수일자 | string | Y | 8 | |
+| samt_mket_ptci_yn_name | 소액시장참여여부명 | string | Y | 10 | |
+| sprx_psbl_yn_ifom | 분리과세가능여부알림 | string | Y | 60 | |
+| ord_mdia_dvsn_name | 주문매체구분명 | string | Y | 60 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| nccs_qty | 미체결수량 | string | Y | 10 | |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+INQR_STRT_DT:20240401
+INQR_END_DT:20240425
+SLL_BUY_DVSN_CD:%
+SORT_SQN_DVSN:01
+PDNO:
+NCCS_YN:N
+CTX_AREA_FK200:
+CTX_AREA_NK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk200": " !^ ",
+ "ctx_area_fk200": "null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^null!^%!^null ",
+ "output1": [
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015201",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10450.00",
+ "ord_tmd": "102033",
+ "tot_ccld_qty": "1",
+ "bond_avg_unpr": "10250.00",
+ "tot_ccld_amt": "1025",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015202",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10450.00",
+ "ord_tmd": "135029",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015203",
+ "orgn_odno": "0000015202",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "매수취소*",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "1",
+ "bond_ord_unpr": "0.00",
+ "ord_tmd": "135108",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015204",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR101501D942",
+ "prdt_abrv_name": "국민주택1종19-04",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10929.90",
+ "ord_tmd": "163441",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "1",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015205",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR103502G990",
+ "prdt_abrv_name": "국고01125-3909(19-6)",
+ "ord_qty": "1",
+ "bond_ord_unpr": "7299.00",
+ "ord_tmd": "163612",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "1",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015206",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR103502G990",
+ "prdt_abrv_name": "국고01125-3909(19-6)",
+ "ord_qty": "1",
+ "bond_ord_unpr": "7299.00",
+ "ord_tmd": "163618",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "1",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015207",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR2088012A16",
+ "prdt_abrv_name": "경남지역개발20-01",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10206.60",
+ "ord_tmd": "163922",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "1",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015208",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수",
+ "shtn_pdno": "KR2088012A16",
+ "prdt_abrv_name": "경남지역개발20-01",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10206.60",
+ "ord_tmd": "164006",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "1",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015209",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수거부",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "2",
+ "bond_ord_unpr": "10450.00",
+ "ord_tmd": "170002",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015210",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수거부",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "1",
+ "bond_ord_unpr": "10400.00",
+ "ord_tmd": "170010",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015211",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수거부",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "5",
+ "bond_ord_unpr": "10400.00",
+ "ord_tmd": "170015",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ },
+ {
+ "ord_dt": "20240425",
+ "odno": "0000015212",
+ "orgn_odno": "",
+ "ord_dvsn_name": "보통",
+ "sll_buy_dvsn_cd_name": "현금매수거부",
+ "shtn_pdno": "KR6095572D81",
+ "prdt_abrv_name": "AJ네트웍스63-2",
+ "ord_qty": "5",
+ "bond_ord_unpr": "10200.00",
+ "ord_tmd": "170019",
+ "tot_ccld_qty": "0",
+ "bond_avg_unpr": "0.00",
+ "tot_ccld_amt": "0",
+ "loan_dt": "",
+ "buy_dt": "",
+ "samt_mket_ptci_yn_name": "일반시장",
+ "sprx_psbl_yn_ifom": "종합과세",
+ "ord_mdia_dvsn_name": "33",
+ "sll_buy_dvsn_cd": "02",
+ "nccs_qty": "0",
+ "ord_gno_brno": "01790"
+ }
+ ],
+ "output2": {
+ "tot_ord_qty": "6",
+ "tot_ccld_qty_smtl": "1",
+ "tot_bond_ccld_avg_unpr": "10250.00",
+ "tot_ccld_amt_smtl": "1025"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/325_국내주식-198_장내채권-잔고조회.md b/docs/broker/kis/rest/장내채권/주문/계좌/325_국내주식-198_장내채권-잔고조회.md
new file mode 100644
index 0000000..8bf5720
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/325_국내주식-198_장내채권-잔고조회.md
@@ -0,0 +1,165 @@
+# 장내채권 잔고조회
+
+- 원본 시트명: 장내채권 잔고조회
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-198
+- HTTP Method: GET
+- 실전 TR_ID: CTSC8407R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/inquire-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 잔고조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0979] 장내채권종합주문 화면의 "왼쪽 하단 잔고" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTSC8407R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| INQR_CNDT | 조회조건 | string | Y | 2 | 00: 전체, 01: 상품번호단위 |
+| PDNO | 상품번호 | string | Y | 12 | 공백 |
+| BUY_DT | 매수일자 | string | Y | 8 | 공백 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| buy_dt | 매수일자 | string | Y | 8 | |
+| buy_sqno | 매수일련번호 | string | Y | 10 | |
+| cblc_qty | 잔고수량 | string | Y | 19 | |
+| agrx_qty | 종합과세수량 | string | Y | 10 | |
+| sprx_qty | 분리과세수량 | string | Y | 10 | |
+| exdt | 만기일 | string | Y | 8 | |
+| buy_erng_rt | 매수수익율 | string | Y | 238 | |
+| buy_unpr | 매수단가 | string | Y | 19 | |
+| buy_amt | 매수금액 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+INQR_CNDT:00
+PDNO:
+BUY_DT:
+CTX_AREA_FK200:
+CTX_AREA_NK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "!^!^null ",
+ "ctx_area_nk200": " !^ !^ ",
+ "output": [
+ {
+ "pdno": "KR101501D942",
+ "prdt_name": "국민주택1종19-04",
+ "buy_dt": "20240426",
+ "buy_sqno": "1",
+ "cblc_qty": "4",
+ "agrx_qty": "4",
+ "sprx_qty": "0",
+ "exdt": "20240430",
+ "buy_erng_rt": "0.00000000",
+ "buy_unpr": "0",
+ "buy_amt": "0",
+ "ord_psbl_qty": "4"
+ },
+ {
+ "pdno": "KR2088012A16",
+ "prdt_name": "경남지역개발20-01",
+ "buy_dt": "20240426",
+ "buy_sqno": "1",
+ "cblc_qty": "6",
+ "agrx_qty": "5",
+ "sprx_qty": "0",
+ "exdt": "20250131",
+ "buy_erng_rt": "0.00000000",
+ "buy_unpr": "0",
+ "buy_amt": "0",
+ "ord_psbl_qty": "5"
+ },
+ {
+ "pdno": "KR6003492D41",
+ "prdt_name": "대한항공102-2",
+ "buy_dt": "20240426",
+ "buy_sqno": "1",
+ "cblc_qty": "9",
+ "agrx_qty": "9",
+ "sprx_qty": "0",
+ "exdt": "20260424",
+ "buy_erng_rt": "0.00000000",
+ "buy_unpr": "0",
+ "buy_amt": "0",
+ "ord_psbl_qty": "9"
+ },
+ {
+ "pdno": "KR6095572D81",
+ "prdt_name": "AJ네트웍스63-2",
+ "buy_dt": "20240426",
+ "buy_sqno": "1",
+ "cblc_qty": "23",
+ "agrx_qty": "22",
+ "sprx_qty": "0",
+ "exdt": "20250801",
+ "buy_erng_rt": "0.00000000",
+ "buy_unpr": "0",
+ "buy_amt": "0",
+ "ord_psbl_qty": "22"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/장내채권/주문/계좌/326_국내주식-199_장내채권-매수가능조회.md b/docs/broker/kis/rest/장내채권/주문/계좌/326_국내주식-199_장내채권-매수가능조회.md
new file mode 100644
index 0000000..e8d913a
--- /dev/null
+++ b/docs/broker/kis/rest/장내채권/주문/계좌/326_국내주식-199_장내채권-매수가능조회.md
@@ -0,0 +1,106 @@
+# 장내채권 매수가능조회
+
+- 원본 시트명: 장내채권 매수가능조회
+- API 통신방식: REST
+- 메뉴 위치: [장내채권] 주문/계좌
+- API ID: 국내주식-199
+- HTTP Method: GET
+- 실전 TR_ID: TTTC8910R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-bond/v1/trading/inquire-psbl-order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+장내채권 매수가능조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0978] 장내채권주문 화면의 "왼쪽 하단 증거금 사용가능 내역 / 주문가능금액 및 수량" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ (중요) 채권의 경우 주식과 달리, 매수가능수량(buy_psbl_qty) = 매수가능금액(buy_psbl_amt) / 채권주문단가2(bond_ord_unpr2) * 10 인 점 유의하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC8910R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| PDNO | 상품번호 | string | Y | 12 | |
+| BOND_ORD_UNPR | 채권주문단가 | string | Y | 182 | |
+| SAMT_MKET_PTCI_YN | 소액시장참여여부 | string | Y | 1 | Y(소액시장) N (일반시장) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
+| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
+| ruse_psbl_amt | 재사용가능금액 | string | Y | 19 | |
+| bond_ord_unpr2 | 채권주문단가2 | string | Y | 182 | |
+| buy_psbl_amt | 매수가능금액 | string | Y | 19 | |
+| buy_psbl_qty | 매수가능수량 | string | Y | 10 | 매수가능수량(buy_psbl_qty) = 매수가능금액(buy_psbl_amt) / 채권주문단가2(bond_ord_unpr2) * 10 |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+PDNO:KR6095572D81
+BOND_ORD_UNPR:10450.0
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "ord_psbl_cash": "9285653",
+ "ord_psbl_sbst": "117521",
+ "ruse_psbl_amt": "0",
+ "bond_ord_unpr2": "10450.00",
+ "buy_psbl_amt": "9230271",
+ "buy_psbl_qty": "8832",
+ "cma_evlu_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/296_v1_해외선물-009_해외선물종목현재가.md b/docs/broker/kis/rest/해외선물옵션/기본시세/296_v1_해외선물-009_해외선물종목현재가.md
new file mode 100644
index 0000000..c54e472
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/296_v1_해외선물-009_해외선물종목현재가.md
@@ -0,0 +1,168 @@
+# 해외선물종목현재가
+
+- 원본 시트명: 해외선물종목현재가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: v1_해외선물-009
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+※ 모의투자는 실전투자계좌를 활용하여 조회 부탁드립니다.
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | N | | |
+| proc_date | 최종처리일자 | string | N | 8 | 최종처리일자 |
+| high_price | 고가 | string | N | 15 | 고가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| proc_time | 최종처리시각 | string | N | 6 | 최종처리시각 |
+| open_price | 시가 | string | N | 15 | 시가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| trst_mgn | 증거금 | string | N | 19 | 증거금 |
+| low_price | 저가 | string | N | 15 | 저가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_price | 현재가 | string | N | 15 | 현재가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| vol | 누적거래수량 | string | N | 10 | 누적거래수량 |
+| prev_diff_flag | 전일대비구분 | string | N | 1 | 전일대비구분
'1':상한 '2':상승 '3':보합 '4':하한 '5':하락 |
+| prev_diff_price | 전일대비가격 | string | N | 15 | 전일대비가격 |
+| prev_diff_rate | 전일대비율 | string | N | 10 | 전일대비율 |
+| bid_qntt | 매수1수량 | string | N | 10 | 매수1수량 |
+| bid_price | 매수1호가 | string | N | 15 | 매수1호가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| ask_qntt | 매도1수량 | string | N | 10 | 매도1수량 |
+| ask_price | 매도1호가 | string | N | 15 | 매도1호가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| prev_price | 전일종가 | string | N | 15 | 전일종가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| exch_cd | 거래소코드 | string | N | 10 | 거래소코드 |
+| crc_cd | 거래통화 | string | N | 10 | 거래통화 |
+| trd_fr_date | 상장일 | string | N | 8 | 상장일 |
+| expr_date | 만기일 | string | N | 8 | 만기일 |
+| trd_to_date | 최종거래일 | string | N | 8 | 최종거래일 |
+| remn_cnt | 잔존일수 | string | N | 4 | 잔존일수 |
+| last_qntt | 체결량 | string | N | 10 | 체결량 |
+| tot_ask_qntt | 총매도잔량 | string | N | 10 | 총매도잔량 |
+| tot_bid_qntt | 총매수잔량 | string | N | 10 | 총매수잔량 |
+| tick_size | 틱사이즈 | string | N | 19 | 틱사이즈 |
+| open_date | 장개시일자 | string | N | 8 | 장개시일자 |
+| open_time | 장개시시각 | string | N | 6 | 장개시시각 |
+| close_date | 장종료일자 | string | N | 8 | 장종료일자 |
+| close_time | 장종료시각 | string | N | 6 | 장종료시각 |
+| sbsnsdate | 영업일자 | string | N | 8 | 영업일자 |
+| sttl_price | 정산가 | string | N | 15 | 정산가 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:BRNF25
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "proc_date": "20241108",
+ "proc_time": "173937",
+ "open_price": " 75.55",
+ "high_price": " 75.61",
+ "low_price": " 74.66",
+ "last_price": " 74.90",
+ "vol": "33004",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 0.67",
+ "prev_diff_rate": " -0.89",
+ "bid_qntt": " 7",
+ "bid_price": " 74.89",
+ "ask_qntt": " 4",
+ "ask_price": " 74.90",
+ "prev_price": " 75.57",
+ "trst_mgn": " 3670",
+ "exch_cd": "ICE",
+ "crc_cd": "USD",
+ "trd_fr_date": "20180110",
+ "expr_date": "20241129",
+ "trd_to_date": "20241129",
+ "remn_cnt": " 22",
+ "last_qntt": "1",
+ "tot_ask_qntt": " 115",
+ "tot_bid_qntt": " 157",
+ "tick_size": " 0.01",
+ "open_date": "20241108",
+ "open_time": "100000",
+ "close_date": "20241109",
+ "close_time": "080000",
+ "sbsnsdate": "20241108",
+ "sttl_price": " 75.6300000000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/297_v1_해외선물-008_해외선물종목상세.md b/docs/broker/kis/rest/해외선물옵션/기본시세/297_v1_해외선물-008_해외선물종목상세.md
new file mode 100644
index 0000000..2fba7f8
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/297_v1_해외선물-008_해외선물종목상세.md
@@ -0,0 +1,147 @@
+# 해외선물종목상세
+
+- 원본 시트명: 해외선물종목상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: v1_해외선물-008
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55010100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/stock-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석.
+
+※ 모의투자는 실전투자계좌를 활용하여 조회 부탁드립니다.
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55010100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | N | | |
+| exch_cd | 거래소코드 | string | N | 10 | 거래소코드 |
+| tick_sz | 틱사이즈 | string | N | 19 | 틱사이즈 |
+| disp_digit | 가격표시진법 | string | N | 10 | 가격표시진법 |
+| trst_mgn | 증거금 | string | N | 19 | 증거금 |
+| sttl_date | 정산일 | string | N | 8 | 정산일 |
+| prev_price | 전일종가 | string | N | 15 | 전일종가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| crc_cd | 거래통화 | string | N | 10 | 거래통화 |
+| clas_cd | 품목종류 | string | N | 3 | 품목종류 |
+| tick_val | 틱가치 | string | N | 19 | 틱가치 |
+| mrkt_open_date | 장개시일자 | string | N | 8 | 장개시일자 |
+| mrkt_open_time | 장개시시각 | string | N | 6 | 장개시시각 |
+| mrkt_close_date | 장마감일자 | string | N | 8 | 장마감일자 |
+| mrkt_close_time | 장마감시각 | string | N | 6 | 장마감시각 |
+| trd_fr_date | 상장일 | string | N | 8 | 상장일 |
+| expr_date | 만기일 | string | N | 8 | 만기일 |
+| trd_to_date | 최종거래일 | string | N | 8 | 최종거래일 |
+| remn_cnt | 잔존일수 | string | N | 4 | 잔존일수 |
+| stat_tp | 매매여부 | string | N | 1 | 매매여부 |
+| ctrt_size | 계약크기 | string | N | 19 | 계약크기 |
+| stl_tp | 최종결제구분 | string | N | 20 | 최종결제구분 |
+| frst_noti_date | 최초식별일 | string | N | 8 | 최초식별일 |
+| sprd_srs_cd1 | 스프레드 종목 #1 | string | N | 32 | |
+| sprd_srs_cd2 | 스프레드 종목 #2 | string | N | 32 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "SRS_CD": "6AU22"
+ }
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "exch_cd": "CME",
+ "clas_cd": "001",
+ "crc_cd": "USD",
+ "prev_price": " 6722.0",
+ "sttl_date": "20220919",
+ "trst_mgn": " 2200",
+ "disp_digit": " 10",
+ "tick_sz": " 0.00005",
+ "tick_val": " 5",
+ "mrkt_open_date": "20220919",
+ "mrkt_open_time": "070000",
+ "mrkt_close_date": "20220920",
+ "mrkt_close_time": "060000",
+ "trd_fr_date": "20170906",
+ "expr_date": "20220919",
+ "trd_to_date": "20220919",
+ "remn_cnt": " 0",
+ "stat_tp": "2",
+ "ctrt_size": " 100000",
+ "stl_tp": "실물인수도",
+ "frst_noti_date": "20220919",
+ "sprd_srs_cd1": "",
+ "sprd_srs_cd2": ""
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/298_해외선물-031_해외선물-호가.md b/docs/broker/kis/rest/해외선물옵션/기본시세/298_해외선물-031_해외선물-호가.md
new file mode 100644
index 0000000..3c39af3
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/298_해외선물-031_해외선물-호가.md
@@ -0,0 +1,171 @@
+# 해외선물 호가
+
+- 원본 시트명: 해외선물 호가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-031
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC86000000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 호가 API입니다.
+한국투자 HTS(eFriend Plus) > [8602] 해외선물옵션 종합주문(Ⅰ) 화면에서 "왼쪽 호가 창" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드 - 해외선물옵션 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC86000000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| lowp_rice | 저가 | string | Y | 15 | |
+| last_price | 현재가 | string | Y | 15 | |
+| prev_price | 전일종가 | string | Y | 15 | |
+| vol | 거래량 | string | Y | 10 | |
+| prev_diff_price | 전일대비가 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+| quot_date | 호가수신일자 | string | Y | 8 | |
+| quot_time | 호가수신시각 | string | Y | 6 | |
+| output2 | 응답상세 | object array | Y | | array |
+| bid_qntt | 매수수량 | string | Y | 10 | |
+| bid_num | 매수번호 | string | Y | 10 | |
+| bid_price | 매수호가 | string | Y | 15 | |
+| ask_qntt | 매도수량 | string | Y | 10 | |
+| ask_num | 매도번호 | string | Y | 10 | |
+| ask_price | 매도호가 | string | Y | 15 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "open_price": " 6430.0",
+ "high_price": " 6466.5",
+ "lowp_rice": " 6425.0",
+ "last_price": " 6443.5",
+ "prev_price": " 6428.5",
+ "vol": "27383",
+ "prev_diff_price": " 15",
+ "prev_diff_rate": " 0.23",
+ "quot_date": "20240422",
+ "quot_time": "160201"
+ },
+ "output2": [
+ {
+ "bid_qntt": " 35",
+ "bid_num": " 11",
+ "bid_price": " 6443.0",
+ "ask_qntt": " 11",
+ "ask_num": " 7",
+ "ask_price": " 6443.5"
+ },
+ {
+ "bid_qntt": " 108",
+ "bid_num": " 25",
+ "bid_price": " 6442.5",
+ "ask_qntt": " 137",
+ "ask_num": " 23",
+ "ask_price": " 6444.0"
+ },
+ {
+ "bid_qntt": " 145",
+ "bid_num": " 28",
+ "bid_price": " 6442.0",
+ "ask_qntt": " 120",
+ "ask_num": " 24",
+ "ask_price": " 6444.5"
+ },
+ {
+ "bid_qntt": " 139",
+ "bid_num": " 29",
+ "bid_price": " 6441.5",
+ "ask_qntt": " 142",
+ "ask_num": " 21",
+ "ask_price": " 6445.0"
+ },
+ {
+ "bid_qntt": " 128",
+ "bid_num": " 25",
+ "bid_price": " 6441.0",
+ "ask_qntt": " 127",
+ "ask_num": " 20",
+ "ask_price": " 6445.5"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/299_해외선물-016_해외선물-분봉조회.md b/docs/broker/kis/rest/해외선물옵션/기본시세/299_해외선물-016_해외선물-분봉조회.md
new file mode 100644
index 0000000..f1d40a5
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/299_해외선물-016_해외선물-분봉조회.md
@@ -0,0 +1,332 @@
+# 해외선물 분봉조회
+
+- 원본 시트명: 해외선물 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-016
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-time-futurechartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물분봉조회 API입니다. ★ 반드시 아래 호출방법을 확인하시고 호출 사용하시기 바랍니다.
+한국투자 HTS(eFriend Plus) > [5502] 해외선물옵션 체결추이 화면에서 "분" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+
+※ 해외선물분봉조회 조회 방법
+params
+. START_DATE_TIME: 공란 입력 ("")
+. CLOSE_DATE_TIME: 조회일자 입력 ("20231214")
+. QRY_CNT: 120 입력 시, 가장 최근 분봉 120건 조회( 한번에 최대 120건 조회 가능)
+ 240 입력 시, 240 이전 분봉 ~ 120 이전 분봉 조회
+ 360 입력 시, 360 이전 분봉 ~ 240 이전 분봉 조회
+. QRY_TP: 처음조회시, 공백 입력
+ 다음조회시, P 입력
+. INDEX_KEY: 처음조회시, 공백 입력
+ 다음조회시, 이전 조회 응답의 output2 > index_key 값 입력
+
+* 따라서 분봉데이터를 기간별로 수집하고자 하실 경우 QRY_TP, INDEX_KEY 값을 이용하시면서 다음조회하시면 됩니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55020400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | ex) 20230823 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 120 (조회갯수) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 5 (분간격) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output1 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:BRNQ24
+EXCH_CD:ICE
+START_DATE_TIME:
+CLOSE_DATE_TIME:20231212
+QRY_TP:P
+QRY_CNT:500
+QRY_GAP:1
+INDEX_KEY:20231211 128
+```
+
+### Response Example
+
+```text
+{
+ "output2": {
+ "ret_cnt": "0500",
+ "last_n_cnt": "",
+ "index_key": "20231208 246"
+ },
+ "output1": [
+ {
+ "data_date": "20231208",
+ "data_time": "202100",
+ "open_price": "75.41",
+ "high_price": "75.41",
+ "low_price": "75.41",
+ "last_price": "75.41",
+ "last_qntt": "5",
+ "vol": "3985",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202200",
+ "open_price": "75.41",
+ "high_price": "75.43",
+ "low_price": "75.41",
+ "last_price": "75.43",
+ "last_qntt": "3",
+ "vol": "3988",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "0.02",
+ "prev_diff_rate": "0.02652168"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202300",
+ "open_price": "75.45",
+ "high_price": "75.45",
+ "low_price": "75.45",
+ "last_price": "75.45",
+ "last_qntt": "19",
+ "vol": "4007",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "0.02",
+ "prev_diff_rate": "0.02651464"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202400",
+ "open_price": "75.45",
+ "high_price": "75.45",
+ "low_price": "75.45",
+ "last_price": "75.45",
+ "last_qntt": "2",
+ "vol": "4009",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202600",
+ "open_price": "75.45",
+ "high_price": "75.47",
+ "low_price": "75.45",
+ "last_price": "75.47",
+ "last_qntt": "4",
+ "vol": "4013",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "0.02",
+ "prev_diff_rate": "0.02650762"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202700",
+ "open_price": "75.49",
+ "high_price": "75.49",
+ "low_price": "75.48",
+ "last_price": "75.48",
+ "last_qntt": "3",
+ "vol": "4016",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "0.01",
+ "prev_diff_rate": "0.01325029"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "202800",
+ "open_price": "75.45",
+ "high_price": "75.46",
+ "low_price": "75.45",
+ "last_price": "75.46",
+ "last_qntt": "3",
+ "vol": "4019",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "0.02",
+ "prev_diff_rate": "-0.0264970"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "203100",
+ "open_price": "75.46",
+ "high_price": "75.46",
+ "low_price": "75.46",
+ "last_price": "75.46",
+ "last_qntt": "1",
+ "vol": "4020",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "203300",
+ "open_price": "75.43",
+ "high_price": "75.43",
+ "low_price": "75.43",
+ "last_price": "75.43",
+ "last_qntt": "1",
+ "vol": "4021",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "0.03",
+ "prev_diff_rate": "-0.0397561"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "203400",
+ "open_price": "75.41",
+ "high_price": "75.41",
+ "low_price": "75.4",
+ "last_price": "75.4",
+ "last_qntt": "6",
+ "vol": "4027",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "0.03",
+ "prev_diff_rate": "-0.0397719"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "203500",
+ "open_price": "75.41",
+ "high_price": "75.41",
+ "low_price": "75.41",
+ "last_price": "75.41",
+ "last_qntt": "2",
+ "vol": "4029",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "0.01",
+ "prev_diff_rate": "0.01326259"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "203700",
+ "open_price": "75.43",
+ "high_price": "75.43",
+ "low_price": "75.41",
+ "last_price": "75.41",
+ "last_qntt": "30",
+ "vol": "4060",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "204000",
+ "open_price": "75.41",
+ "high_price": "75.41",
+ "low_price": "75.41",
+ "last_price": "75.41",
+ "last_qntt": "54",
+ "vol": "4113",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0"
+ },
+ {
+ "data_date": "20231208",
+ "data_time": "204200",
+ "open_price": "75.37",
+ "high_price": "75.38",
+ "low_price": "75.37",
+ "last_price": "75.38",
+ "last_qntt": "2",
+ "vol": "4118",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "0.03",
+ "prev_diff_rate": "-0.0397825"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/300_해외선물-019_해외선물-체결추이틱.md b/docs/broker/kis/rest/해외선물옵션/기본시세/300_해외선물-019_해외선물-체결추이틱.md
new file mode 100644
index 0000000..30c7239
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/300_해외선물-019_해외선물-체결추이틱.md
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(틱)
+
+- 원본 시트명: 해외선물 체결추이(틱)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-019
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/tick-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(틱) API입니다.
+한국투자 HTS(eFriend Plus) > [5502] 해외선물옵션 체결추이 화면에서 "Tick" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55020200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| tret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240423
+QRY_TP:Q
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0040",
+ "last_n_cnt": "0001",
+ "index_key": "20240423 6445"
+ },
+ "output2": [
+ {
+ "data_date": "20240423",
+ "data_time": "164434",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 4",
+ "vol": "27806",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164434",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "27807",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164450",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 5",
+ "vol": "27812",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164501",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 2",
+ "vol": "27814",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164503",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 9",
+ "vol": "27823",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164503",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "27824",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164507",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "27825",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164517",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "27826",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164517",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 2",
+ "vol": "27828",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164526",
+ "open_price": " 6465",
+ "high_price": " 6465",
+ "low_price": " 6465",
+ "last_price": " 6465",
+ "last_qntt": " 2",
+ "vol": "27830",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 5",
+ "prev_diff_rate": " 0.08"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164542",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "27831",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164551",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 1",
+ "vol": "27832",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164555",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 1",
+ "vol": "27833",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164611",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 1",
+ "vol": "27834",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164613",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 1",
+ "vol": "27835",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164620",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 2",
+ "vol": "27837",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164620",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 1",
+ "vol": "27838",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164634",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 10",
+ "vol": "27848",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164634",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 1",
+ "vol": "27849",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164634",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 1",
+ "vol": "27850",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164634",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 25",
+ "vol": "27875",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164634",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 5",
+ "vol": "27880",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164650",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 2",
+ "vol": "27882",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164658",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 400",
+ "vol": "28282",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164658",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 3",
+ "vol": "28285",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164707",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 2",
+ "vol": "28287",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164714",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 1",
+ "vol": "28288",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164714",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 2",
+ "vol": "28290",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164715",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 4",
+ "vol": "28294",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164716",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 315",
+ "vol": "28609",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164735",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 2",
+ "vol": "28611",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164735",
+ "open_price": " 6464.5",
+ "high_price": " 6464.5",
+ "low_price": " 6464.5",
+ "last_price": " 6464.5",
+ "last_qntt": " 3",
+ "vol": "28614",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4.5",
+ "prev_diff_rate": " 0.07"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164817",
+ "open_price": " 6464",
+ "high_price": " 6464",
+ "low_price": " 6464",
+ "last_price": " 6464",
+ "last_qntt": " 7",
+ "vol": "28621",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164828",
+ "open_price": " 6463.5",
+ "high_price": " 6463.5",
+ "low_price": " 6463.5",
+ "last_price": " 6463.5",
+ "last_qntt": " 2",
+ "vol": "28623",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164837",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 1",
+ "vol": "28624",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164838",
+ "open_price": " 6463",
+ "high_price": " 6463",
+ "low_price": " 6463",
+ "last_price": " 6463",
+ "last_qntt": " 1",
+ "vol": "28625",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 3",
+ "prev_diff_rate": " 0.05"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164856",
+ "open_price": " 6462.5",
+ "high_price": " 6462.5",
+ "low_price": " 6462.5",
+ "last_price": " 6462.5",
+ "last_qntt": " 2",
+ "vol": "28627",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 2.5",
+ "prev_diff_rate": " 0.04"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164856",
+ "open_price": " 6462.5",
+ "high_price": " 6462.5",
+ "low_price": " 6462.5",
+ "last_price": " 6462.5",
+ "last_qntt": " 5",
+ "vol": "28632",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 2.5",
+ "prev_diff_rate": " 0.04"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164856",
+ "open_price": " 6462.5",
+ "high_price": " 6462.5",
+ "low_price": " 6462.5",
+ "last_price": " 6462.5",
+ "last_qntt": " 10",
+ "vol": "28642",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 2.5",
+ "prev_diff_rate": " 0.04"
+ },
+ {
+ "data_date": "20240423",
+ "data_time": "164856",
+ "open_price": " 6462.5",
+ "high_price": " 6462.5",
+ "low_price": " 6462.5",
+ "last_price": " 6462.5",
+ "last_qntt": " 2",
+ "vol": "28644",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 2.5",
+ "prev_diff_rate": " 0.04"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/301_해외선물-017_해외선물-체결추이주간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/301_해외선물-017_해외선물-체결추이주간.md
new file mode 100644
index 0000000..606c93f
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/301_해외선물-017_해외선물-체결추이주간.md
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(주간)
+
+- 원본 시트명: 해외선물 체결추이(주간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-017
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/weekly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(주간) API입니다.
+한국투자 HTS(eFriend Plus) > [5502] 해외선물옵션 체결추이 화면에서 "주간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55020000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240424
+QRY_TP:
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0040",
+ "last_n_cnt": "",
+ "index_key": "20230522"
+ },
+ "output2": [
+ {
+ "data_date": "20230522",
+ "data_time": "",
+ "open_price": " 6713.0",
+ "high_price": " 6713.0",
+ "low_price": " 6620.0",
+ "last_price": " 6620.0",
+ "last_qntt": "",
+ "vol": " 10",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 93",
+ "prev_diff_rate": " -1.39"
+ },
+ {
+ "data_date": "20230612",
+ "data_time": "",
+ "open_price": " 6809.5",
+ "high_price": " 6817.0",
+ "low_price": " 6809.0",
+ "last_price": " 6817.0",
+ "last_qntt": "",
+ "vol": " 20",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 197",
+ "prev_diff_rate": " 2.98"
+ },
+ {
+ "data_date": "20230626",
+ "data_time": "",
+ "open_price": " 6692.0",
+ "high_price": " 6692.0",
+ "low_price": " 6692.0",
+ "last_price": " 6692.0",
+ "last_qntt": "",
+ "vol": "5 ",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 125",
+ "prev_diff_rate": " -1.83"
+ },
+ {
+ "data_date": "20230710",
+ "data_time": "",
+ "open_price": " 6840.5",
+ "high_price": " 6840.5",
+ "low_price": " 6840.0",
+ "last_price": " 6840.0",
+ "last_qntt": "",
+ "vol": "5 ",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 148",
+ "prev_diff_rate": " 2.21"
+ },
+ {
+ "data_date": "20230731",
+ "data_time": "",
+ "open_price": " 6702.0",
+ "high_price": " 6702.0",
+ "low_price": " 6605.0",
+ "last_price": " 6605.0",
+ "last_qntt": "",
+ "vol": " 11",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 235",
+ "prev_diff_rate": " -3.44"
+ },
+ {
+ "data_date": "20230807",
+ "data_time": "",
+ "open_price": " 6594.5",
+ "high_price": " 6594.5",
+ "low_price": " 6594.5",
+ "last_price": " 6594.5",
+ "last_qntt": "",
+ "vol": "5 ",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 10.5",
+ "prev_diff_rate": " -0.16"
+ },
+ {
+ "data_date": "20230904",
+ "data_time": "",
+ "open_price": " 6535.0",
+ "high_price": " 6535.0",
+ "low_price": " 6535.0",
+ "last_price": " 6535.0",
+ "last_qntt": "",
+ "vol": "1 ",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 59.5",
+ "prev_diff_rate": " -0.90"
+ },
+ {
+ "data_date": "20230911",
+ "data_time": "",
+ "open_price": " 6494.0",
+ "high_price": " 6512.5",
+ "low_price": " 6470.0",
+ "last_price": " 6512.5",
+ "last_qntt": "",
+ "vol": " 8",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 22.5",
+ "prev_diff_rate": " -0.34"
+ },
+ {
+ "data_date": "20230918",
+ "data_time": "",
+ "open_price": " 6500.5",
+ "high_price": " 6558.5",
+ "low_price": " 6459.5",
+ "last_price": " 6479.5",
+ "last_qntt": "",
+ "vol": " 43",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 33",
+ "prev_diff_rate": " -0.51"
+ },
+ {
+ "data_date": "20230925",
+ "data_time": "",
+ "open_price": " 6439.5",
+ "high_price": " 6450.5",
+ "low_price": " 6430.0",
+ "last_price": " 6450.5",
+ "last_qntt": "",
+ "vol": " 3",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 29",
+ "prev_diff_rate": " -0.45"
+ },
+ {
+ "data_date": "20231002",
+ "data_time": "",
+ "open_price": " 6480.5",
+ "high_price": " 6480.5",
+ "low_price": " 6360.0",
+ "last_price": " 6406.0",
+ "last_qntt": "",
+ "vol": " 40",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 44.5",
+ "prev_diff_rate": " -0.69"
+ },
+ {
+ "data_date": "20231009",
+ "data_time": "",
+ "open_price": " 6410.0",
+ "high_price": " 6471.5",
+ "low_price": " 6388.5",
+ "last_price": " 6388.5",
+ "last_qntt": "",
+ "vol": " 21",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 17.5",
+ "prev_diff_rate": " -0.27"
+ },
+ {
+ "data_date": "20231016",
+ "data_time": "",
+ "open_price": " 6381.0",
+ "high_price": " 6423.0",
+ "low_price": " 6345.0",
+ "last_price": " 6360.0",
+ "last_qntt": "",
+ "vol": " 16",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 28.5",
+ "prev_diff_rate": " -0.45"
+ },
+ {
+ "data_date": "20231023",
+ "data_time": "",
+ "open_price": " 6361.5",
+ "high_price": " 6366.0",
+ "low_price": " 6361.5",
+ "last_price": " 6366.0",
+ "last_qntt": "",
+ "vol": "6 ",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 6",
+ "prev_diff_rate": " 0.09"
+ },
+ {
+ "data_date": "20231030",
+ "data_time": "",
+ "open_price": " 6460.5",
+ "high_price": " 6547.0",
+ "low_price": " 6460.5",
+ "last_price": " 6530.0",
+ "last_qntt": "",
+ "vol": " 102",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 164",
+ "prev_diff_rate": " 2.58"
+ },
+ {
+ "data_date": "20231106",
+ "data_time": "",
+ "open_price": " 6502.0",
+ "high_price": " 6502.0",
+ "low_price": " 6395.0",
+ "last_price": " 6395.0",
+ "last_qntt": "",
+ "vol": " 34",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 135",
+ "prev_diff_rate": " -2.07"
+ },
+ {
+ "data_date": "20231113",
+ "data_time": "",
+ "open_price": " 6410.0",
+ "high_price": " 6548.0",
+ "low_price": " 6410.0",
+ "last_price": " 6529.5",
+ "last_qntt": "",
+ "vol": " 18",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 134.5",
+ "prev_diff_rate": " 2.10"
+ },
+ {
+ "data_date": "20231120",
+ "data_time": "",
+ "open_price": " 6564.0",
+ "high_price": " 6622.0",
+ "low_price": " 6561.0",
+ "last_price": " 6620.5",
+ "last_qntt": "",
+ "vol": " 190",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 91",
+ "prev_diff_rate": " 1.39"
+ },
+ {
+ "data_date": "20231127",
+ "data_time": "",
+ "open_price": " 6610.0",
+ "high_price": " 6703.0",
+ "low_price": " 6610.0",
+ "last_price": " 6702.0",
+ "last_qntt": "",
+ "vol": " 326",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 81.5",
+ "prev_diff_rate": " 1.23"
+ },
+ {
+ "data_date": "20231204",
+ "data_time": "",
+ "open_price": " 6697.5",
+ "high_price": " 6697.5",
+ "low_price": " 6565.0",
+ "last_price": " 6614.0",
+ "last_qntt": "",
+ "vol": " 296",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 88",
+ "prev_diff_rate": " -1.31"
+ },
+ {
+ "data_date": "20231211",
+ "data_time": "",
+ "open_price": " 6605.0",
+ "high_price": " 6760.5",
+ "low_price": " 6578.0",
+ "last_price": " 6730.0",
+ "last_qntt": "",
+ "vol": " 510",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 116",
+ "prev_diff_rate": " 1.75"
+ },
+ {
+ "data_date": "20231218",
+ "data_time": "",
+ "open_price": " 6731.0",
+ "high_price": " 6855.5",
+ "low_price": " 6725.0",
+ "last_price": " 6827.0",
+ "last_qntt": "",
+ "vol": " 617",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 97",
+ "prev_diff_rate": " 1.44"
+ },
+ {
+ "data_date": "20231225",
+ "data_time": "",
+ "open_price": " 6834.0",
+ "high_price": " 6900.0",
+ "low_price": " 6811.5",
+ "last_price": " 6858.5",
+ "last_qntt": "",
+ "vol": " 353",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 31.5",
+ "prev_diff_rate": " 0.46"
+ },
+ {
+ "data_date": "20240101",
+ "data_time": "",
+ "open_price": " 6841.0",
+ "high_price": " 6864.5",
+ "low_price": " 6683.0",
+ "last_price": " 6742.0",
+ "last_qntt": "",
+ "vol": " 325",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 116.5",
+ "prev_diff_rate": " -1.70"
+ },
+ {
+ "data_date": "20240108",
+ "data_time": "",
+ "open_price": " 6762.0",
+ "high_price": " 6762.0",
+ "low_price": " 6678.0",
+ "last_price": " 6711.0",
+ "last_qntt": "",
+ "vol": " 310",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 31",
+ "prev_diff_rate": " -0.46"
+ },
+ {
+ "data_date": "20240115",
+ "data_time": "",
+ "open_price": " 6709.5",
+ "high_price": " 6728.0",
+ "low_price": " 6556.0",
+ "last_price": " 6624.5",
+ "last_qntt": "",
+ "vol": " 900",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 86.5",
+ "prev_diff_rate": " -1.29"
+ },
+ {
+ "data_date": "20240122",
+ "data_time": "",
+ "open_price": " 6622.0",
+ "high_price": " 6643.0",
+ "low_price": " 6579.5",
+ "last_price": " 6600.0",
+ "last_qntt": "",
+ "vol": " 389",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 24.5",
+ "prev_diff_rate": " -0.37"
+ },
+ {
+ "data_date": "20240129",
+ "data_time": "",
+ "open_price": " 6598.0",
+ "high_price": " 6646.5",
+ "low_price": " 6529.0",
+ "last_price": " 6539.5",
+ "last_qntt": "",
+ "vol": " 962",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 60.5",
+ "prev_diff_rate": " -0.92"
+ },
+ {
+ "data_date": "20240205",
+ "data_time": "",
+ "open_price": " 6520.5",
+ "high_price": " 6563.5",
+ "low_price": " 6494.5",
+ "last_price": " 6549.5",
+ "last_qntt": "",
+ "vol": " 1019",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 10",
+ "prev_diff_rate": " 0.15"
+ },
+ {
+ "data_date": "20240212",
+ "data_time": "",
+ "open_price": " 6553.0",
+ "high_price": " 6568.0",
+ "low_price": " 6469.0",
+ "last_price": " 6557.5",
+ "last_qntt": "",
+ "vol": " 891",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 8",
+ "prev_diff_rate": " 0.12"
+ },
+ {
+ "data_date": "20240219",
+ "data_time": "",
+ "open_price": " 6564.0",
+ "high_price": " 6616.5",
+ "low_price": " 6544.5",
+ "last_price": " 6584.0",
+ "last_qntt": "",
+ "vol": " 1773",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 26.5",
+ "prev_diff_rate": " 0.40"
+ },
+ {
+ "data_date": "20240226",
+ "data_time": "",
+ "open_price": " 6588.5",
+ "high_price": " 6588.5",
+ "low_price": " 6509.5",
+ "last_price": " 6546.0",
+ "last_qntt": "",
+ "vol": " 3428",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 38",
+ "prev_diff_rate": " -0.58"
+ },
+ {
+ "data_date": "20240304",
+ "data_time": "",
+ "open_price": " 6546.0",
+ "high_price": " 6686.5",
+ "low_price": " 6498.0",
+ "last_price": " 6644.0",
+ "last_qntt": "",
+ "vol": " 35069",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 98",
+ "prev_diff_rate": " 1.50"
+ },
+ {
+ "data_date": "20240311",
+ "data_time": "",
+ "open_price": " 6645.0",
+ "high_price": " 6646.0",
+ "low_price": " 0.66235",
+ "last_price": " 6577.5",
+ "last_qntt": "",
+ "vol": " 115245",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 66.5",
+ "prev_diff_rate": " -1.00"
+ },
+ {
+ "data_date": "20240318",
+ "data_time": "",
+ "open_price": " 6576.5",
+ "high_price": " 6650.5",
+ "low_price": " 6525.5",
+ "last_price": " 6530.5",
+ "last_qntt": "",
+ "vol": " 328691",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 47",
+ "prev_diff_rate": " -0.71"
+ },
+ {
+ "data_date": "20240325",
+ "data_time": "",
+ "open_price": " 6530",
+ "high_price": " 6574.5",
+ "low_price": " 6499.5",
+ "last_price": " 6530",
+ "last_qntt": "",
+ "vol": " 301604",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 0.5",
+ "prev_diff_rate": " -0.01"
+ },
+ {
+ "data_date": "20240401",
+ "data_time": "",
+ "open_price": " 6531.5",
+ "high_price": " 6633",
+ "low_price": " 6495.0",
+ "last_price": " 6593",
+ "last_qntt": "",
+ "vol": " 474911",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 63",
+ "prev_diff_rate": " 0.96"
+ },
+ {
+ "data_date": "20240408",
+ "data_time": "",
+ "open_price": " 6590",
+ "high_price": " 6657.5",
+ "low_price": " 6468.0",
+ "last_price": " 6474.0",
+ "last_qntt": "",
+ "vol": " 594239",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 119",
+ "prev_diff_rate": " -1.80"
+ },
+ {
+ "data_date": "20240415",
+ "data_time": "",
+ "open_price": " 6475.5",
+ "high_price": " 6505.0",
+ "low_price": " 6373.0",
+ "last_price": " 6428.5",
+ "last_qntt": "",
+ "vol": " 540988",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 45.5",
+ "prev_diff_rate": " -0.70"
+ },
+ {
+ "data_date": "20240422",
+ "data_time": "",
+ "open_price": " 6430.0",
+ "high_price": " 6466.5",
+ "low_price": " 6425.0",
+ "last_price": " 6460.0",
+ "last_qntt": "",
+ "vol": "82245 ",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 31.5",
+ "prev_diff_rate": " 0.49"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/302_해외선물-018_해외선물-체결추이일간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/302_해외선물-018_해외선물-체결추이일간.md
new file mode 100644
index 0000000..525cdf5
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/302_해외선물-018_해외선물-체결추이일간.md
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(일간)
+
+- 원본 시트명: 해외선물 체결추이(일간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-018
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/daily-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(일간) API입니다.
+한국투자 HTS(eFriend Plus) > [5502] 해외선물옵션 체결추이 화면에서 "일간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55020100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| tret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240424
+QRY_TP:
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0040",
+ "last_n_cnt": "",
+ "index_key": "20240226"
+ },
+ "output2": [
+ {
+ "data_date": "20240226",
+ "data_time": "",
+ "open_price": " 6588.5",
+ "high_price": " 6588.5",
+ "low_price": " 6555.0",
+ "last_price": " 6562.5",
+ "last_qntt": "",
+ "vol": " 639",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 21.5",
+ "prev_diff_rate": " -0.33"
+ },
+ {
+ "data_date": "20240227",
+ "data_time": "",
+ "open_price": " 6555.0",
+ "high_price": " 6577.5",
+ "low_price": " 6549.0",
+ "last_price": " 6565.0",
+ "last_qntt": "",
+ "vol": " 134",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 2.5",
+ "prev_diff_rate": " 0.04"
+ },
+ {
+ "data_date": "20240228",
+ "data_time": "",
+ "open_price": " 6567.0",
+ "high_price": " 6568.5",
+ "low_price": " 6511.0",
+ "last_price": " 6515.0",
+ "last_qntt": "",
+ "vol": " 1210",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 50",
+ "prev_diff_rate": " -0.76"
+ },
+ {
+ "data_date": "20240229",
+ "data_time": "",
+ "open_price": " 6516.0",
+ "high_price": " 6551.0",
+ "low_price": " 6509.5",
+ "last_price": " 6519.0",
+ "last_qntt": "",
+ "vol": " 503",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 4",
+ "prev_diff_rate": " 0.06"
+ },
+ {
+ "data_date": "20240301",
+ "data_time": "",
+ "open_price": " 6517.5",
+ "high_price": " 6554.5",
+ "low_price": " 6510.5",
+ "last_price": " 6546.0",
+ "last_qntt": "",
+ "vol": " 942",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 27",
+ "prev_diff_rate": " 0.41"
+ },
+ {
+ "data_date": "20240304",
+ "data_time": "",
+ "open_price": " 6546.0",
+ "high_price": " 6549.0",
+ "low_price": " 6528.5",
+ "last_price": " 6528.5",
+ "last_qntt": "",
+ "vol": " 2298",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 17.5",
+ "prev_diff_rate": " -0.27"
+ },
+ {
+ "data_date": "20240305",
+ "data_time": "",
+ "open_price": " 6530.5",
+ "high_price": " 6541.0",
+ "low_price": " 6498.0",
+ "last_price": " 6523.5",
+ "last_qntt": "",
+ "vol": " 13778",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 5",
+ "prev_diff_rate": " -0.08"
+ },
+ {
+ "data_date": "20240306",
+ "data_time": "",
+ "open_price": " 6522.0",
+ "high_price": " 6600.5",
+ "low_price": " 6512.5",
+ "last_price": " 6584.5",
+ "last_qntt": "",
+ "vol": " 3269",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 61",
+ "prev_diff_rate": " 0.94"
+ },
+ {
+ "data_date": "20240307",
+ "data_time": "",
+ "open_price": " 6582.0",
+ "high_price": " 6643.5",
+ "low_price": " 6582.0",
+ "last_price": " 6639.0",
+ "last_qntt": "",
+ "vol": " 10466",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 54.5",
+ "prev_diff_rate": " 0.83"
+ },
+ {
+ "data_date": "20240308",
+ "data_time": "",
+ "open_price": " 6637.0",
+ "high_price": " 6686.5",
+ "low_price": " 6632.5",
+ "last_price": " 6644.0",
+ "last_qntt": "",
+ "vol": " 5258",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 5",
+ "prev_diff_rate": " 0.08"
+ },
+ {
+ "data_date": "20240311",
+ "data_time": "",
+ "open_price": " 6645.0",
+ "high_price": " 6646.0",
+ "low_price": " 6616.0",
+ "last_price": " 6633.0",
+ "last_qntt": "",
+ "vol": " 39035",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 11",
+ "prev_diff_rate": " -0.17"
+ },
+ {
+ "data_date": "20240312",
+ "data_time": "",
+ "open_price": " 0.6624",
+ "high_price": " 0.6624",
+ "low_price": " 0.66235",
+ "last_price": " 0.6625",
+ "last_qntt": "",
+ "vol": " 11",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 6632.3375",
+ "prev_diff_rate": " -99.99"
+ },
+ {
+ "data_date": "20240313",
+ "data_time": "",
+ "open_price": " 0.664",
+ "high_price": " 0.6641",
+ "low_price": " 0.664",
+ "last_price": " 0.664",
+ "last_qntt": "",
+ "vol": " 50",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 0.0015",
+ "prev_diff_rate": " 0.23"
+ },
+ {
+ "data_date": "20240314",
+ "data_time": "",
+ "open_price": " 6598.5",
+ "high_price": " 6598.5",
+ "low_price": " 6598.5",
+ "last_price": " 6598.5",
+ "last_qntt": "",
+ "vol": " 83",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 6597.836",
+ "prev_diff_rate": " 993650.00"
+ },
+ {
+ "data_date": "20240315",
+ "data_time": "",
+ "open_price": " 6598.5",
+ "high_price": " 6599.5",
+ "low_price": " 6569.5",
+ "last_price": " 6577.5",
+ "last_qntt": "",
+ "vol": " 76056",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 21",
+ "prev_diff_rate": " -0.32"
+ },
+ {
+ "data_date": "20240318",
+ "data_time": "",
+ "open_price": " 6576.5",
+ "high_price": " 6576.5",
+ "low_price": " 6576.5",
+ "last_price": " 6576.5",
+ "last_qntt": "",
+ "vol": " 1",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 1",
+ "prev_diff_rate": " -0.02"
+ },
+ {
+ "data_date": "20240319",
+ "data_time": "",
+ "open_price": " 6548",
+ "high_price": " 6549",
+ "low_price": " 6548",
+ "last_price": " 6548.5",
+ "last_qntt": "",
+ "vol": " 44",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 28",
+ "prev_diff_rate": " -0.43"
+ },
+ {
+ "data_date": "20240320",
+ "data_time": "",
+ "open_price": " 6548.0",
+ "high_price": " 6603.5",
+ "low_price": " 6528.0",
+ "last_price": " 6602.5",
+ "last_qntt": "",
+ "vol": " 100506",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 54",
+ "prev_diff_rate": " 0.82"
+ },
+ {
+ "data_date": "20240321",
+ "data_time": "",
+ "open_price": " 6598.0",
+ "high_price": " 6650.5",
+ "low_price": " 6577.0",
+ "last_price": " 6586.0",
+ "last_qntt": "",
+ "vol": " 126413",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 16.5",
+ "prev_diff_rate": " -0.25"
+ },
+ {
+ "data_date": "20240322",
+ "data_time": "",
+ "open_price": " 6585.5",
+ "high_price": " 6592.5",
+ "low_price": " 6525.5",
+ "last_price": " 6530.5",
+ "last_qntt": "",
+ "vol": " 101727",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 55.5",
+ "prev_diff_rate": " -0.84"
+ },
+ {
+ "data_date": "20240325",
+ "data_time": "",
+ "open_price": " 6530",
+ "high_price": " 6562.5",
+ "low_price": " 6525",
+ "last_price": " 6555.5",
+ "last_qntt": "",
+ "vol": " 70152",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 25",
+ "prev_diff_rate": " 0.38"
+ },
+ {
+ "data_date": "20240326",
+ "data_time": "",
+ "open_price": " 6555.5",
+ "high_price": " 6574.5",
+ "low_price": " 6545.5",
+ "last_price": " 6548.5",
+ "last_qntt": "",
+ "vol": " 58147",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 7",
+ "prev_diff_rate": " -0.11"
+ },
+ {
+ "data_date": "20240327",
+ "data_time": "",
+ "open_price": " 6548",
+ "high_price": " 6553",
+ "low_price": " 6525.5",
+ "last_price": " 6549",
+ "last_qntt": "",
+ "vol": " 68767",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 0.5",
+ "prev_diff_rate": " 0.01"
+ },
+ {
+ "data_date": "20240328",
+ "data_time": "",
+ "open_price": " 6548.5",
+ "high_price": " 6555.5",
+ "low_price": " 6499.5",
+ "last_price": " 6530",
+ "last_qntt": "",
+ "vol": " 104538",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 19",
+ "prev_diff_rate": " -0.29"
+ },
+ {
+ "data_date": "20240401",
+ "data_time": "",
+ "open_price": " 6531.5",
+ "high_price": " 6554.0",
+ "low_price": " 6495.0",
+ "last_price": " 6504.0",
+ "last_qntt": "",
+ "vol": " 74942",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 26",
+ "prev_diff_rate": " -0.40"
+ },
+ {
+ "data_date": "20240402",
+ "data_time": "",
+ "open_price": " 6504.0",
+ "high_price": " 6538.0",
+ "low_price": " 6496.5",
+ "last_price": " 6531.5",
+ "last_qntt": "",
+ "vol": " 83996",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 27.5",
+ "prev_diff_rate": " 0.42"
+ },
+ {
+ "data_date": "20240403",
+ "data_time": "",
+ "open_price": " 6532",
+ "high_price": " 6584",
+ "low_price": " 6517.5",
+ "last_price": " 6579.5",
+ "last_qntt": "",
+ "vol": " 94108",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 48",
+ "prev_diff_rate": " 0.73"
+ },
+ {
+ "data_date": "20240404",
+ "data_time": "",
+ "open_price": " 6577",
+ "high_price": " 6633",
+ "low_price": " 6577",
+ "last_price": " 6601.5",
+ "last_qntt": "",
+ "vol": " 115253",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 22",
+ "prev_diff_rate": " 0.33"
+ },
+ {
+ "data_date": "20240405",
+ "data_time": "",
+ "open_price": " 6601.5",
+ "high_price": " 6606.5",
+ "low_price": " 6563",
+ "last_price": " 6593",
+ "last_qntt": "",
+ "vol": " 106612",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 8.5",
+ "prev_diff_rate": " -0.13"
+ },
+ {
+ "data_date": "20240408",
+ "data_time": "",
+ "open_price": " 6590",
+ "high_price": " 6623.5",
+ "low_price": " 6573",
+ "last_price": " 6617.5",
+ "last_qntt": "",
+ "vol": " 71474",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 24.5",
+ "prev_diff_rate": " 0.37"
+ },
+ {
+ "data_date": "20240409",
+ "data_time": "",
+ "open_price": " 6617",
+ "high_price": " 6657.5",
+ "low_price": " 6612",
+ "last_price": " 6641.5",
+ "last_qntt": "",
+ "vol": " 88858",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 24",
+ "prev_diff_rate": " 0.36"
+ },
+ {
+ "data_date": "20240410",
+ "data_time": "",
+ "open_price": " 6641.5",
+ "high_price": " 6644.5",
+ "low_price": " 6512.0",
+ "last_price": " 6525.0",
+ "last_qntt": "",
+ "vol": " 186665",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 116.5",
+ "prev_diff_rate": " -1.75"
+ },
+ {
+ "data_date": "20240411",
+ "data_time": "",
+ "open_price": " 6524.5",
+ "high_price": " 6565.0",
+ "low_price": " 6514.5",
+ "last_price": " 6550.5",
+ "last_qntt": "",
+ "vol": " 121379",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 25.5",
+ "prev_diff_rate": " 0.39"
+ },
+ {
+ "data_date": "20240412",
+ "data_time": "",
+ "open_price": " 6550.5",
+ "high_price": " 6555.5",
+ "low_price": " 6468.0",
+ "last_price": " 6474.0",
+ "last_qntt": "",
+ "vol": " 125863",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 76.5",
+ "prev_diff_rate": " -1.17"
+ },
+ {
+ "data_date": "20240415",
+ "data_time": "",
+ "open_price": " 6475.5",
+ "high_price": " 6505.0",
+ "low_price": " 6449.0",
+ "last_price": " 6453.5",
+ "last_qntt": "",
+ "vol": " 113834",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 20.5",
+ "prev_diff_rate": " -0.32"
+ },
+ {
+ "data_date": "20240416",
+ "data_time": "",
+ "open_price": " 6456.5",
+ "high_price": " 6456.5",
+ "low_price": " 6401.0",
+ "last_price": " 6414.0",
+ "last_qntt": "",
+ "vol": " 120271",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 39.5",
+ "prev_diff_rate": " -0.61"
+ },
+ {
+ "data_date": "20240417",
+ "data_time": "",
+ "open_price": " 6413.5",
+ "high_price": " 6457.5",
+ "low_price": " 6411.5",
+ "last_price": " 6446.0",
+ "last_qntt": "",
+ "vol": " 110152",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 32",
+ "prev_diff_rate": " 0.50"
+ },
+ {
+ "data_date": "20240418",
+ "data_time": "",
+ "open_price": " 6446.0",
+ "high_price": " 6467.0",
+ "low_price": " 6427.5",
+ "last_price": " 6432.0",
+ "last_qntt": "",
+ "vol": " 76120",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 14",
+ "prev_diff_rate": " -0.22"
+ },
+ {
+ "data_date": "20240419",
+ "data_time": "",
+ "open_price": " 6431.5",
+ "high_price": " 6444.0",
+ "low_price": " 6373.0",
+ "last_price": " 6428.5",
+ "last_qntt": "",
+ "vol": " 120611",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 3.5",
+ "prev_diff_rate": " -0.05"
+ },
+ {
+ "data_date": "20240422",
+ "data_time": "",
+ "open_price": " 6430.0",
+ "high_price": " 6466.5",
+ "low_price": " 6425.0",
+ "last_price": " 6460.0",
+ "last_qntt": "",
+ "vol": " 82245",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 31.5",
+ "prev_diff_rate": " 0.49"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/303_해외선물-020_해외선물-체결추이월간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/303_해외선물-020_해외선물-체결추이월간.md
new file mode 100644
index 0000000..da05b31
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/303_해외선물-020_해외선물-체결추이월간.md
@@ -0,0 +1,303 @@
+# 해외선물 체결추이(월간)
+
+- 원본 시트명: 해외선물 체결추이(월간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-020
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/monthly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(월간) API입니다.
+한국투자 HTS(eFriend Plus) > [5502] 해외선물옵션 체결추이 화면에서 "월간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55020300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| tret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240423
+QRY_TP:
+QRY_CNT:30
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0013",
+ "last_n_cnt": "",
+ "index_key": ""
+ },
+ "output2": [
+ {
+ "data_date": "20230401",
+ "data_time": "",
+ "open_price": " 6770.0",
+ "high_price": " 6770.0",
+ "low_price": " 6770.0",
+ "last_price": " 6770.0",
+ "last_qntt": "",
+ "vol": "3",
+ "prev_diff_flag": "3",
+ "prev_diff_price": " 0.0000000",
+ "prev_diff_rate": " 0.00"
+ },
+ {
+ "data_date": "20230501",
+ "data_time": "",
+ "open_price": " 6795.0",
+ "high_price": " 6800.0",
+ "low_price": " 6620.0",
+ "last_price": " 6620.0",
+ "last_qntt": "",
+ "vol": " 16",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 150.0000000",
+ "prev_diff_rate": " -2.22"
+ },
+ {
+ "data_date": "20230601",
+ "data_time": "",
+ "open_price": " 6809.5",
+ "high_price": " 6817.0",
+ "low_price": " 6692.0",
+ "last_price": " 6692.0",
+ "last_qntt": "",
+ "vol": " 25",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 72.0000000",
+ "prev_diff_rate": " 1.09"
+ },
+ {
+ "data_date": "20230701",
+ "data_time": "",
+ "open_price": " 6840.5",
+ "high_price": " 6840.5",
+ "low_price": " 6840.0",
+ "last_price": " 6840.0",
+ "last_qntt": "",
+ "vol": "5",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 148.0000000",
+ "prev_diff_rate": " 2.21"
+ },
+ {
+ "data_date": "20230801",
+ "data_time": "",
+ "open_price": " 6702.0",
+ "high_price": " 6702.0",
+ "low_price": " 6594.5",
+ "last_price": " 6594.5",
+ "last_qntt": "",
+ "vol": " 16",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 245.5000000",
+ "prev_diff_rate": " -3.59"
+ },
+ {
+ "data_date": "20230901",
+ "data_time": "",
+ "open_price": " 6535.0",
+ "high_price": " 6558.5",
+ "low_price": " 6430.0",
+ "last_price": " 6450.5",
+ "last_qntt": "",
+ "vol": " 55",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 144.0000000",
+ "prev_diff_rate": " -2.18"
+ },
+ {
+ "data_date": "20231001",
+ "data_time": "",
+ "open_price": " 6480.5",
+ "high_price": " 6480.5",
+ "low_price": " 6345.0",
+ "last_price": " 6366.0",
+ "last_qntt": "",
+ "vol": " 83",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 84.5000000",
+ "prev_diff_rate": " -1.31"
+ },
+ {
+ "data_date": "20231101",
+ "data_time": "",
+ "open_price": " 6460.5",
+ "high_price": " 6675.0",
+ "low_price": " 6395.0",
+ "last_price": " 6640.0",
+ "last_qntt": "",
+ "vol": " 532",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 274.0000000",
+ "prev_diff_rate": " 4.30"
+ },
+ {
+ "data_date": "20231201",
+ "data_time": "",
+ "open_price": " 6642.0",
+ "high_price": " 6900.0",
+ "low_price": " 6565.0",
+ "last_price": " 6858.5",
+ "last_qntt": "",
+ "vol": " 1914",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 218.5000000",
+ "prev_diff_rate": " 3.29"
+ },
+ {
+ "data_date": "20240101",
+ "data_time": "",
+ "open_price": " 6841.0",
+ "high_price": " 6864.5",
+ "low_price": " 6556.0",
+ "last_price": " 6591.0",
+ "last_qntt": "",
+ "vol": " 2302",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 267.5000000",
+ "prev_diff_rate": " -3.90"
+ },
+ {
+ "data_date": "20240201",
+ "data_time": "",
+ "open_price": " 6588.0",
+ "high_price": " 6629.0",
+ "low_price": " 6469.0",
+ "last_price": " 6519.0",
+ "last_qntt": "",
+ "vol": " 6753",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 72.0000000",
+ "prev_diff_rate": " -1.09"
+ },
+ {
+ "data_date": "20240301",
+ "data_time": "",
+ "open_price": " 6517.5",
+ "high_price": " 6686.5",
+ "low_price": " 0.66235",
+ "last_price": " 6530",
+ "last_qntt": "",
+ "vol": " 781551",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 11.0000000",
+ "prev_diff_rate": " 0.17"
+ },
+ {
+ "data_date": "20240401",
+ "data_time": "",
+ "open_price": " 6531.5",
+ "high_price": " 6657.5",
+ "low_price": " 6373.0",
+ "last_price": " 6460.0",
+ "last_qntt": "",
+ "vol": " 1692383",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 70.0000000",
+ "prev_diff_rate": " -1.07"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/304_해외선물-023_해외선물-상품기본정보.md b/docs/broker/kis/rest/해외선물옵션/기본시세/304_해외선물-023_해외선물-상품기본정보.md
new file mode 100644
index 0000000..728512e
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/304_해외선물-023_해외선물-상품기본정보.md
@@ -0,0 +1,160 @@
+# 해외선물 상품기본정보
+
+- 원본 시트명: 해외선물 상품기본정보
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-023
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55200000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/search-contract-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 상품기본정보 API입니다.
+한국투자 HTS(eFriend Plus) > [0054] 해외선물옵션 상품기본정보 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+QRY_CNT에 SRS_CD 요청 개수 입력, SRS_CD_01 ~SRS_CD_32 까지 최대 32건의 상품코드 추가 입력하여 해외선물옵션 상품기본정보 확인이 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55200000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| QRY_CNT | 요청개수 | string | Y | 4 | 입력한 코드 개수 |
+| SRS_CD_01 | 품목종류 | string | Y | 32 | 최대 32개 까지 가능 |
+| SRS_CD_02… | 품목종류… | string | Y | 32 | |
+| SRS_CD_32 | 품목종류 | string | Y | 32 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | array |
+| exch_cd | 거래소코드 | string | Y | 10 | |
+| clas_cd | 품목종류 | string | Y | 3 | |
+| crc_cd | 거래통화 | string | Y | 10 | |
+| sttl_price | 정산가 | string | Y | 15 | |
+| sttl_date | 정산일 | string | Y | 8 | |
+| trst_mgn | 증거금 | string | Y | 19 | |
+| disp_digit | 가격표시진법 | string | Y | 10 | |
+| tick_sz | 틱사이즈 | string | Y | 19 | |
+| tick_val | 틱가치 | string | Y | 19 | |
+| mrkt_open_date | 장개시일자 | string | Y | 8 | |
+| mrkt_open_time | 장개시시각 | string | Y | 6 | |
+| mrkt_close_date | 장마감일자 | string | Y | 8 | |
+| mrkt_close_time | 장마감시각 | string | Y | 6 | |
+| trd_fr_date | 상장일 | string | Y | 8 | |
+| expr_date | 만기일 | string | Y | 8 | |
+| trd_to_date | 최종거래일 | string | Y | 8 | |
+| remn_cnt | 잔존일수 | string | Y | 4 | |
+| stat_tp | 매매여부 | string | Y | 1 | |
+| ctrt_size | 계약크기 | string | Y | 19 | |
+| stl_tp | 최종결제구분 | string | Y | 20 | |
+| frst_noti_date | 최초식별일 | string | Y | 8 | |
+| sub_exch_nm | 서브거래소코드 | string | Y | 32 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+QRY_CNT:2
+SRS_CD_01:6AM24
+SRS_CD_02:10YK24
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "exch_cd": "CME",
+ "clas_cd": "001",
+ "crc_cd": "USD",
+ "sttl_price": " 6684.5",
+ "sttl_date": "20240516",
+ "trst_mgn": " 1595",
+ "disp_digit": " 10",
+ "tick_sz": " 0.00005",
+ "tick_val": " 5",
+ "mrkt_open_date": "20240517",
+ "mrkt_open_time": "070000",
+ "mrkt_close_date": "20240518",
+ "mrkt_close_time": "060000",
+ "trd_fr_date": "20190604",
+ "expr_date": "20240617",
+ "trd_to_date": "20240617",
+ "remn_cnt": " 29",
+ "stat_tp": "1",
+ "ctrt_size": " 100000",
+ "stl_tp": "실물인수도",
+ "frst_noti_date": "20240617",
+ "sub_exch_nm": "CME"
+ },
+ {
+ "exch_cd": "CME",
+ "clas_cd": "002",
+ "crc_cd": "USD",
+ "sttl_price": " 4375",
+ "sttl_date": "20240516",
+ "trst_mgn": " 352",
+ "disp_digit": " 10",
+ "tick_sz": " 0.001",
+ "tick_val": " 1",
+ "mrkt_open_date": "20240517",
+ "mrkt_open_time": "070000",
+ "mrkt_close_date": "20240518",
+ "mrkt_close_time": "060000",
+ "trd_fr_date": "20240315",
+ "expr_date": "20240531",
+ "trd_to_date": "20240531",
+ "remn_cnt": " 15",
+ "stat_tp": "1",
+ "ctrt_size": " 1000",
+ "stl_tp": "현금결제",
+ "frst_noti_date": "20240531",
+ "sub_exch_nm": "CBOT"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/305_해외선물-029_해외선물-미결제추이.md b/docs/broker/kis/rest/해외선물옵션/기본시세/305_해외선물-029_해외선물-미결제추이.md
new file mode 100644
index 0000000..6e095e9
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/305_해외선물-029_해외선물-미결제추이.md
@@ -0,0 +1,206 @@
+# 해외선물 미결제추이
+
+- 원본 시트명: 해외선물 미결제추이
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-029
+- HTTP Method: GET
+- 실전 TR_ID: HHDDB95030000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/investor-unpd-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 미결제추이 API입니다.
+한국투자 HTS(eFriend Plus) > [1959] 해외선물 미결제추이의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDDB95030000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PROD_ISCD | 상품 | string | Y | 5 | 금리 (GE, ZB, ZF,ZN,ZT), 금속(GC, PA, PL,SI, HG), 농산물(CC, CT,KC, OJ, SB, ZC,ZL, ZM, ZO, ZR, ZS, ZW), 에너지(CL, HO, NG, WBS), 지수(ES, NQ, TF, YM, VX), 축산물(GF, HE, LE), 통화(6A, 6B, 6C, 6E, 6J, 6N, 6S, DX) |
+| BSOP_DATE | 일자 | string | Y | 8 | 기준일(ex)20240513) |
+| UPMU_GUBUN | 구분 | string | Y | 1 | 0(수량), 1(증감) |
+| CTS_KEY | CTS_KEY | string | Y | 16 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| row_cnt | 응답레코드카운트 | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| prod_iscd | 상품 | string | Y | 5 | |
+| cftc_iscd | CFTC코드 | string | Y | 10 | |
+| bsop_date | 일자 | string | Y | 8 | |
+| bidp_spec | 매수투기 | string | Y | 10 | |
+| askp_spec | 매도투기 | string | Y | 10 | |
+| spread_spec | 스프레드투기 | string | Y | 10 | |
+| bidp_hedge | 매수헤지 | string | Y | 10 | |
+| askp_hedge | 매도헤지 | string | Y | 10 | |
+| hts_otst_smtn | 미결제합계 | string | Y | 10 | |
+| bidp_missing | 매수누락 | string | Y | 10 | |
+| askp_missing | 매도누락 | string | Y | 10 | |
+| bidp_spec_cust | 매수투기고객 | string | Y | 10 | |
+| askp_spec_cust | 매도투기고객 | string | Y | 10 | |
+| spread_spec_cust | 스프레드투기고객 | string | Y | 10 | |
+| bidp_hedge_cust | 매수헤지고객 | string | Y | 10 | |
+| askp_hedge_cust | 매도헤지고객 | string | Y | 10 | |
+| cust_smtn | 고객합계 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+PROD_ISCD:ES
+BSOP_DATE:20240624
+UPMU_GUBUN:0
+CTS_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "row_cnt": "0100"
+ },
+ "output2": [
+ {
+ "prod_iscd": "ES",
+ "cftc_iscd": "13874A",
+ "bsop_date": "20240611",
+ "bidp_spec": "270380",
+ "askp_spec": "381794",
+ "spread_spec": "0",
+ "bidp_hedge": "1606798",
+ "askp_hedge": "1617849",
+ "hts_otst_smtn": "2266096",
+ "bidp_missing": "297310",
+ "askp_missing": "174845",
+ "bidp_spec_cust": "80",
+ "askp_spec_cust": "68",
+ "spread_spec_cust": "55",
+ "bidp_hedge_cust": "253",
+ "askp_hedge_cust": "205",
+ "cust_smtn": "472"
+ },
+ {
+ "prod_iscd": "ES",
+ "cftc_iscd": "13874A",
+ "bsop_date": "20240604",
+ "bidp_spec": "265433",
+ "askp_spec": "330433",
+ "spread_spec": "0",
+ "bidp_hedge": "1534557",
+ "askp_hedge": "1581649",
+ "hts_otst_smtn": "2160026",
+ "bidp_missing": "287673",
+ "askp_missing": "175581",
+ "bidp_spec_cust": "76",
+ "askp_spec_cust": "68",
+ "spread_spec_cust": "45",
+ "bidp_hedge_cust": "262",
+ "askp_hedge_cust": "207",
+ "cust_smtn": "474"
+ },
+ {
+ "prod_iscd": "ES",
+ "cftc_iscd": "13874A",
+ "bsop_date": "20240528",
+ "bidp_spec": "330937",
+ "askp_spec": "333145",
+ "spread_spec": "0",
+ "bidp_hedge": "1503708",
+ "askp_hedge": "1609652",
+ "hts_otst_smtn": "2179731",
+ "bidp_missing": "289071",
+ "askp_missing": "180919",
+ "bidp_spec_cust": "80",
+ "askp_spec_cust": "63",
+ "spread_spec_cust": "39",
+ "bidp_hedge_cust": "251",
+ "askp_hedge_cust": "203",
+ "cust_smtn": "469"
+ },
+ {
+ "prod_iscd": "ES",
+ "cftc_iscd": "13874A",
+ "bsop_date": "20240521",
+ "bidp_spec": "304226",
+ "askp_spec": "327000",
+ "spread_spec": "0",
+ "bidp_hedge": "1501724",
+ "askp_hedge": "1593706",
+ "hts_otst_smtn": "2148201",
+ "bidp_missing": "288496",
+ "askp_missing": "173740",
+ "bidp_spec_cust": "78",
+ "askp_spec_cust": "66",
+ "spread_spec_cust": "42",
+ "bidp_hedge_cust": "249",
+ "askp_hedge_cust": "205",
+ "cust_smtn": "470"
+ },
+ {
+ "prod_iscd": "ES",
+ "cftc_iscd": "13874A",
+ "bsop_date": "20240514",
+ "bidp_spec": "273398",
+ "askp_spec": "298682",
+ "spread_spec": "0",
+ "bidp_hedge": "1477881",
+ "askp_hedge": "1550928",
+ "hts_otst_smtn": "2081097",
+ "bidp_missing": "278004",
+ "askp_missing": "179673",
+ "bidp_spec_cust": "83",
+ "askp_spec_cust": "67",
+ "spread_spec_cust": "45",
+ "bidp_hedge_cust": "248",
+ "askp_hedge_cust": "201",
+ "cust_smtn": "470"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "",
+ "msg1": "정상 조회되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/306_해외선물-035_해외옵션종목현재가.md b/docs/broker/kis/rest/해외선물옵션/기본시세/306_해외선물-035_해외옵션종목현재가.md
new file mode 100644
index 0000000..4609ae4
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/306_해외선물-035_해외옵션종목현재가.md
@@ -0,0 +1,160 @@
+# 해외옵션종목현재가
+
+- 원본 시트명: 해외옵션종목현재가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-035
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션종목현재가 API입니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| proc_date | 최종처리일자 | string | Y | 8 | |
+| proc_time | 최종처리시각 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 현재가 | string | Y | 15 | 현재가
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+| bid_qntt | 매수1수량 | string | Y | 10 | |
+| bid_price | 매수1호가 | string | Y | 15 | |
+| ask_qntt | 매도1수량 | string | Y | 10 | |
+| ask_price | 매도1호가 | string | Y | 15 | |
+| trst_mgn | 증거금 | string | Y | 19 | |
+| exch_cd | 거래소코드 | string | Y | 10 | |
+| crc_cd | 거래통화 | string | Y | 10 | |
+| trd_fr_date | 상장일 | string | Y | 8 | |
+| expr_date | 만기일 | string | Y | 8 | |
+| trd_to_date | 최종거래일 | string | Y | 8 | |
+| remn_cnt | 잔존일수 | string | Y | 4 | |
+| last_qntt | 체결량 | string | Y | 10 | |
+| tot_ask_qntt | 총매도잔량 | string | Y | 10 | |
+| tot_bid_qntt | 총매수잔량 | string | Y | 10 | |
+| tick_size | 틱사이즈 | string | Y | 19 | |
+| open_date | 장개시일자 | string | Y | 8 | |
+| open_time | 장개시시각 | string | Y | 6 | |
+| close_date | 장종료일자 | string | Y | 8 | |
+| close_time | 장종료시각 | string | Y | 6 | |
+| sbsnsdate | 영업일자 | string | Y | 8 | |
+| sttl_price | 정산가 | string | N | 15 | 정산가 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OGXX24 C19500
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "proc_date": "20241108",
+ "proc_time": "173441",
+ "open_price": " 84.0",
+ "high_price": " 84.0",
+ "low_price": " 83.0",
+ "last_price": " 83.0",
+ "vol": " 3",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 38.0",
+ "prev_diff_rate": " -31.40",
+ "bid_qntt": " 275",
+ "bid_price": " 83.0",
+ "ask_qntt": " 425",
+ "ask_price": " 87.0",
+ "prev_price": " 121.0",
+ "trst_mgn": " 4101",
+ "exch_cd": "EUREX",
+ "crc_cd": "EUR",
+ "trd_fr_date": "20240816",
+ "expr_date": "20240816",
+ "trd_to_date": "20241115",
+ "remn_cnt": "0008",
+ "last_qntt": " 2",
+ "tot_ask_qntt": " 952",
+ "tot_bid_qntt": " 726",
+ "tick_size": " 0.1",
+ "open_date": "20241108",
+ "open_time": "150000",
+ "close_date": "20241109",
+ "close_time": "013000",
+ "sbsnsdate": "20241108",
+ "sttl_price": " 102.2"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/307_해외선물-034_해외옵션종목상세.md b/docs/broker/kis/rest/해외선물옵션/기본시세/307_해외선물-034_해외옵션종목상세.md
new file mode 100644
index 0000000..efdc6ab
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/307_해외선물-034_해외옵션종목상세.md
@@ -0,0 +1,141 @@
+# 해외옵션종목상세
+
+- 원본 시트명: 해외옵션종목상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-034
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55010100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션종목상세 API입니다.
+
+(주의) sstl_price 자리에 정산가 X 전일종가 O 가 수신되는 점 유의 부탁드립니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55010100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| exch_cd | 거래소코드 | string | Y | 10 | |
+| clas_cd | 품목종류 | string | Y | 1 | |
+| crc_cd | 거래통화 | string | Y | 10 | |
+| sttl_price | 전일종가 | string | Y | 15 | (★주의) 정산가 X 전일종가 O 가 수신됨
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| sttl_date | 정산일 | string | Y | 8 | |
+| trst_mgn | 증거금 | string | Y | 19 | |
+| disp_digit | 가격표시진법 | string | Y | 10 | |
+| tick_sz | 틱사이즈 | string | Y | 19 | |
+| tick_val | 틱가치 | string | Y | 19 | |
+| mrkt_open_date | 장개시일자 | string | Y | 8 | |
+| mrkt_open_time | 장개시시각 | string | Y | 6 | |
+| mrkt_close_date | 장마감일자 | string | Y | 8 | |
+| mrkt_close_time | 장마감시각 | string | Y | 6 | |
+| trd_fr_date | 상장일 | string | Y | 8 | |
+| expr_date | 만기일 | string | Y | 8 | |
+| trd_to_date | 최종거래일 | string | Y | 8 | |
+| remn_cnt | 잔존일수 | string | Y | 4 | |
+| stat_tp | 매매여부 | string | Y | 1 | |
+| ctrt_size | 계약크기 | string | Y | 19 | |
+| stl_tp | 최종결제구분 | string | Y | 20 | |
+| frst_noti_date | 최초식별일 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 P5650
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "exch_cd": "CME",
+ "clas_cd": "4",
+ "crc_cd": "USD",
+ "sttl_price": " 7525",
+ "sttl_date": "20240826",
+ "trst_mgn": " 7788",
+ "disp_digit": " 10",
+ "tick_sz": " 0",
+ "tick_val": " 2.5",
+ "mrkt_open_date": "20240826",
+ "mrkt_open_time": "070000",
+ "mrkt_close_date": "20240827",
+ "mrkt_close_time": "060000",
+ "trd_fr_date": "20240610",
+ "expr_date": "20240920",
+ "trd_to_date": "20240920",
+ "remn_cnt": " 26",
+ "stat_tp": "1",
+ "ctrt_size": " 50",
+ "stl_tp": "현금결제",
+ "frst_noti_date": "20240920"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/308_해외선물-033_해외옵션-호가.md b/docs/broker/kis/rest/해외선물옵션/기본시세/308_해외선물-033_해외옵션-호가.md
new file mode 100644
index 0000000..3c7ce94
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/308_해외선물-033_해외옵션-호가.md
@@ -0,0 +1,152 @@
+# 해외옵션 호가
+
+- 원본 시트명: 해외옵션 호가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-033
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO86000000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 호가 API입니다.
+한국투자 HTS(eFriend Plus) > [5501] 해외선물옵션 현재가 화면 의 "왼쪽 상단 현재가" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO86000000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 8 | 예)OESM24 C5340 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| lowp_rice | 저가 | string | Y | 15 | |
+| last_price | 현재가 | string | Y | 15 | |
+| sttl_price | 정산가 | string | Y | 15 | |
+| vol | 거래량 | string | Y | 10 | |
+| prev_diff_price | 전일대비가 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+| quot_date | 호가수신일자 | string | Y | 8 | |
+| quot_time | 호가수신시각 | string | Y | 6 | |
+| output2 | 응답상세 | object array | Y | | array (1호가~ 5호가 순서대로 표시) |
+| bid_qntt | 매수수량 | string | Y | 10 | |
+| bid_num | 매수번호 | string | Y | 10 | |
+| bid_price | 매수호가 | string | Y | 15 | |
+| ask_qntt | 매도수량 | string | Y | 10 | |
+| ask_num | 매도번호 | string | Y | 10 | |
+| ask_price | 매도호가 | string | Y | 15 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OTXM24 C22000
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "open_price": " 282.0",
+ "high_price": " 295.0",
+ "lowp_rice": " 280.0",
+ "last_price": " 290.0",
+ "sttl_price": " 288.0",
+ "vol": " 100",
+ "prev_diff_price": " 2.0",
+ "prev_diff_rate": " 0.69",
+ "quot_date": "20240528",
+ "quot_time": "184601"
+ },
+ "output2": [
+ {
+ "bid_qntt": " 37",
+ "bid_num": " 0",
+ "bid_price": " 288.0",
+ "ask_qntt": " 4",
+ "ask_num": " 0",
+ "ask_price": " 290.0"
+ },
+ {
+ "bid_qntt": " 43",
+ "bid_num": " 0",
+ "bid_price": " 287.0",
+ "ask_qntt": " 8",
+ "ask_num": " 0",
+ "ask_price": " 291.0"
+ },
+ {
+ "bid_qntt": " 20",
+ "bid_num": " 0",
+ "bid_price": " 285.0",
+ "ask_qntt": " 54",
+ "ask_num": " 0",
+ "ask_price": " 292.0"
+ },
+ {
+ "bid_qntt": " 4",
+ "bid_num": " 0",
+ "bid_price": " 280.0",
+ "ask_qntt": " 21",
+ "ask_num": " 0",
+ "ask_price": " 295.0"
+ },
+ {
+ "bid_qntt": " 5",
+ "bid_num": " 0",
+ "bid_price": " 276.0",
+ "ask_qntt": " 1",
+ "ask_num": " 0",
+ "ask_price": " 296.0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/309_해외선물-040_해외옵션-분봉조회.md b/docs/broker/kis/rest/해외선물옵션/기본시세/309_해외선물-040_해외옵션-분봉조회.md
new file mode 100644
index 0000000..78cc191
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/309_해외선물-040_해외옵션-분봉조회.md
@@ -0,0 +1,201 @@
+# 해외옵션 분봉조회
+
+- 원본 시트명: 해외옵션 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-040
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-time-optchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 분봉조회 API입니다.
+한 번의 호출에 120건까지 확인 가능하며, QRY_TP, INDEX_KEY 를 이용하여 다음조회 가능합니다.
+
+※ 다음조회 방법
+(처음조회) "QRY_TP":"Q", "QRY_CNT":"120", "INDEX_KEY":""
+(다음조회) "QRY_TP":"P", "QRY_CNT":"120", "INDEX_KEY":"20240902 5" ◀ 이전 호출의 "output1 > index_key" 기입
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55020400 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력
※ 날짜 입력해도 처리 안됨 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 120 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 1: 1분봉, 5: 5분봉 ... |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output1 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | |
+| data_time | 시간 | string | Y | 6 | |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5660
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:120
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output2": {
+ "ret_cnt": "0120",
+ "last_n_cnt": "",
+ "index_key": "20240820 29"
+ },
+ "output1": [
+ {
+ "data_date": "20240821",
+ "data_time": "031600",
+ "open_price": "6375",
+ "high_price": "6425",
+ "low_price": "6375",
+ "last_price": "6425",
+ "last_qntt": "18",
+ "vol": "251",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "75",
+ "prev_diff_rate": "1.18"
+ },
+ {
+ "data_date": "20240821",
+ "data_time": "043400",
+ "open_price": "6000",
+ "high_price": "6000",
+ "low_price": "6000",
+ "last_price": "6000",
+ "last_qntt": "2",
+ "vol": "253",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "-425",
+ "prev_diff_rate": "-6.61"
+ },
+ {
+ "data_date": "20240821",
+ "data_time": "044100",
+ "open_price": "6025",
+ "high_price": "6025",
+ "low_price": "6000",
+ "last_price": "6000",
+ "last_qntt": "4",
+ "vol": "257",
+ "prev_diff_flag": "3",
+ "prev_diff_price": "0",
+ "prev_diff_rate": "0.00"
+ },
+ {
+ "data_date": "20240821",
+ "data_time": "044700",
+ "open_price": "6025",
+ "high_price": "6025",
+ "low_price": "6025",
+ "last_price": "6025",
+ "last_qntt": "10",
+ "vol": "267",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "25",
+ "prev_diff_rate": "0.42"
+ },...
+ {
+ "data_date": "20240826",
+ "data_time": "141000",
+ "open_price": "6950",
+ "high_price": "6950",
+ "low_price": "6950",
+ "last_price": "6950",
+ "last_qntt": "1",
+ "vol": "1",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "-125",
+ "prev_diff_rate": "-1.77"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/310_해외선물-038_해외옵션-체결추이틱.md b/docs/broker/kis/rest/해외선물옵션/기본시세/310_해외선물-038_해외옵션-체결추이틱.md
new file mode 100644
index 0000000..fee457a
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/310_해외선물-038_해외옵션-체결추이틱.md
@@ -0,0 +1,175 @@
+# 해외옵션 체결추이(틱)
+
+- 원본 시트명: 해외옵션 체결추이(틱)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-038
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-tick-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(틱) API입니다.
+한 번의 호출에 40건까지 확인 가능하며, QRY_TP, INDEX_KEY 를 이용하여 다음조회 가능합니다.
+
+※ 다음조회 방법
+(처음조회) "QRY_TP":"Q", "QRY_CNT":"40", "INDEX_KEY":""
+(다음조회) "QRY_TP":"P", "QRY_CNT":"40", "INDEX_KEY":"20240906 221" ◀ 이전 호출의 "output1 > index_key" 기입
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55020200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력
※ 날짜 입력해도 처리 안됨 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | HHMMSS |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:30
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0030",
+ "last_n_cnt": "0001",
+ "index_key": "20240823 146"
+ },
+ "output2": [
+ {
+ "data_date": "20240824",
+ "data_time": "024037",
+ "open_price": "9900",
+ "high_price": "9900",
+ "low_price": "9900",
+ "last_price": "9900",
+ "last_qntt": "6",
+ "vol": "343",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "1700",
+ "prev_diff_rate": "20.73"
+ },
+ {
+ "data_date": "20240824",
+ "data_time": "024417",
+ "open_price": "10050",
+ "high_price": "10050",
+ "low_price": "10050",
+ "last_price": "10050",
+ "last_qntt": "6",
+ "vol": "349",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "1850",
+ "prev_diff_rate": "22.56"
+ },...
+ {
+ "data_date": "20240826",
+ "data_time": "081707",
+ "open_price": "10375",
+ "high_price": "10375",
+ "low_price": "10375",
+ "last_price": "10375",
+ "last_qntt": "1",
+ "vol": "7",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "-400",
+ "prev_diff_rate": "-3.71"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/311_해외선물-037_해외옵션-체결추이일간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/311_해외선물-037_해외옵션-체결추이일간.md
new file mode 100644
index 0000000..47e889f
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/311_해외선물-037_해외옵션-체결추이일간.md
@@ -0,0 +1,176 @@
+# 해외옵션 체결추이(일간)
+
+- 원본 시트명: 해외옵션 체결추이(일간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-037
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-daily-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(일간) API입니다.
+최근 120건까지 데이터 확인이 가능합니다. ("QRY_CNT: 119 입력", START_DATE_TIME, CLOSE_DATE_TIME은 공란)
+
+※ 호출 시 유의사항
+ : START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력, QRY_CNT는 확인 데이터 개수의 -1 개 입력
+ex) "START_DATE_TIME":"","CLOSE_DATE_TIME":"","QRY_CNT":"119" → 최근 120건 데이터 조회
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55020100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 100 (최대 119)
※ QRY_CNT 입력값의 +1 개 데이터가 조회됩니다. |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | "" 공란 입력
※ 다음조회 불가 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | ※ "input > QRY_CNT" +1 개 만큼 조회됨 |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5500
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:119
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0120",
+ "last_n_cnt": "",
+ "index_key": "20240308"
+ },
+ "output2": [
+ {
+ "data_date": "20240308",
+ "data_time": "",
+ "open_price": " 6600",
+ "high_price": " 6675",
+ "low_price": " 6600",
+ "last_price": " 6675",
+ "last_qntt": "",
+ "vol": " 20",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 800",
+ "prev_diff_rate": " 13.62"
+ },
+ {
+ "data_date": "20240311",
+ "data_time": "",
+ "open_price": " 5075",
+ "high_price": " 5100",
+ "low_price": " 5000",
+ "last_price": " 5100",
+ "last_qntt": "",
+ "vol": " 17",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 1575",
+ "prev_diff_rate": " -23.60"
+ },
+ ...
+ {
+ "data_date": "20240909",
+ "data_time": "",
+ "open_price": " 400",
+ "high_price": " 400",
+ "low_price": " 385",
+ "last_price": " 385",
+ "last_qntt": "",
+ "vol": " 2",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 50",
+ "prev_diff_rate": " 14.93"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/312_해외선물-036_해외옵션-체결추이주간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/312_해외선물-036_해외옵션-체결추이주간.md
new file mode 100644
index 0000000..62c90e9
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/312_해외선물-036_해외옵션-체결추이주간.md
@@ -0,0 +1,185 @@
+# 해외옵션 체결추이(주간)
+
+- 원본 시트명: 해외옵션 체결추이(주간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-036
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-weekly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(주간) API입니다.
+최근 120건까지 데이터 확인이 가능합니다. (START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력)
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55020000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 20 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | "" 공란 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:100
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0052",
+ "last_n_cnt": "",
+ "index_key": ""
+ },
+ "output2": [
+ {
+ "data_date": "20221128",
+ "data_time": "",
+ "open_price": " 5525",
+ "high_price": " 5550",
+ "low_price": " 5525",
+ "last_price": " 5525",
+ "last_qntt": "",
+ "vol": " 150",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 425",
+ "prev_diff_rate": " -7.14"
+ },
+ {
+ "data_date": "20221219",
+ "data_time": "",
+ "open_price": " 3650",
+ "high_price": " 3650",
+ "low_price": " 3650",
+ "last_price": " 3650",
+ "last_qntt": "",
+ "vol": " 25",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 1875",
+ "prev_diff_rate": " -33.94"
+ },
+ {
+ "data_date": "20230102",
+ "data_time": "",
+ "open_price": " 2900",
+ "high_price": " 2900",
+ "low_price": " 2825",
+ "last_price": " 2875",
+ "last_qntt": "",
+ "vol": " 225",
+ "prev_diff_flag": "5",
+ "prev_diff_price": " 775",
+ "prev_diff_rate": " -21.23"
+ },
+ ...
+ {
+ "data_date": "20240909",
+ "data_time": "",
+ "open_price": " 900",
+ "high_price": " 950",
+ "low_price": " 900",
+ "last_price": " 950",
+ "last_qntt": "",
+ "vol": " 26",
+ "prev_diff_flag": "2",
+ "prev_diff_price": " 145",
+ "prev_diff_rate": " 18.01"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/313_해외선물-039_해외옵션-체결추이월간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/313_해외선물-039_해외옵션-체결추이월간.md
new file mode 100644
index 0000000..e177560
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/313_해외선물-039_해외옵션-체결추이월간.md
@@ -0,0 +1,224 @@
+# 해외옵션 체결추이(월간)
+
+- 원본 시트명: 해외옵션 체결추이(월간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-039
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-monthly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(월간) API입니다.
+최근 120건까지 데이터 확인이 가능합니다. (START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력)
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55020300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500
※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 20 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | "" 공란 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ret_cnt | 자료개수 | string | Y | 4 | |
+| last_n_cnt | N틱최종개수 | string | Y | 4 | |
+| index_key | 이전조회KEY | string | Y | 30 | |
+| output2 | 응답상세 | object array | Y | | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 | |
+| high_price | 고가 | string | Y | 15 | |
+| low_price | 저가 | string | Y | 15 | |
+| last_price | 체결가격 | string | Y | 15 | 체결가격
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 | |
+| vol | 누적거래수량 | string | Y | 10 | |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 | |
+| prev_diff_price | 전일대비가격 | string | Y | 15 | |
+| prev_diff_rate | 전일대비율 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:20
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ret_cnt": "0016",
+ "last_n_cnt": "",
+ "index_key": ""
+ },
+ "output2": [
+ {
+ "data_date": "20221101",
+ "data_time": "",
+ "open_price": "5525",
+ "high_price": "5550",
+ "low_price": "5525",
+ "last_price": "5525",
+ "last_qntt": "",
+ "vol": "150",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "425",
+ "prev_diff_rate": "-7.14"
+ },
+ {
+ "data_date": "20221201",
+ "data_time": "",
+ "open_price": "3650",
+ "high_price": "3650",
+ "low_price": "3650",
+ "last_price": "3650",
+ "last_qntt": "",
+ "vol": "25",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "1875",
+ "prev_diff_rate": "-33.94"
+ },
+ {
+ "data_date": "20230101",
+ "data_time": "",
+ "open_price": "2900",
+ "high_price": "2900",
+ "low_price": "2825",
+ "last_price": "2875",
+ "last_qntt": "",
+ "vol": "225",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "775",
+ "prev_diff_rate": "-21.23"
+ },
+ {
+ "data_date": "20230901",
+ "data_time": "",
+ "open_price": "750",
+ "high_price": "750",
+ "low_price": "750",
+ "last_price": "750",
+ "last_qntt": "",
+ "vol": "2",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "2125",
+ "prev_diff_rate": "-73.91"
+ },
+ {
+ "data_date": "20231001",
+ "data_time": "",
+ "open_price": "630",
+ "high_price": "645",
+ "low_price": "320",
+ "last_price": "330",
+ "last_qntt": "",
+ "vol": "357",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "420",
+ "prev_diff_rate": "-56.00"
+ },
+ {
+ "data_date": "20231101",
+ "data_time": "",
+ "open_price": "360",
+ "high_price": "815",
+ "low_price": "360",
+ "last_price": "800",
+ "last_qntt": "",
+ "vol": "1230",
+ "prev_diff_flag": "2",
+ "prev_diff_price": "470",
+ "prev_diff_rate": "142.42"
+ },
+ ...
+ {
+ "data_date": "20240901",
+ "data_time": "",
+ "open_price": "9400",
+ "high_price": "10250",
+ "low_price": "805",
+ "last_price": "900",
+ "last_qntt": "",
+ "vol": "3985",
+ "prev_diff_flag": "5",
+ "prev_diff_price": "9000",
+ "prev_diff_rate": "-90.91"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/314_해외선물-041_해외옵션-상품기본정보.md b/docs/broker/kis/rest/해외선물옵션/기본시세/314_해외선물-041_해외옵션-상품기본정보.md
new file mode 100644
index 0000000..5284ffc
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/314_해외선물-041_해외옵션-상품기본정보.md
@@ -0,0 +1,194 @@
+# 해외옵션 상품기본정보
+
+- 원본 시트명: 해외옵션 상품기본정보
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-041
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55200000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/search-opt-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 상품기본정보 API입니다.
+한국투자 HTS(eFriend Plus) > [0054] 관심종목 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+ 1) focode.mst(해외지수옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+ 2) fostkcode.mst(해외주식옵션 종목마스터파일)
+ : 포럼 > FAQ > 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+ 품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFO55200000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| QRY_CNT | 요청개수 | string | Y | 32 | 입력한 코드 개수 |
+| SRS_CD_01 | 종목코드1 | string | Y | 32 | SRS_CD_01부터 차례로 입력(ex ) OESU24 C5500
최대 30개 까지 가능 |
+| SRS_CD_02... | 종목코드2 | string | Y | 32 | |
+| SRS_CD_30 | 종목코드30 | string | Y | 32 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | array |
+| exch_cd | 거래소코드 | string | Y | 10 | |
+| clas_cd | 품목종류 | string | Y | 1 | |
+| crc_cd | 거래통화 | string | Y | 10 | |
+| sttl_price | 정산가 | string | Y | 15 | 정산가
※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고
* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| sttl_date | 정산일 | string | Y | 8 | |
+| trst_mgn | 증거금 | string | Y | 19 | |
+| disp_digit | 가격표시진법 | string | Y | 10 | |
+| tick_sz | 틱사이즈 | string | Y | 19 | |
+| tick_val | 틱가치 | string | Y | 19 | |
+| mrkt_open_date | 장개시일자 | string | Y | 8 | |
+| mrkt_open_time | 장개시시각 | string | Y | 6 | |
+| mrkt_close_date | 장마감일자 | string | Y | 8 | |
+| mrkt_close_time | 장마감시각 | string | Y | 6 | |
+| trd_fr_date | 상장일 | string | Y | 8 | |
+| expr_date | 만기일 | string | Y | 8 | |
+| trd_to_date | 최종거래일 | string | Y | 8 | |
+| remn_cnt | 잔존일수 | string | Y | 4 | |
+| stat_tp | 매매여부 | string | Y | 1 | |
+| ctrt_size | 계약크기 | string | Y | 19 | |
+| stl_tp | 최종결제구분 | string | Y | 20 | |
+| frst_noti_date | 최초식별일 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+QRY_CNT:3
+SRS_CD_01:OESU24 C5600
+SRS_CD_02:OESU24 C5590
+SRS_CD_03:OESU24 C5580
+```
+
+### Response Example
+
+```text
+{
+ "output2": [
+ {
+ "exch_cd": "CME",
+ "clas_cd": "4",
+ "crc_cd": "USD",
+ "sttl_price": " 11000",
+ "sttl_date": "20240826",
+ "trst_mgn": " 7788",
+ "disp_digit": " 10",
+ "tick_sz": " 0",
+ "tick_val": " 2.5",
+ "mrkt_open_date": "20240826",
+ "mrkt_open_time": "000700",
+ "mrkt_close_date": "20240827",
+ "mrkt_close_time": "000600",
+ "trd_fr_date": "20240610",
+ "expr_date": "20240920",
+ "trd_to_date": "20240920",
+ "remn_cnt": "0026",
+ "stat_tp": "",
+ "ctrt_size": " 50",
+ "stl_tp": "현금결제",
+ "frst_noti_date": ""
+ },
+ {
+ "exch_cd": "CME",
+ "clas_cd": "4",
+ "crc_cd": "USD",
+ "sttl_price": " 11675",
+ "sttl_date": "20240826",
+ "trst_mgn": " 7788",
+ "disp_digit": " 10",
+ "tick_sz": " 0",
+ "tick_val": " 2.5",
+ "mrkt_open_date": "20240826",
+ "mrkt_open_time": "000700",
+ "mrkt_close_date": "20240827",
+ "mrkt_close_time": "000600",
+ "trd_fr_date": "20240610",
+ "expr_date": "20240920",
+ "trd_to_date": "20240920",
+ "remn_cnt": "0026",
+ "stat_tp": "",
+ "ctrt_size": " 50",
+ "stl_tp": "현금결제",
+ "frst_noti_date": ""
+ },
+ {
+ "exch_cd": "CME",
+ "clas_cd": "4",
+ "crc_cd": "USD",
+ "sttl_price": " 12400",
+ "sttl_date": "20240826",
+ "trst_mgn": " 7788",
+ "disp_digit": " 10",
+ "tick_sz": " 0",
+ "tick_val": " 2.5",
+ "mrkt_open_date": "20240826",
+ "mrkt_open_time": "000700",
+ "mrkt_close_date": "20240827",
+ "mrkt_close_time": "000600",
+ "trd_fr_date": "20240718",
+ "expr_date": "20240920",
+ "trd_to_date": "20240920",
+ "remn_cnt": "0026",
+ "stat_tp": "",
+ "ctrt_size": " 50",
+ "stl_tp": "현금결제",
+ "frst_noti_date": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/기본시세/315_해외선물-030_해외선물옵션-장운영시간.md b/docs/broker/kis/rest/해외선물옵션/기본시세/315_해외선물-030_해외선물옵션-장운영시간.md
new file mode 100644
index 0000000..1ca9e41
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/기본시세/315_해외선물-030_해외선물옵션-장운영시간.md
@@ -0,0 +1,399 @@
+# 해외선물옵션 장운영시간
+
+- 원본 시트명: 해외선물옵션 장운영시간
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-030
+- HTTP Method: GET
+- 실전 TR_ID: OTFM2229R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/market-time
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 장운영시간 API입니다.
+한국투자 HTS(eFriend Plus) > [6773] 해외선물 장운영시간 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM2229R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 | 공백 |
+| FM_CLAS_CD | FM클래스코드 | string | Y | 3 | '공백(전체), 001(통화), 002(금리), 003(지수),
004(농산물),005(축산물),006(금속),007(에너지)' |
+| FM_EXCG_CD | FM거래소코드 | string | Y | 10 | 'CME(CME), EUREX(EUREX), HKEx(HKEx),
ICE(ICE), SGX(SGX), OSE(OSE), ASX(ASX),
CBOE(CBOE), MDEX(MDEX), NYSE(NYSE),
BMF(BMF),FTX(FTX), HNX(HNX), ETC(기타)' |
+| OPT_YN | 옵션여부 | string | Y | 1 | %(전체), N(선물), Y(옵션) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | |
+| fm_pdgr_cd | FM상품군코드 | string | Y | 10 | |
+| fm_pdgr_name | FM상품군명 | string | Y | 60 | |
+| fm_excg_cd | FM거래소코드 | string | Y | 10 | |
+| fm_excg_name | FM거래소명 | string | Y | 60 | |
+| fuop_dvsn_name | 선물옵션구분명 | string | Y | 60 | |
+| fm_clas_cd | FM클래스코드 | string | Y | 3 | |
+| fm_clas_name | FM클래스명 | string | Y | 30 | |
+| am_mkmn_strt_tmd | 오전장운영시작시각 | string | Y | 6 | |
+| am_mkmn_end_tmd | 오전장운영종료시각 | string | Y | 6 | |
+| pm_mkmn_strt_tmd | 오후장운영시작시각 | string | Y | 6 | |
+| pm_mkmn_end_tmd | 오후장운영종료시각 | string | Y | 6 | |
+| mkmn_nxdy_strt_tmd | 장운영익일시작시각 | string | Y | 6 | |
+| mkmn_nxdy_end_tmd | 장운영익일종료시각 | string | Y | 6 | |
+| base_mket_strt_tmd | 기본시장시작시각 | string | Y | 6 | |
+| base_mket_end_tmd | 기본시장종료시각 | string | Y | 6 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FM_PDGR_CD:
+FM_CLAS_CD:
+FM_EXCG_CD:CME
+OPT_YN:%
+CTX_AREA_NK200:
+CTX_AREA_FK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk200": "CME^003^2ES^ ",
+ "ctx_area_fk200": "^CME^%^ ",
+ "output": [
+ {
+ "fm_pdgr_cd": "6A",
+ "fm_pdgr_name": "Australian Dollar",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6B",
+ "fm_pdgr_name": "British pounds",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6C",
+ "fm_pdgr_name": "Canadian Dollar",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6E",
+ "fm_pdgr_name": "Euro FX",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6J",
+ "fm_pdgr_name": "Japanese Yen",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6L",
+ "fm_pdgr_name": "Brazilian Real",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6M",
+ "fm_pdgr_name": "Mexican PESO",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6N",
+ "fm_pdgr_name": "NewZealand Dollars",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6S",
+ "fm_pdgr_name": "Swiss Franc",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "6Z",
+ "fm_pdgr_name": "South African Rand",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "E7",
+ "fm_pdgr_name": "E-mini Euro FX",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "J7",
+ "fm_pdgr_name": "E-Mini YEN",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "M6A",
+ "fm_pdgr_name": "E-micro AUD",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "M6B",
+ "fm_pdgr_name": "E-micro GBP",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "M6E",
+ "fm_pdgr_name": "E-micro EUR",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "MCD",
+ "fm_pdgr_name": "E-micro CAD",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },
+ {
+ "fm_pdgr_cd": "MJY",
+ "fm_pdgr_name": "E-micro JPY",
+ "fm_excg_cd": "CME",
+ "fm_excg_name": "Chicago Mercantile Exchange",
+ "fuop_dvsn_name": "선물",
+ "fm_clas_cd": "001",
+ "fm_clas_name": "통화",
+ "am_mkmn_strt_tmd": "070000",
+ "am_mkmn_end_tmd": "060000",
+ "pm_mkmn_strt_tmd": "",
+ "pm_mkmn_end_tmd": "",
+ "mkmn_nxdy_strt_tmd": "",
+ "mkmn_nxdy_end_tmd": "",
+ "base_mket_strt_tmd": "070000",
+ "base_mket_end_tmd": "060000"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0500",
+ "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오. "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/285_v1_해외선물-001_해외선물옵션-주문.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/285_v1_해외선물-001_해외선물옵션-주문.md
new file mode 100644
index 0000000..18ba0a0
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/285_v1_해외선물-001_해외선물옵션-주문.md
@@ -0,0 +1,121 @@
+# 해외선물옵션 주문
+
+- 원본 시트명: 해외선물옵션 주문
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-001
+- HTTP Method: POST
+- 실전 TR_ID: OTFM3001U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 주문 API 입니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
OTFM3001U : ASFM선물옵션주문신규 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_FUTR_FX_PDNO | 해외선물FX상품번호 | string | Y | 32 | |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| FM_LQD_USTL_CCLD_DT | FM청산미결제체결일자 | string | N | 8 | 빈칸 (hedge청산만 이용) |
+| FM_LQD_USTL_CCNO | FM청산미결제체결번호 | string | N | 10 | 빈칸 (hedge청산만 이용) |
+| PRIC_DVSN_CD | 가격구분코드 | string | Y | 1 | 1.지정, 2. 시장, 3. STOP, 4 S/L |
+| FM_LIMIT_ORD_PRIC | FMLIMIT주문가격 | string | Y | 20 | 지정가인 경우 가격 입력
* 시장가, STOP주문인 경우, 빈칸("") 입력 |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | Y | 20 | STOP 주문 가격 입력
* 시장가, 지정가인 경우, 빈칸("") 입력 |
+| FM_ORD_QTY | FM주문수량 | string | Y | 10 | |
+| FM_LQD_LMT_ORD_PRIC | FM청산LIMIT주문가격 | string | N | 20 | 빈칸 (hedge청산만 이용) |
+| FM_LQD_STOP_ORD_PRIC | FM청산STOP주문가격 | string | N | 20 | 빈칸 (hedge청산만 이용) |
+| CCLD_CNDT_CD | 체결조건코드 | string | Y | 1 | 일반적으로 6 (EOD, 지정가)
GTD인 경우 5, 시장가인 경우만 2 |
+| CPLX_ORD_DVSN_CD | 복합주문구분코드 | string | Y | 1 | 0 (hedge청산만 이용) |
+| ECIS_RSVN_ORD_YN | 행사예약주문여부 | string | Y | 1 | N |
+| FM_HDGE_ORD_SCRN_YN | FM_HEDGE주문화면여부 | string | Y | 1 | N |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | | object | N | | |
+| ORD_DT | 주문일자 | string | N | 8 | |
+| ODNO | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)
* 정정/취소시 문자열처럼 "0"을 포함해서 전송
(ex. ORGN_ODNO : 00360686) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "81012345",
+ "ACNT_PRDT_CD": "08",
+ "OVRS_FUTR_FX_PDNO": "6BZ22",
+ "SLL_BUY_DVSN_CD": "02",
+ "FM_LQD_USTL_CCLD_DT": "",
+ "FM_LQD_USTL_CCNO": "",
+ "PRIC_DVSN_CD": "1",
+ "FM_LIMIT_ORD_PRIC": "1.17",
+ "FM_STOP_ORD_PRIC": "",
+ "FM_ORD_QTY": "1",
+ "FM_LQD_LMT_ORD_PRIC": "",
+ "FM_LQD_STOP_ORD_PRIC": "",
+ "CCLD_CNDT_CD": "6",
+ "CPLX_ORD_DVSN_CD": "0",
+ "ECIS_RSVN_ORD_YN": "N",
+ "FM_HDGE_ORD_SCRN_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "ORD_DT": "20221214",
+ "ODNO": "00298040"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/286_v1_해외선물-002,-003_해외선물옵션-정정취소주문.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/286_v1_해외선물-002,-003_해외선물옵션-정정취소주문.md
new file mode 100644
index 0000000..a101b2e
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/286_v1_해외선물-002,-003_해외선물옵션-정정취소주문.md
@@ -0,0 +1,102 @@
+# 해외선물옵션 정정취소주문
+
+- 원본 시트명: 해외선물옵션 정정취소주문
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-002, 003
+- HTTP Method: POST
+- 실전 TR_ID: (정정) OTFM3002U (취소) OTFM3003U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/order-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 정정취소주문 API 입니다.
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
OTFM3002U : 해외선물옵션주문정정
OTFM3003U : 해외선물옵션주문취소 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ORGN_ORD_DT | 원주문일자 | string | Y | 8 | 원 주문 시 출력되는 ORD_DT 값을 입력 (현지거래일) |
+| ORGN_ODNO | 원주문번호 | string | Y | 8 | 정정/취소시 주문번호(ODNO) 8자리를 문자열처럼 "0"을 포함해서 전송 (원 주문 시 출력된 ODNO 값 활용)
(ex. ORGN_ODNO : 00360686) |
+| FM_LIMIT_ORD_PRIC | FMLIMIT주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_LQD_LMT_ORD_PRIC | FM청산LIMIT주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_LQD_STOP_ORD_PRIC | FM청산STOP주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_HDGE_ORD_SCRN_YN | FM_HEDGE주문화면여부 | string | Y | 1 | N |
+| FM_MKPR_CVSN_YN | FM시장가전환여부 | string | N | 1 | OTFM3003U(해외선물옵션주문취소)만 사용
※ FM_MKPR_CVSN_YN 항목에 'Y'로 설정하여 취소주문을 접수할 경우, 주문 취소확인이 들어오면 원장에서 시장가주문을 하나 또 내줌 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | | object | N | | |
+| ORD_DT | 주문일자 | string | N | 8 | YYYYMMDD(ex. 20230811) |
+| ODNO | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)
* 정정/취소시 문자열처럼 "0"을 포함해서 전송
(ex. ORGN_ODNO : 00360686) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "81012345",
+ "ACNT_PRDT_CD": "08",
+ "ORGN_ORD_DT": "20221214",
+ "ORGN_ODNO": "00298044",
+ "FM_MKPR_CVSN_YN": "N",
+ "FM_HDGE_ORD_SCRN_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "ORD_DT": "20221214",
+ "ODNO": "00298045"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/287_v1_해외선물-004_해외선물옵션-당일주문내역조회.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/287_v1_해외선물-004_해외선물옵션-당일주문내역조회.md
new file mode 100644
index 0000000..3ddeef3
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/287_v1_해외선물-004_해외선물옵션-당일주문내역조회.md
@@ -0,0 +1,261 @@
+# 해외선물옵션 당일주문내역조회
+
+- 원본 시트명: 해외선물옵션 당일주문내역조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-004
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3116R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 당일주문내역조회 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3116R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 01:전체 / 02:체결 / 03:미체결 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%:전체 / 01:매도 / 02:매수 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object array | N | | Array |
+| cano | 종합계좌번호 | string | N | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 | |
+| ord_dt | 주문일자 | string | N | 8 | |
+| odno | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)
* 정정/취소시 문자열처럼 "0"을 포함해서 전송
(ex. ORGN_ODNO : 00360686) |
+| orgn_ord_dt | 원주문일자 | string | N | 8 | |
+| orgn_odno | 원주문번호 | string | N | 8 | 원주문번호(ex. 00360685) |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 | |
+| rcit_dvsn_cd | 접수구분코드 | string | N | 2 | 05 온라인 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | 01:매도, 02:매수 |
+| trad_stgy_dvsn_cd | 매매전략구분코드 | string | N | 2 | |
+| bass_pric_type_cd | 기준가격유형코드 | string | N | 2 | 01 시가평가
02 액면가
03 기준가격
04 대용가 |
+| ord_stat_cd | 주문상태코드 | string | N | 2 | |
+| fm_ord_qty | FM주문수량 | string | N | 10 | |
+| fm_ord_pric | FM주문가격 | string | N | 20 | |
+| fm_stop_ord_pric | FMSTOP주문가격 | string | N | 20 | |
+| rsvn_dvsn | 예약구분 | string | N | 2 | |
+| fm_ccld_qty | FM체결수량 | string | N | 10 | |
+| fm_ccld_pric | FM체결가격 | string | N | 20 | |
+| fm_ord_rmn_qty | FM주문잔여수량 | string | N | 10 | |
+| ord_grp_name | 주문그룹명 | string | N | 60 | |
+| erlm_dtl_dtime | 등록상세일시 | string | N | 17 | |
+| ccld_dtl_dtime | 체결상세일시 | string | N | 17 | |
+| ord_stfno | 주문직원번호 | string | N | 6 | |
+| rmks1 | 비고1 | string | N | 100 | |
+| new_lqd_dvsn_cd | 신규청산구분코드 | string | N | 2 | 01 신규
02 청산 |
+| fm_lqd_lmt_ord_pric | FM청산LIMIT주문가격 | string | N | 20 | |
+| fm_lqd_stop_pric | FM청산STOP가격 | string | N | 20 | |
+| ccld_cndt_cd | 체결조건코드 | string | N | 1 | |
+| noti_vald_dt | 게시유효일자 | string | N | 8 | |
+| acnt_type_cd | 계좌유형코드 | string | N | 2 | |
+| fuop_dvsn | 선물옵션구분 | string | N | 2 | 01:선물, 02: 옵션 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "CCLD_NCCS_DVSN":"01",
+ "SLL_BUY_DVSN_CD":"01",
+ "FUOP_DVSN":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "81012345^08^01^02^00^ ",
+ "ctx_area_nk200": " ",
+ "output": [
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ord_dt": "20221214",
+ "odno": "00298048",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "rcit_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "trad_stgy_dvsn_cd": "00",
+ "bass_pric_type_cd": "1",
+ "ord_stat_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "1.1700",
+ "fm_stop_ord_pric": "0.0000",
+ "rsvn_dvsn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.0000",
+ "fm_ord_rmn_qty": "1",
+ "ord_grp_name": "",
+ "erlm_dtl_dtime": "20221214134455791",
+ "ccld_dtl_dtime": "",
+ "ord_stfno": "invent",
+ "rmks1": "",
+ "new_lqd_dvsn_cd": "1",
+ "fm_lqd_lmt_ord_pric": "0.0000",
+ "fm_lqd_stop_pric": "0.0000",
+ "ccld_cndt_cd": "6",
+ "noti_vald_dt": "",
+ "acnt_type_cd": "1",
+ "fuop_dvsn": "01"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ord_dt": "20221214",
+ "odno": "00298045",
+ "orgn_ord_dt": "20221214",
+ "orgn_odno": "00298044",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "rcit_dvsn_cd": "02",
+ "sll_buy_dvsn_cd": "02",
+ "trad_stgy_dvsn_cd": "00",
+ "bass_pric_type_cd": "1",
+ "ord_stat_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "0.0000",
+ "fm_stop_ord_pric": "0.0000",
+ "rsvn_dvsn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.0000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "erlm_dtl_dtime": "20221214134356649",
+ "ccld_dtl_dtime": "",
+ "ord_stfno": "invent",
+ "rmks1": "",
+ "new_lqd_dvsn_cd": "1",
+ "fm_lqd_lmt_ord_pric": "0.0000",
+ "fm_lqd_stop_pric": "0.0000",
+ "ccld_cndt_cd": "6",
+ "noti_vald_dt": "",
+ "acnt_type_cd": "1",
+ "fuop_dvsn": "01"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ord_dt": "20221214",
+ "odno": "00298044",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "rcit_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "trad_stgy_dvsn_cd": "00",
+ "bass_pric_type_cd": "1",
+ "ord_stat_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "1.1700",
+ "fm_stop_ord_pric": "0.0000",
+ "rsvn_dvsn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.0000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "erlm_dtl_dtime": "20221214134351411",
+ "ccld_dtl_dtime": "",
+ "ord_stfno": "invent",
+ "rmks1": "",
+ "new_lqd_dvsn_cd": "1",
+ "fm_lqd_lmt_ord_pric": "0.0000",
+ "fm_lqd_stop_pric": "0.0000",
+ "ccld_cndt_cd": "6",
+ "noti_vald_dt": "",
+ "acnt_type_cd": "1",
+ "fuop_dvsn": "01"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ord_dt": "20221214",
+ "odno": "00298040",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "rcit_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "trad_stgy_dvsn_cd": "00",
+ "bass_pric_type_cd": "1",
+ "ord_stat_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "1.1700",
+ "fm_stop_ord_pric": "0.0000",
+ "rsvn_dvsn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.0000",
+ "fm_ord_rmn_qty": "1",
+ "ord_grp_name": "",
+ "erlm_dtl_dtime": "20221214134100992",
+ "ccld_dtl_dtime": "",
+ "ord_stfno": "invent",
+ "rmks1": "",
+ "new_lqd_dvsn_cd": "1",
+ "fm_lqd_lmt_ord_pric": "0.0000",
+ "fm_lqd_stop_pric": "0.0000",
+ "ccld_cndt_cd": "6",
+ "noti_vald_dt": "",
+ "acnt_type_cd": "1",
+ "fuop_dvsn": "01"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/288_v1_해외선물-005_해외선물옵션-미결제내역조회잔고.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/288_v1_해외선물-005_해외선물옵션-미결제내역조회잔고.md
new file mode 100644
index 0000000..e3d605e
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/288_v1_해외선물-005_해외선물옵션-미결제내역조회잔고.md
@@ -0,0 +1,177 @@
+# 해외선물옵션 미결제내역조회(잔고)
+
+- 원본 시트명: 해외선물옵션 미결제내역조회(잔고)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-005
+- HTTP Method: GET
+- 실전 TR_ID: OTFM1412R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-unpd
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 미결제내역조회(잔고) API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM1412R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00: 전체 / 01:선물 / 02: 옵션 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object array | N | | Array |
+| cano | 종합계좌번호 | string | N | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 | |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 | |
+| prdt_type_cd | 상품유형코드 | string | N | 3 | |
+| crcy_cd | 통화코드 | string | N | 3 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | |
+| fm_ustl_qty | FM미결제수량 | string | N | 10 | |
+| fm_ccld_avg_pric | FM체결평균가격 | string | N | 20 | |
+| fm_now_pric | FM현재가격 | string | N | 20 | |
+| fm_evlu_pfls_amt | FM평가손익금액 | string | N | 20 | |
+| fm_opt_evlu_amt | FM옵션평가금액 | string | N | 20 | |
+| fm_otp_evlu_pfls_amt | FM옵션평가손익금액 | string | N | 20 | |
+| fuop_dvsn | 선물옵션구분 | string | N | 2 | |
+| ecis_rsvn_ord_yn | 행사예약주문여부 | string | N | 1 | |
+| fm_lqd_psbl_qty | FM청산가능수량 | string | N | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "FUOP_DVSN":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "81012345^08^00^ ",
+ "ctx_area_nk100": " ",
+ "output": [
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6AZ22",
+ "prdt_type_cd": "600",
+ "crcy_cd": "USD",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ustl_qty": "2",
+ "fm_ccld_avg_pric": "0.62950",
+ "fm_now_pric": "0.68320",
+ "fm_evlu_pfls_amt": "10740.00",
+ "fm_opt_evlu_amt": "",
+ "fm_otp_evlu_pfls_amt": "",
+ "fuop_dvsn": "01",
+ "ecis_rsvn_ord_yn": "",
+ "fm_lqd_psbl_qty": "2"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "prdt_type_cd": "600",
+ "crcy_cd": "USD",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ustl_qty": "2",
+ "fm_ccld_avg_pric": "1.1898",
+ "fm_now_pric": "1.2350",
+ "fm_evlu_pfls_amt": "5656.24",
+ "fm_opt_evlu_amt": "",
+ "fm_otp_evlu_pfls_amt": "",
+ "fuop_dvsn": "01",
+ "ecis_rsvn_ord_yn": "",
+ "fm_lqd_psbl_qty": "2"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6JZ22",
+ "prdt_type_cd": "600",
+ "crcy_cd": "USD",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ustl_qty": "1",
+ "fm_ccld_avg_pric": "6925.0",
+ "fm_now_pric": "7383.0",
+ "fm_evlu_pfls_amt": "5725.00",
+ "fm_opt_evlu_amt": "",
+ "fm_otp_evlu_pfls_amt": "",
+ "fuop_dvsn": "01",
+ "ecis_rsvn_ord_yn": "",
+ "fm_lqd_psbl_qty": "1"
+ },
+ {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "ZBZ22",
+ "prdt_type_cd": "600",
+ "crcy_cd": "USD",
+ "sll_buy_dvsn_cd": "01",
+ "fm_ustl_qty": "100",
+ "fm_ccld_avg_pric": "132.293125",
+ "fm_now_pric": "131.218750",
+ "fm_evlu_pfls_amt": "107438.00",
+ "fm_opt_evlu_amt": "",
+ "fm_otp_evlu_pfls_amt": "",
+ "fuop_dvsn": "01",
+ "ecis_rsvn_ord_yn": "",
+ "fm_lqd_psbl_qty": "100"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/289_v1_해외선물-006_해외선물옵션-주문가능조회.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/289_v1_해외선물-006_해외선물옵션-주문가능조회.md
new file mode 100644
index 0000000..544c695
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/289_v1_해외선물-006_해외선물옵션-주문가능조회.md
@@ -0,0 +1,114 @@
+# 해외선물옵션 주문가능조회
+
+- 원본 시트명: 해외선물옵션 주문가능조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-006
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3304R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-psamount
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 주문가능조회 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3304R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_FUTR_FX_PDNO | 해외선물FX상품번호 | string | Y | 32 | |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도 / 02 : 매수 |
+| FM_ORD_PRIC | FM주문가격 | string | Y | 20 | |
+| ECIS_RSVN_ORD_YN | 행사예약주문여부 | string | Y | 1 | N |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | N | | |
+| cano | 종합계좌번호 | string | N | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 | |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 | |
+| crcy_cd | 통화코드 | string | N | 3 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | |
+| fm_ustl_qty | FM미결제수량 | string | N | 10 | |
+| fm_lqd_psbl_qty | FM청산가능수량 | string | N | 10 | |
+| fm_new_ord_psbl_qty | FM신규주문가능수량 | string | N | 10 | |
+| fm_tot_ord_psbl_qty | FM총주문가능수량 | string | N | 10 | |
+| fm_mkpr_tot_ord_psbl_qty | FM시장가총주문가능수량 | string | N | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "OVRS_FUTR_FX_PDNO":"6AU22",
+ "SLL_BUY_DVSN_CD":"02",
+ "FM_ORD_PRIC":"",
+ "ECIS_RSVN_ORD_YN":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6AU22",
+ "crcy_cd": "",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ustl_qty": "0",
+ "fm_lqd_psbl_qty": "0",
+ "fm_new_ord_psbl_qty": "3717",
+ "fm_tot_ord_psbl_qty": "3717",
+ "fm_mkpr_tot_ord_psbl_qty": "3717"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/290_해외선물-010_해외선물옵션-기간계좌손익-일별.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/290_해외선물-010_해외선물옵션-기간계좌손익-일별.md
new file mode 100644
index 0000000..81e340a
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/290_해외선물-010_해외선물옵션-기간계좌손익-일별.md
@@ -0,0 +1,230 @@
+# 해외선물옵션 기간계좌손익 일별
+
+- 원본 시트명: 해외선물옵션 기간계좌손익 일별
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-010
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3118R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-period-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 기간계좌손익 일별 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3118R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| INQR_TERM_FROM_DT | 조회기간FROM일자 | string | Y | 8 | |
+| INQR_TERM_TO_DT | 조회기간TO일자 | string | Y | 8 | |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CRCY_CD | 통화코드 | string | Y | 3 | '%%% : 전체
TUS: TOT_USD / TKR: TOT_KRW
KRW: 한국 / USD: 미국
EUR: EUR / HKD: 홍콩
CNY: 중국 / JPY: 일본' |
+| WHOL_TRSL_YN | 전체환산여부 | string | Y | 1 | N |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object array | Y | | Array |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| fm_buy_qty | FM매수수량 | string | Y | 10 | |
+| fm_sll_qty | FM매도수량 | string | Y | 10 | |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 | |
+| fm_fee | FM수수료 | string | Y | 20 | |
+| fm_net_pfls_amt | FM순손익금액 | string | Y | 20 | |
+| fm_ustl_buy_qty | FM미결제매수수량 | string | Y | 10 | |
+| fm_ustl_sll_qty | FM미결제매도수량 | string | Y | 10 | |
+| fm_ustl_evlu_pfls_amt | FM미결제평가손익금액 | string | Y | 20 | |
+| fm_ustl_evlu_pfls_amt2 | FM미결제평가손익금액2 | string | Y | 20 | |
+| fm_ustl_evlu_pfls_icdc_amt | FM미결제평가손익증감금액 | string | Y | 20 | |
+| fm_ustl_agrm_amt | FM미결제약정금액 | string | Y | 20 | |
+| fm_opt_lqd_amt | FM옵션청산금액 | string | Y | 20 | |
+| output2 | 응답상세2 | object array | Y | | Array |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| fm_buy_qty | FM매수수량 | string | Y | 10 | |
+| fm_sll_qty | FM매도수량 | string | Y | 10 | |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 | |
+| fm_fee | FM수수료 | string | Y | 20 | |
+| fm_net_pfls_amt | FM순손익금액 | string | Y | 20 | |
+| fm_ustl_buy_qty | FM미결제매수수량 | string | Y | 10 | |
+| fm_ustl_sll_qty | FM미결제매도수량 | string | Y | 10 | |
+| fm_ustl_evlu_pfls_amt | FM미결제평가손익금액 | string | Y | 20 | |
+| fm_ustl_evlu_pfls_amt2 | FM미결제평가손익금액2 | string | Y | 20 | |
+| fm_ustl_evlu_pfls_icdc_amt | FM미결제평가손익증감금액 | string | Y | 20 | |
+| fm_ccld_avg_pric | FM체결평균가격 | string | Y | 20 | |
+| fm_ustl_agrm_amt | FM미결제약정금액 | string | Y | 20 | |
+| fm_opt_lqd_amt | FM옵션청산금액 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "INQR_TERM_FROM_DT":"20220901",
+ "INQR_TERM_TO_DT":"20221117",
+ "CRCY_CD":"%%%",
+ "WHOL_TRSL_YN":"N",
+ "FUOP_DVSN":"00",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": " ",
+ "ctx_area_nk200": " ",
+ "output1": [
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "crcy_cd": "USD",
+ "fm_buy_qty": "",
+ "fm_sll_qty": "",
+ "fm_lqd_pfls_amt": "0.00",
+ "fm_fee": "0.00",
+ "fm_net_pfls_amt": "129650.00",
+ "fm_ustl_buy_qty": "5",
+ "fm_ustl_sll_qty": "100",
+ "fm_ustl_evlu_pfls_amt": "129650.00",
+ "fm_ustl_evlu_pfls_amt2": "0.00",
+ "fm_ustl_evlu_pfls_icdc_amt": "129650.00",
+ "fm_ustl_agrm_amt": "13590493.75",
+ "fm_opt_lqd_amt": "0.00"
+ }
+ ],
+ "output2": [
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6AZ22",
+ "crcy_cd": "USD",
+ "fm_buy_qty": "",
+ "fm_sll_qty": "",
+ "fm_lqd_pfls_amt": "0.00",
+ "fm_fee": "0.00",
+ "fm_net_pfls_amt": "10850.00",
+ "fm_ustl_buy_qty": "2",
+ "fm_ustl_sll_qty": "",
+ "fm_ustl_evlu_pfls_amt": "10850.00",
+ "fm_ustl_evlu_pfls_amt2": "0.00",
+ "fm_ustl_evlu_pfls_icdc_amt": "10850.00",
+ "fm_ccld_avg_pric": "0.62950",
+ "fm_ustl_agrm_amt": "125900.00",
+ "fm_opt_lqd_amt": "0.00"
+ },
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6BZ22",
+ "crcy_cd": "USD",
+ "fm_buy_qty": "",
+ "fm_sll_qty": "",
+ "fm_lqd_pfls_amt": "0.00",
+ "fm_fee": "0.00",
+ "fm_net_pfls_amt": "5656.25",
+ "fm_ustl_buy_qty": "2",
+ "fm_ustl_sll_qty": "",
+ "fm_ustl_evlu_pfls_amt": "5656.25",
+ "fm_ustl_evlu_pfls_amt2": "0.00",
+ "fm_ustl_evlu_pfls_icdc_amt": "5656.25",
+ "fm_ccld_avg_pric": "1.1898",
+ "fm_ustl_agrm_amt": "148718.75",
+ "fm_opt_lqd_amt": "0.00"
+ },
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "6JZ22",
+ "crcy_cd": "USD",
+ "fm_buy_qty": "",
+ "fm_sll_qty": "",
+ "fm_lqd_pfls_amt": "0.00",
+ "fm_fee": "0.00",
+ "fm_net_pfls_amt": "5706.25",
+ "fm_ustl_buy_qty": "1",
+ "fm_ustl_sll_qty": "",
+ "fm_ustl_evlu_pfls_amt": "5706.25",
+ "fm_ustl_evlu_pfls_amt2": "0.00",
+ "fm_ustl_evlu_pfls_icdc_amt": "5706.25",
+ "fm_ccld_avg_pric": "6925.0",
+ "fm_ustl_agrm_amt": "86562.50",
+ "fm_opt_lqd_amt": "0.00"
+ },
+ {
+ "cano": "80012345",
+ "acnt_prdt_cd": "08",
+ "ovrs_futr_fx_pdno": "ZBZ22",
+ "crcy_cd": "USD",
+ "fm_buy_qty": "",
+ "fm_sll_qty": "",
+ "fm_lqd_pfls_amt": "0.00",
+ "fm_fee": "0.00",
+ "fm_net_pfls_amt": "107437.50",
+ "fm_ustl_buy_qty": "",
+ "fm_ustl_sll_qty": "100",
+ "fm_ustl_evlu_pfls_amt": "107437.50",
+ "fm_ustl_evlu_pfls_amt2": "0.00",
+ "fm_ustl_evlu_pfls_icdc_amt": "107437.50",
+ "fm_ccld_avg_pric": "132.293125",
+ "fm_ustl_agrm_amt": "13229312.50",
+ "fm_opt_lqd_amt": "0.00"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/291_해외선물-011_해외선물옵션-일별-체결내역.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/291_해외선물-011_해외선물옵션-일별-체결내역.md
new file mode 100644
index 0000000..59269ea
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/291_해외선물-011_해외선물옵션-일별-체결내역.md
@@ -0,0 +1,170 @@
+# 해외선물옵션 일별 체결내역
+
+- 원본 시트명: 해외선물옵션 일별 체결내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-011
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3122R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-daily-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 일별 체결내역 API입니다.
+거래소 체결 내역에 따라 , output1에 동일한 주문번호의 데이터들이 수신될 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3122R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| STRT_DT | 시작일자 | string | Y | 8 | 시작일자(YYYYMMDD) |
+| END_DT | 종료일자 | string | Y | 8 | 종료일자(YYYYMMDD) |
+| FUOP_DVSN_CD | 선물옵션구분코드 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 | 공란(Default) |
+| CRCY_CD | 통화코드 | string | Y | 3 | %%% : 전체
TUS: TOT_USD / TKR: TOT_KRW
KRW: 한국 / USD: 미국
EUR: EUR / HKD: 홍콩
CNY: 중국 / JPY: 일본
VND: 베트남 |
+| FM_ITEM_FTNG_YN | FM종목합산여부 | string | Y | 1 | "N"(Default) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%: 전체 / 01 : 매도 / 02 : 매수 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세2 | object | Y | | |
+| fm_tot_ccld_qty | FM총체결수량 | string | Y | 10 | |
+| fm_tot_futr_agrm_amt | FM총선물약정금액 | string | Y | 20 | |
+| fm_tot_opt_agrm_amt | FM총옵션약정금액 | string | Y | 20 | |
+| fm_fee_smtl | FM수수료합계 | string | Y | 20 | |
+| output1 | 응답상세1 | object array | Y | | Array |
+| dt | 일자 | string | Y | 8 | |
+| ccno | 체결번호 | string | Y | 8 | |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 3 | |
+| fm_ccld_qty | FM체결수량 | string | Y | 10 | |
+| fm_ccld_amt | FM체결금액 | string | Y | 20 | |
+| fm_futr_ccld_amt | FM선물체결금액 | string | Y | 20 | |
+| fm_opt_ccld_amt | FM옵션체결금액 | string | Y | 20 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| fm_fee | FM수수료 | string | Y | 20 | |
+| fm_futr_pure_agrm_amt | FM선물순약정금액 | string | Y | 20 | |
+| fm_opt_pure_agrm_amt | FM옵션순약정금액 | string | Y | 20 | |
+| ccld_dtl_dtime | 체결상세일시 | string | Y | 17 | |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| odno | 주문번호 | string | Y | 8 | 접수한 주문의 일련번호(ex. 00360686) |
+| ord_mdia_dvsn_name | 주문매체구분명 | string | Y | 60 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "STRT_DT":"20221010",
+ "END_DT":"20221216",
+ "FUOP_DVSN":"00",
+ "FM_PDGR_CD":"",
+ "CRCY_CD":"%%%",
+ "FM_ITEM_FTNG_YN":"N",
+ "SLL_BUY_DVSN_CD":"%%",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "80012345^08^20221010^20221216^00^^%%%^N^%%^ ",
+ "ctx_area_nk200": " ",
+ "output1": [
+ {
+ "dt": "20221020",
+ "ccno": "00004090",
+ "ovrs_futr_fx_pdno": "6AZ22",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ccld_qty": "1",
+ "fm_ccld_amt": ".62955",
+ "fm_futr_ccld_amt": "62955",
+ "fm_opt_ccld_amt": "0",
+ "crcy_cd": "USD",
+ "fm_fee": "12.5",
+ "fm_futr_pure_agrm_amt": "62967.5",
+ "fm_opt_pure_agrm_amt": "0",
+ "ccld_dtl_dtime": "20221020132204282",
+ "ord_dt": "20221020",
+ "odno": "00284471",
+ "ord_mdia_dvsn_name": "일반"
+ },
+ {
+ "dt": "20221020",
+ "ccno": "00004089",
+ "ovrs_futr_fx_pdno": "6AZ22",
+ "sll_buy_dvsn_cd": "02",
+ "fm_ccld_qty": "1",
+ "fm_ccld_amt": ".62945",
+ "fm_futr_ccld_amt": "62945",
+ "fm_opt_ccld_amt": "0",
+ "crcy_cd": "USD",
+ "fm_fee": "12.5",
+ "fm_futr_pure_agrm_amt": "62957.5",
+ "fm_opt_pure_agrm_amt": "0",
+ "ccld_dtl_dtime": "20221020125948252",
+ "ord_dt": "20221020",
+ "odno": "00284466",
+ "ord_mdia_dvsn_name": "일반"
+ }
+ ],
+ "output2": {
+ "fm_tot_ccld_qty": "2",
+ "fm_tot_futr_agrm_amt": "125900",
+ "fm_tot_opt_agrm_amt": "0",
+ "fm_fee_smtl": "25"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/292_해외선물-012_해외선물옵션-예수금현황.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/292_해외선물-012_해외선물옵션-예수금현황.md
new file mode 100644
index 0000000..e2659c7
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/292_해외선물-012_해외선물옵션-예수금현황.md
@@ -0,0 +1,140 @@
+# 해외선물옵션 예수금현황
+
+- 원본 시트명: 해외선물옵션 예수금현황
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-012
+- HTTP Method: GET
+- 실전 TR_ID: OTFM1411R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-deposit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 예수금현황 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM1411R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CRCY_CD | 통화코드 | string | Y | 3 | TUS: TOT_USD / TKR: TOT_KRW
KRW: 한국 / USD: 미국
EUR: EUR / HKD: 홍콩
CNY: 중국 / JPY: 일본
VND: 베트남 |
+| INQR_DT | 조회일자 | string | Y | 8 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| fm_nxdy_dncl_amt | FM익일예수금액 | string | Y | 20 | |
+| fm_tot_asst_evlu_amt | FM총자산평가금액 | string | Y | 20 | |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| resp_dt | 응답일자 | string | Y | 8 | |
+| fm_dnca_rmnd | FM예수금잔액 | string | Y | 20 | |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 | |
+| fm_fee | FM수수료 | string | Y | 20 | |
+| fm_fuop_evlu_pfls_amt | FM선물옵션평가손익금액 | string | Y | 20 | |
+| fm_rcvb_amt | FM미수금액 | string | Y | 20 | |
+| fm_brkg_mgn_amt | FM위탁증거금액 | string | Y | 20 | |
+| fm_mntn_mgn_amt | FM유지증거금액 | string | Y | 20 | |
+| fm_add_mgn_amt | FM추가증거금액 | string | Y | 20 | |
+| fm_risk_rt | FM위험율 | string | Y | 10 | |
+| fm_ord_psbl_amt | FM주문가능금액 | string | Y | 20 | |
+| fm_drwg_psbl_amt | FM출금가능금액 | string | Y | 20 | |
+| fm_echm_rqrm_amt | FM환전요청금액 | string | Y | 20 | |
+| fm_drwg_prar_amt | FM출금예정금액 | string | Y | 20 | |
+| fm_opt_tr_chgs | FM옵션거래대금 | string | Y | 20 | |
+| fm_opt_icld_asst_evlu_amt | FM옵션포함자산평가금액 | string | Y | 20 | |
+| fm_opt_evlu_amt | FM옵션평가금액 | string | Y | 20 | |
+| fm_crcy_sbst_amt | FM통화대용금액 | string | Y | 20 | |
+| fm_crcy_sbst_use_amt | FM통화대용사용금액 | string | Y | 20 | |
+| fm_crcy_sbst_stup_amt | FM통화대용설정금액 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "CRCY_CD":":"KRW",
+ "INQR_DT":"20221214"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "cano": "81012345",
+ "acnt_prdt_cd": "08",
+ "crcy_cd": "KRW",
+ "resp_dt": "20230104",
+ "fm_dnca_rmnd": "9990000012",
+ "fm_lqd_pfls_amt": "0",
+ "fm_fee": "0",
+ "fm_nxdy_dncl_amt": "9990000012",
+ "fm_tot_asst_evlu_amt": "9990000012",
+ "fm_fuop_evlu_pfls_amt": "0",
+ "fm_rcvb_amt": "0",
+ "fm_brkg_mgn_amt": "0",
+ "fm_mntn_mgn_amt": "0",
+ "fm_add_mgn_amt": "0",
+ "fm_risk_rt": "0.00",
+ "fm_ord_psbl_amt": "9718323936",
+ "fm_drwg_psbl_amt": "9704739489",
+ "fm_echm_rqrm_amt": "0",
+ "fm_drwg_prar_amt": "0",
+ "fm_opt_tr_chgs": "0",
+ "fm_opt_icld_asst_evlu_amt": "9990000012",
+ "fm_opt_evlu_amt": "0",
+ "fm_crcy_sbst_amt": "0",
+ "fm_crcy_sbst_use_amt": "0",
+ "fm_crcy_sbst_stup_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/293_해외선물-013_해외선물옵션-일별-주문내역.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/293_해외선물-013_해외선물옵션-일별-주문내역.md
new file mode 100644
index 0000000..c2de44c
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/293_해외선물-013_해외선물옵션-일별-주문내역.md
@@ -0,0 +1,390 @@
+# 해외선물옵션 일별 주문내역
+
+- 원본 시트명: 해외선물옵션 일별 주문내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-013
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3120R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-daily-order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 일별 주문내역 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3120R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| STRT_DT | 시작일자 | string | Y | 8 | |
+| END_DT | 종료일자 | string | Y | 8 | |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 | |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 01:전체 / 02:체결 / 03:미체결 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%전체 / 01 : 매도 / 02 : 매수 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object array | Y | | Array |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| dt | 일자 | string | Y | 8 | |
+| ord_dt | 주문일자 | string | Y | 8 | |
+| odno | 주문번호 | string | Y | 8 | 접수한 주문의 일련번호(ex. 00360686)
* 정정/취소시 문자열처럼 "0"을 포함해서 전송
(ex. ORGN_ODNO : 00360686)
* 정정/취소시 문자열처럼 "0"을 포함해서 전송
(ex. ORGN_ODNO : 00360686) |
+| orgn_ord_dt | 원주문일자 | string | Y | 8 | |
+| orgn_odno | 원주문번호 | string | Y | 8 | 원주문번호(ex. 00360685) |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 | |
+| rvse_cncl_dvsn_cd | 정정취소구분코드 | string | Y | 2 | 청산체결이 없는 신규 00
청산체결이 없는 정정 01
청산체결이 없는 취소 02
청산체결이 있는 취소 02
청산체결이 있는 신규 03
청산체결이 있는 정정 04
행사 05
배정 06
소멸 07
만기 08 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| cplx_ord_dvsn_cd | 복합주문구분코드 | string | Y | 1 | |
+| pric_dvsn_cd | 가격구분코드 | string | Y | 1 | |
+| rcit_dvsn_cd | 접수구분코드 | string | Y | 2 | |
+| fm_ord_qty | FM주문수량 | string | Y | 10 | |
+| fm_ord_pric | FM주문가격 | string | Y | 20 | |
+| fm_stop_ord_pric | FMSTOP주문가격 | string | Y | 20 | |
+| ecis_rsvn_ord_yn | 행사예약주문여부 | string | Y | 1 | |
+| fm_ccld_qty | FM체결수량 | string | Y | 10 | |
+| fm_ccld_pric | FM체결가격 | string | Y | 20 | |
+| fm_ord_rmn_qty | FM주문잔여수량 | string | Y | 10 | |
+| ord_grp_name | 주문그룹명 | string | Y | 60 | |
+| rcit_dtl_dtime | 접수상세일시 | string | Y | 17 | |
+| ccld_dtl_dtime | 체결상세일시 | string | Y | 17 | |
+| ordr_emp_no | 주문자사원번호 | string | Y | 6 | |
+| rjct_rson_name | 거부사유명 | string | Y | 60 | |
+| ccld_cndt_cd | 체결조건코드 | string | Y | 1 | |
+| trad_end_dt | 매매종료일자 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO":"12345678",
+ "ACNT_PRDT_CD":"08",
+ "STRT_DT":"20220101",
+ "END_DT":"20221214",
+ "FM_PDGR_CD":"",
+ "CCLD_NCCS_DVSN":"01",
+ "SLL_BUY_DVSN_CD":"%%",
+ "FUOP_DVSN":"00",
+ "CTX_AREA_FK200":"",
+ "CTX_AREA_NK200":"",
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678^08^20231206^20231206^^01^%%^00^ ",
+ "ctx_area_nk200": " ",
+ "output": [
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362398",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6CZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "2",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "3",
+ "fm_ord_pric": "0.00000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "3",
+ "fm_ccld_pric": "0.73935",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206092306005",
+ "ccld_dtl_dtime": "20231206092306005",
+ "ordr_emp_no": "109171",
+ "rjct_rson_name": "",
+ "ccld_cndt_cd": "2",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362397",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6CZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "2",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "0.00000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "1",
+ "fm_ccld_pric": "0.73925",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206092247252",
+ "ccld_dtl_dtime": "20231206092247252",
+ "ordr_emp_no": "109171",
+ "rjct_rson_name": "",
+ "ccld_cndt_cd": "2",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362396",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6CZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "2",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "0.00000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "1",
+ "fm_ccld_pric": "0.73920",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206092123893",
+ "ccld_dtl_dtime": "20231206092123893",
+ "ordr_emp_no": "109171",
+ "rjct_rson_name": "",
+ "ccld_cndt_cd": "2",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362395",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6CZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "2",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "0.00000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "1",
+ "fm_ccld_pric": "0.73915",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206092039261",
+ "ccld_dtl_dtime": "20231206092039261",
+ "ordr_emp_no": "109171",
+ "rjct_rson_name": "",
+ "ccld_cndt_cd": "2",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362394",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "10YZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "2",
+ "rcit_dvsn_cd": "03",
+ "fm_ord_qty": "1",
+ "fm_ord_pric": "0.000",
+ "fm_stop_ord_pric": "0.000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "",
+ "ccld_dtl_dtime": "",
+ "ordr_emp_no": "109171",
+ "rjct_rson_name": "[정상적인거부]Text[Order price is outside bands 'Bid of 4269",
+ "ccld_cndt_cd": "2",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362393",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6AZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "1",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "2",
+ "fm_ord_pric": "0.65000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.00000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206091838237",
+ "ccld_dtl_dtime": "",
+ "ordr_emp_no": "45TesT",
+ "rjct_rson_name": "FCM 거부됨",
+ "ccld_cndt_cd": "6",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362392",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6AZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "1",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "2",
+ "fm_ord_pric": "0.65000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.00000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206091835180",
+ "ccld_dtl_dtime": "",
+ "ordr_emp_no": "45TesT",
+ "rjct_rson_name": "FCM 거부됨",
+ "ccld_cndt_cd": "6",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362391",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6AZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "1",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "2",
+ "fm_ord_pric": "0.65000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.00000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206083023955",
+ "ccld_dtl_dtime": "",
+ "ordr_emp_no": "45TesT",
+ "rjct_rson_name": "FCM 거부됨",
+ "ccld_cndt_cd": "6",
+ "trad_end_dt": ""
+ },
+ {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "dt": "20231206",
+ "ord_dt": "20231206",
+ "odno": "00362390",
+ "orgn_ord_dt": "",
+ "orgn_odno": "",
+ "ovrs_futr_fx_pdno": "6AZ23",
+ "rvse_cncl_dvsn_cd": "00",
+ "sll_buy_dvsn_cd": "02",
+ "cplx_ord_dvsn_cd": "0",
+ "pric_dvsn_cd": "1",
+ "rcit_dvsn_cd": "02",
+ "fm_ord_qty": "2",
+ "fm_ord_pric": "0.65000",
+ "fm_stop_ord_pric": "0.00000",
+ "ecis_rsvn_ord_yn": "N",
+ "fm_ccld_qty": "0",
+ "fm_ccld_pric": "0.00000",
+ "fm_ord_rmn_qty": "0",
+ "ord_grp_name": "",
+ "rcit_dtl_dtime": "20231206082401404",
+ "ccld_dtl_dtime": "",
+ "ordr_emp_no": "45TesT",
+ "rjct_rson_name": "FCM 거부됨",
+ "ccld_cndt_cd": "6",
+ "trad_end_dt": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/294_해외선물-014_해외선물옵션-기간계좌거래내역.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/294_해외선물-014_해외선물옵션-기간계좌거래내역.md
new file mode 100644
index 0000000..ebdaf4a
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/294_해외선물-014_해외선물옵션-기간계좌거래내역.md
@@ -0,0 +1,118 @@
+# 해외선물옵션 기간계좌거래내역
+
+- 원본 시트명: 해외선물옵션 기간계좌거래내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-014
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3114R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-period-trans
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 기간계좌거래내역 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3114R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| INQR_TERM_FROM_DT | 조회기간FROM일자 | string | Y | 8 | |
+| INQR_TERM_TO_DT | 조회기간TO일자 | string | Y | 8 | |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ACNT_TR_TYPE_CD | 계좌거래유형코드 | string | Y | 2 | 1: 전체, 2:입출금 , 3: 결제 |
+| CRCY_CD | 통화코드 | string | Y | 3 | '%%% : 전체
TUS: TOT_USD / TKR: TOT_KRW
KRW: 한국 / USD: 미국
EUR: EUR / HKD: 홍콩
CNY: 중국 / JPY: 일본
VND: 베트남 ' |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK100값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100값 : 다음페이지 조회시(2번째부터) |
+| PWD_CHK_YN | 비밀번호체크여부 | string | Y | 1 | 공란(Default) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object array | Y | | Array |
+| bass_dt | 기준일자 | string | Y | 8 | |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| fm_ldgr_inog_seq | FM원장출납순번 | string | Y | 10 | |
+| acnt_tr_type_name | 계좌거래유형명 | string | Y | 60 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| tr_itm_name | 거래항목명 | string | Y | 60 | |
+| fm_iofw_amt | FM입출금액 | string | Y | 20 | |
+| fm_fee | FM수수료 | string | Y | 20 | |
+| fm_tax_amt | FM세금금액 | string | Y | 20 | |
+| fm_sttl_amt | FM결제금액 | string | Y | 20 | |
+| fm_bf_dncl_amt | FM이전예수금액 | string | Y | 20 | |
+| fm_dncl_amt | FM예수금액 | string | Y | 20 | |
+| fm_rcvb_occr_amt | FM미수발생금액 | string | Y | 20 | |
+| fm_rcvb_pybk_amt | FM미수변제금액 | string | Y | 20 | |
+| ovdu_int_pybk_amt | 연체이자변제금액 | string | Y | 20 | |
+| rmks_text | 비고내용 | string | Y | 500 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "INQR_TERM_FROM_DT":"20220101",
+ "INQR_TERM_TO_DT":"20221214",
+ "CANO":"80012345",
+ "ACNT_PRDT_CD":"08",
+ "ACNT_TR_TYPE_CD":"%%",
+ "CRCY_CD":"%%%",
+ "CTX_AREA_FK100":"",
+ "CTX_AREA_NK100":"",
+ "PWD_CHK_YN":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "20220101^20221214^81012345^08^%%^%%%^ ",
+ "ctx_area_nk100": " ",
+ "output": [],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0560",
+ "msg1": "조회할 내용이 없습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외선물옵션/주문/계좌/295_해외선물-032_해외선물옵션-증거금상세.md b/docs/broker/kis/rest/해외선물옵션/주문/계좌/295_해외선물-032_해외선물옵션-증거금상세.md
new file mode 100644
index 0000000..cec3578
--- /dev/null
+++ b/docs/broker/kis/rest/해외선물옵션/주문/계좌/295_해외선물-032_해외선물옵션-증거금상세.md
@@ -0,0 +1,215 @@
+# 해외선물옵션 증거금상세
+
+- 원본 시트명: 해외선물옵션 증거금상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-032
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3115R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/margin-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 증거금상세 API입니다.
+한국투자 HTS(eFriend Plus) > [2711] 해외선물옵션 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+[증거금 상세설명]
+- SPAN, EUREX 증거금
+1. 가격변동증거금 : 보유하고 있는 미결제를 Product Class 별로 구간[SPAN-16구간, EUREX-29구간)손익 합계액 산출하며 최대손실구간의 금액을 해당 Class의 증거금으로 산정
+2. 스프레드증거금 : 보유하고 있는 미결제를 Product Class 별로 스프레드 산정하며 스프레드 증거금 적용
+** 스프레드 산정방법 : SPAN은 선물+옵션의 Delta Spread로 계산, EUREX는 선물의 Spread만 산정 보유중인 옵선가치를 평가하며 청산가치가 양수(고객미 수취할 금액이 있는 경우)에 해당하는 금액을 증거금에서 할인
+3. 옵션가격증거금 : 보유중인 옵션가치를 평가하여 청산가치가 양수(고객이 수취할 금액이 있는 경우)에 해당하는 금액을 증거금에서 할인
+**계산식 : MAXID, 온선평가대금 Class별 합계액) ** 산출된 값을 음수처리함 옵션 미결제약정에 대해 최소로 징구하는 증거금
+4. 옵선최소증거금 증거금 : 옵션 미결제약정에 대해 최소로 징구하는 증거금
+** SPAN : 매도옵선회소증거금(행사가별로 상미)과 매수옵선최소증거금(계약당 1Tick에 해당하는 금액)
+** EUREX : 매수옵선최소증거금(계약당 1Tick에 해당하는 금액)(EUREX는 매도옵션최소증거금이 가격변동증거금에 포함되어 있음)
+5. 일방해소증거금 : (기본개념)보유중인 포트폴리오 중에서 머느 일방향을 전량 청산했을 경우 잔존하는 미결제 약정의 최대손실가능액을 사전에 징구함
+가격상승포지션과 가격하락포지션에 대해 최불리증거금을 각각 산정하며 큰 금액을 증거금으로 장구
+* 가격장승포지션 : 선물매수포지션, 풋옵션매도포지션
+* 가격하락포지션 : 선물매도포지션, 콜옵션매도포지선
+
+- 일반 증거금
+1. 선물미결제증거금 : 선물미결제약정에 대해 계약당증거금율 적용
+2. 매도옵션미결제증거금 : 매도옵션미결제약정에 대해 옵선계약당 증거금을 적용
+** 옵션계약당증거금 : 각 종목별 최불리증거금액으로 해외 거래소에서 계산하며 제공되는 데이터임
+3. 매수옵션미결제증거금 : 매수옵션최소증거금으로 1Tick에 해당하는 금액을 적용
+
+- 주문 증거금
+1. 선물 주문증거금 : 선물 미체결주문에 대해 계약당 증거금을 적용(신규주문에 한해 징수)
+2. 매도옵션 주문증거금 : 옵션매도 미체결주문에 대해 계약당증거금을 적용(신규주문에 한해 징수)
+3. 매수옵션 주문증거금 : 옵션매수 미체결주문에 대해 최소증거금(Tick Value와 10 중에서 큰 금액)과 만기행사예약한 미체결주문에 대한 행사예약증거금을 징수
+4. 매수옵션 주문대금 : 옵션매수 미체결주문의 매수대금(주문가격을 기준으로 대금 산정, 시장가주문시 현재가 +50틱으로 매수대금 산정)
+5. 매수옵선행사예약증거금 : 옵선매수 미결제약정 중에서 행사예약한 수량에 대해 기초자산선물의 계약당 증거금을 징수
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3115R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| CRCY_CD | 통화코드 | string | Y | 3 | 'TKR(TOT_KRW), TUS(TOT_USD),
USD(미국달러), HKD(홍콩달러),
CNY(중국위안화), JPY )일본엔화), VND(베트남동)' |
+| INQR_DT | 조회일자 | string | Y | 8 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| cano | 종합계좌번호 | string | Y | 8 | |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| resp_dt | 응답일자 | string | Y | 8 | |
+| acnt_net_risk_mgna_aply_yn | 계좌순위험증거금적용여부 | string | Y | 1 | |
+| fm_ord_psbl_amt | FM주문가능금액 | string | Y | 20 | |
+| fm_add_mgn_amt | FM추가증거금액 | string | Y | 20 | |
+| fm_brkg_mgn_amt | FM위탁증거금액 | string | Y | 20 | |
+| fm_excc_brkg_mgn_amt | FM정산위탁증거금액 | string | Y | 20 | |
+| fm_ustl_mgn_amt | FM미결제증거금액 | string | Y | 20 | |
+| fm_mntn_mgn_amt | FM유지증거금액 | string | Y | 20 | |
+| fm_ord_mgn_amt | FM주문증거금액 | string | Y | 20 | |
+| fm_futr_ord_mgn_amt | FM선물주문증거금액 | string | Y | 20 | |
+| fm_opt_buy_ord_amt | FM옵션매수주문금액 | string | Y | 20 | |
+| fm_opt_sll_ord_mgn_amt | FM옵션매도주문증거금액 | string | Y | 20 | |
+| fm_opt_buy_ord_mgn_amt | FM옵션매수주문증거금액 | string | Y | 20 | |
+| fm_ecis_rsvn_mgn_amt | FM행사예약증거금액 | string | Y | 20 | |
+| fm_span_brkg_mgn_amt | FMSPAN위탁증거금액 | string | Y | 20 | |
+| fm_span_pric_altr_mgn_amt | FMSPAN가격변동증거금액 | string | Y | 20 | |
+| fm_span_term_sprd_mgn_amt | FMSPAN기간스프레드증거금액 | string | Y | 20 | |
+| fm_span_buy_opt_min_mgn_amt | FMSPAN옵션가격증거금액 | string | Y | 20 | |
+| fm_span_opt_min_mgn_amt | FMSPAN옵션최소증거금액 | string | Y | 20 | |
+| fm_span_tot_risk_mgn_amt | FMSPAN총위험증거금액 | string | Y | 20 | |
+| fm_span_mntn_mgn_amt | FMSPAN유지증거금액 | string | Y | 20 | |
+| fm_span_mntn_pric_altr_mgn_amt | FMSPAN유지가격변동증거금액 | string | Y | 20 | |
+| fm_span_mntn_term_sprd_mgn_amt | FMSPAN유지기간스프레드증거금액 | string | Y | 20 | |
+| fm_span_mntn_opt_pric_mgn_amt | FMSPAN유지옵션가격증거금액 | string | Y | 20 | |
+| fm_span_mntn_opt_min_mgn_amt | FMSPAN유지옵션최소증거금액 | string | Y | 20 | |
+| fm_span_mntn_tot_risk_mgn_amt | FMSPAN유지총위험증거금액 | string | Y | 20 | |
+| fm_eurx_brkg_mgn_amt | FMEUREX위탁증거금액 | string | Y | 20 | |
+| fm_eurx_pric_altr_mgn_amt | FMEUREX가격변동증거금액 | string | Y | 20 | |
+| fm_eurx_term_sprd_mgn_amt | FMEUREX기간스프레드증거금액 | string | Y | 20 | |
+| fm_eurx_opt_pric_mgn_amt | FMEUREX옵션가격증거금액 | string | Y | 20 | |
+| fm_eurx_buy_opt_min_mgn_amt | FMEUREX매수옵션최소증거금액 | string | Y | 20 | |
+| fm_eurx_tot_risk_mgn_amt | FMEUREX총위험증거금액 | string | Y | 20 | |
+| fm_eurx_mntn_mgn_amt | FMEUREX유지증거금액 | string | Y | 20 | |
+| fm_eurx_mntn_pric_altr_mgn_amt | FMEUREX유지가격변동증거금액 | string | Y | 20 | |
+| fm_eurx_mntn_term_sprd_mgn_amt | FMEUREX기간스프레드증거금액 | string | Y | 20 | |
+| fm_eurx_mntn_opt_pric_mgn_amt | FMEUREX유지옵션가격증거금액 | string | Y | 20 | |
+| fm_eurx_mntn_tot_risk_mgn_amt | FMEUREX유지총위험증거금액 | string | Y | 20 | |
+| fm_gnrl_brkg_mgn_amt | FM일반위탁증거금액 | string | Y | 20 | |
+| fm_futr_ustl_mgn_amt | FM선물미결제증거금액 | string | Y | 20 | |
+| fm_sll_opt_ustl_mgn_amt | FM매도옵션미결제증거금액 | string | Y | 20 | |
+| fm_buy_opt_ustl_mgn_amt | FM매수옵션미결제증거금액 | string | Y | 20 | |
+| fm_sprd_ustl_mgn_amt | FM스프레드미결제증거금액 | string | Y | 20 | |
+| fm_avg_dsct_mgn_amt | FMAVG할인증거금액 | string | Y | 20 | |
+| fm_gnrl_mntn_mgn_amt | FM일반유지증거금액 | string | Y | 20 | |
+| fm_futr_mntn_mgn_amt | FM선물유지증거금액 | string | Y | 20 | |
+| fm_opt_mntn_mgn_amt | FM옵션유지증거금액 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:08
+CRCY_CD:TKR
+INQR_DT:20240522
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "cano": "12345678",
+ "acnt_prdt_cd": "08",
+ "crcy_cd": "TKR",
+ "resp_dt": "20240522",
+ "acnt_net_risk_mgna_aply_yn": "Y",
+ "fm_ord_psbl_amt": "86128052",
+ "fm_add_mgn_amt": "0",
+ "fm_brkg_mgn_amt": "49082990",
+ "fm_excc_brkg_mgn_amt": "49082990",
+ "fm_ustl_mgn_amt": "49082990",
+ "fm_mntn_mgn_amt": "44620900",
+ "fm_ord_mgn_amt": "0",
+ "fm_futr_ord_mgn_amt": "0",
+ "fm_opt_buy_ord_amt": "0",
+ "fm_opt_sll_ord_mgn_amt": "0",
+ "fm_opt_buy_ord_mgn_amt": "0",
+ "fm_ecis_rsvn_mgn_amt": "0",
+ "fm_span_brkg_mgn_amt": "49082990",
+ "fm_span_pric_altr_mgn_amt": "49082990",
+ "fm_span_term_sprd_mgn_amt": "0",
+ "fm_span_buy_opt_min_mgn_amt": "0",
+ "fm_span_opt_min_mgn_amt": "0",
+ "fm_span_tot_risk_mgn_amt": "49082990",
+ "fm_span_mntn_mgn_amt": "44620900",
+ "fm_span_mntn_pric_altr_mgn_amt": "44620900",
+ "fm_span_mntn_term_sprd_mgn_amt": "0",
+ "fm_span_mntn_opt_pric_mgn_amt": "0",
+ "fm_span_mntn_opt_min_mgn_amt": "0",
+ "fm_span_mntn_tot_risk_mgn_amt": "44620900",
+ "fm_eurx_brkg_mgn_amt": "0",
+ "fm_eurx_pric_altr_mgn_amt": "0",
+ "fm_eurx_term_sprd_mgn_amt": "0",
+ "fm_eurx_opt_pric_mgn_amt": "0",
+ "fm_eurx_buy_opt_min_mgn_amt": "0",
+ "fm_eurx_tot_risk_mgn_amt": "0",
+ "fm_eurx_mntn_mgn_amt": "0",
+ "fm_eurx_mntn_pric_altr_mgn_amt": "0",
+ "fm_eurx_mntn_term_sprd_mgn_amt": "0",
+ "fm_eurx_mntn_opt_pric_mgn_amt": "0",
+ "fm_eurx_mntn_tot_risk_mgn_amt": "0",
+ "fm_gnrl_brkg_mgn_amt": "0",
+ "fm_futr_ustl_mgn_amt": "0",
+ "fm_sll_opt_ustl_mgn_amt": "0",
+ "fm_buy_opt_ustl_mgn_amt": "0",
+ "fm_sprd_ustl_mgn_amt": "0",
+ "fm_avg_dsct_mgn_amt": "0",
+ "fm_gnrl_mntn_mgn_amt": "0",
+ "fm_futr_mntn_mgn_amt": "0",
+ "fm_opt_mntn_mgn_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/252_해외주식-037_해외주식-체결추이.md b/docs/broker/kis/rest/해외주식/기본시세/252_해외주식-037_해외주식-체결추이.md
new file mode 100644
index 0000000..bc94843
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/252_해외주식-037_해외주식-체결추이.md
@@ -0,0 +1,145 @@
+# 해외주식 체결추이
+
+- 원본 시트명: 해외주식 체결추이
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식-037
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76200300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 체결추이 API입니다.
+한국투자 HTS(eFriend Plus) > [7625] 해외주식 체결추이 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76200300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| EXCD | 거래소명 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| KEYB | NEXT KEY BUFF | string | Y | 32 | 공백 |
+| TDAY | 당일전일구분 | string | Y | 1 | 0:전일, 1:당일 |
+| SYMB | 종목코드 | string | Y | 16 | 해외종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output2 | 응답상세 | object array | Y | | array |
+| khms | 한국기준시간 | string | Y | 6 | |
+| last | 체결가 | string | Y | 12 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| evol | 체결량 | string | Y | 10 | |
+| tvol | 거래량 | string | Y | 14 | |
+| mtyp | 시장구분 | string | Y | 1 | 0: 장중 1:장전 2:장후 |
+| pbid | 매수호가 | string | Y | 12 | |
+| pask | 매도호가 | string | Y | 12 | |
+| vpow | 체결강도 | string | Y | 10 | |
+| output1 | 응답상세 | object | Y | | |
+| rsym | 실시간조회종목코드 | string | Y | 16 | |
+| ZDIV | 소수점자리수 | string | Y | 1 | |
+| NREC | Record Count | string | Y | 4 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+AUTH:
+EXCD:NAS
+SYMB:AAPL
+TDAY:0
+KEYB:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "khms": "085957",
+ "last": "195.2000",
+ "sign": "5",
+ "diff": "3.2200",
+ "rate": "-1.62",
+ "evol": "30",
+ "tvol": "29159135",
+ "mtyp": "",
+ "pbid": "195.1500",
+ "pask": "195.6000",
+ "vpow": "71.66"
+ },
+ {
+ "khms": "085957",
+ "last": "195.2000",
+ "sign": "5",
+ "diff": "3.2200",
+ "rate": "-1.62",
+ "evol": "10",
+ "tvol": "29159105",
+ "mtyp": "",
+ "pbid": "195.1500",
+ "pask": "195.6000",
+ "vpow": "71.66"
+ },...
+ {
+ "khms": "085505",
+ "last": "195.2700",
+ "sign": "5",
+ "diff": "3.1500",
+ "rate": "-1.59",
+ "evol": "50",
+ "tvol": "29155328",
+ "mtyp": "",
+ "pbid": "195.2300",
+ "pask": "195.3000",
+ "vpow": "71.67"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/253_v1_해외주식-010_해외주식-기간별시세.md b/docs/broker/kis/rest/해외주식/기본시세/253_v1_해외주식-010_해외주식-기간별시세.md
new file mode 100644
index 0000000..1691fb3
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/253_v1_해외주식-010_해외주식-기간별시세.md
@@ -0,0 +1,1512 @@
+# 해외주식 기간별시세
+
+- 원본 시트명: 해외주식 기간별시세
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-010
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76240000
+- 모의 TR_ID: HHDFS76240000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-price/v1/quotations/dailyprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식의 기간별시세를 확인하는 API 입니다.
+실전계좌/모의계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
+
+해외주식 시세는 무료시세(지연체결가)만이 제공되며, API로는 유료시세(실시간체결가)를 받아보실 수 없습니다.
+
+해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
HHDFS76240000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | "" (Null 값 설정) |
+| EXCD | 거래소코드 | string | Y | 4 | HKS : 홍콩
NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
TSE : 도쿄
SHS : 상해
SZS : 심천
SHI : 상해지수
SZI : 심천지수
HSX : 호치민
HNX : 하노이 |
+| SYMB | 종목코드 | string | Y | 16 | 종목코드 (ex. TSLA) |
+| GUBN | 일/주/월구분 | string | Y | 1 | 0 : 일
1 : 주
2 : 월 |
+| BYMD | 조회기준일자 | string | Y | 8 | 조회기준일자(YYYYMMDD)
※ 공란 설정 시, 기준일 오늘 날짜로 설정 |
+| MODP | 수정주가반영여부 | string | Y | 1 | 0 : 미반영
1 : 반영 |
+| KEYB | NEXT KEY BUFF | string | N | 1 | 응답시 다음값이 있으면 값이 셋팅되어 있으므로 다음 조회시 응답값 그대로 셋팅 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output1 | 응답상세1 | object | Y | | |
+| rsym | 실시간조회종목코드 | string | Y | 16 | D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이 |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| nrec | 전일종가 | string | Y | 12 | |
+| output2 | 응답상세2 | object array | Y | | |
+| xymd | 일자(YYYYMMDD) | string | Y | 8 | |
+| clos | 종가 | string | Y | 12 | 해당 일자의 종가 |
+| sign | 대비기호 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| diff | 대비 | string | Y | 12 | 해당 일자의 종가와 해당 전일 종가의 차이 (해당일 종가-해당 전일 종가) |
+| rate | 등락율 | string | Y | 12 | 해당 전일 대비 / 해당일 종가 * 100 |
+| open | 시가 | string | Y | 12 | 해당일 최초 거래가격 |
+| high | 고가 | string | Y | 12 | 해당일 가장 높은 거래가격 |
+| low | 저가 | string | Y | 12 | 해당일 가장 낮은 거래가격 |
+| tvol | 거래량 | string | Y | 14 | 해당일 거래량 |
+| tamt | 거래대금 | string | Y | 14 | 해당일 거래대금 |
+| pbid | 매수호가 | string | Y | 12 | 마지막 체결이 발생한 시점의 매수호가
* 해당 일자 거래량 0인 경우 값이 수신되지 않음 |
+| vbid | 매수호가잔량 | string | Y | 10 | * 해당 일자 거래량 0인 경우 값이 수신되지 않음 |
+| pask | 매도호가 | string | Y | 12 | 마지막 체결이 발생한 시점의 매도호가
* 해당 일자 거래량 0인 경우 값이 수신되지 않음 |
+| vask | 매도호가잔량 | string | Y | 10 | * 해당 일자 거래량 0인 경우 값이 수신되지 않음 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"AUTH": "",
+"EXCD": "NAS",
+"SYMB": "TSLA",
+"GUBN": "0",
+"BYMD": "",
+"MODP": "0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "rsym": "DNASTSLA",
+ "zdiv": "4",
+ "nrec": "100"
+ },
+ "output2": [
+ {
+ "xymd": "20220406",
+ "clos": "1045.7600",
+ "sign": "5",
+ "diff": "45.5000",
+ "rate": "-4.17",
+ "open": "1073.4700",
+ "high": "1079.0000",
+ "low": "1027.7000",
+ "tvol": "29782845",
+ "tamt": "31190274312",
+ "pbid": "1042.8900",
+ "vbid": "7",
+ "pask": "1043.2200",
+ "vask": "1"
+ },
+ {
+ "xymd": "20220405",
+ "clos": "1091.2600",
+ "sign": "5",
+ "diff": "54.1900",
+ "rate": "-4.73",
+ "open": "1136.3000",
+ "high": "1152.8700",
+ "low": "1087.3000",
+ "tvol": "26691673",
+ "tamt": "29742125077",
+ "pbid": "1090.0000",
+ "vbid": "100",
+ "pask": "1090.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220404",
+ "clos": "1145.4500",
+ "sign": "2",
+ "diff": "60.8600",
+ "rate": "+5.61",
+ "open": "1089.3800",
+ "high": "1149.9100",
+ "low": "1072.5300",
+ "tvol": "27392567",
+ "tamt": "30743176589",
+ "pbid": "1143.3000",
+ "vbid": "300",
+ "pask": "1143.6000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220401",
+ "clos": "1084.5900",
+ "sign": "2",
+ "diff": "6.9900",
+ "rate": "+0.65",
+ "open": "1081.1500",
+ "high": "1094.7500",
+ "low": "1066.6400",
+ "tvol": "18087741",
+ "tamt": "19558845872",
+ "pbid": "1090.0100",
+ "vbid": "100",
+ "pask": "1090.7500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220331",
+ "clos": "1077.6000",
+ "sign": "5",
+ "diff": "16.3900",
+ "rate": "-1.50",
+ "open": "1094.5700",
+ "high": "1103.1399",
+ "low": "1076.6410",
+ "tvol": "16330919",
+ "tamt": "17799070958",
+ "pbid": "1079.2900",
+ "vbid": "100",
+ "pask": "1079.8000",
+ "vask": "400"
+ },
+ {
+ "xymd": "20220330",
+ "clos": "1093.9900",
+ "sign": "5",
+ "diff": "5.5800",
+ "rate": "-0.51",
+ "open": "1091.1700",
+ "high": "1113.9500",
+ "low": "1084.0000",
+ "tvol": "19955002",
+ "tamt": "21921529520",
+ "pbid": "1095.0100",
+ "vbid": "1000",
+ "pask": "1095.4900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220329",
+ "clos": "1099.5700",
+ "sign": "2",
+ "diff": "7.7300",
+ "rate": "+0.71",
+ "open": "1107.9900",
+ "high": "1114.7700",
+ "low": "1073.1100",
+ "tvol": "24538273",
+ "tamt": "26908896769",
+ "pbid": "1096.0000",
+ "vbid": "700",
+ "pask": "1096.8800",
+ "vask": "700"
+ },
+ {
+ "xymd": "20220328",
+ "clos": "1091.8400",
+ "sign": "2",
+ "diff": "81.2000",
+ "rate": "+8.03",
+ "open": "1065.1000",
+ "high": "1097.8799",
+ "low": "1053.6000",
+ "tvol": "34168693",
+ "tamt": "36935543398",
+ "pbid": "1094.3000",
+ "vbid": "500",
+ "pask": "1094.7500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220325",
+ "clos": "1010.6400",
+ "sign": "5",
+ "diff": "3.2800",
+ "rate": "-0.32",
+ "open": "1008.0000",
+ "high": "1021.7999",
+ "low": "997.3201",
+ "tvol": "20677182",
+ "tamt": "20833543456",
+ "pbid": "1010.6000",
+ "vbid": "300",
+ "pask": "1011.5000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220324",
+ "clos": "1013.9200",
+ "sign": "2",
+ "diff": "14.8100",
+ "rate": "+1.48",
+ "open": "1009.7300",
+ "high": "1024.4900",
+ "low": "988.8000",
+ "tvol": "22973626",
+ "tamt": "23177427182",
+ "pbid": "1011.8500",
+ "vbid": "100",
+ "pask": "1012.0000",
+ "vask": "1800"
+ },
+ {
+ "xymd": "20220323",
+ "clos": "999.1100",
+ "sign": "2",
+ "diff": "5.1300",
+ "rate": "+0.52",
+ "open": "979.9400",
+ "high": "1040.7000",
+ "low": "976.4000",
+ "tvol": "40225383",
+ "tamt": "40613152436",
+ "pbid": "994.4100",
+ "vbid": "300",
+ "pask": "995.0000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220322",
+ "clos": "993.9800",
+ "sign": "2",
+ "diff": "72.8200",
+ "rate": "+7.91",
+ "open": "930.0000",
+ "high": "997.8600",
+ "low": "921.7500",
+ "tvol": "35289519",
+ "tamt": "33994169075",
+ "pbid": "986.5000",
+ "vbid": "300",
+ "pask": "987.0000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220321",
+ "clos": "921.1600",
+ "sign": "2",
+ "diff": "15.7700",
+ "rate": "+1.74",
+ "open": "914.9800",
+ "high": "942.8500",
+ "low": "907.0900",
+ "tvol": "27327216",
+ "tamt": "25211905771",
+ "pbid": "922.7000",
+ "vbid": "400",
+ "pask": "923.2000",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220318",
+ "clos": "905.3900",
+ "sign": "2",
+ "diff": "33.7900",
+ "rate": "+3.88",
+ "open": "874.4900",
+ "high": "907.8500",
+ "low": "867.3900",
+ "tvol": "33471397",
+ "tamt": "30178912165",
+ "pbid": "904.5000",
+ "vbid": "300",
+ "pask": "905.2500",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220317",
+ "clos": "871.6000",
+ "sign": "2",
+ "diff": "31.3700",
+ "rate": "+3.73",
+ "open": "830.9900",
+ "high": "875.0000",
+ "low": "825.7178",
+ "tvol": "22194324",
+ "tamt": "19011422979",
+ "pbid": "867.2100",
+ "vbid": "100",
+ "pask": "868.0400",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220316",
+ "clos": "840.2300",
+ "sign": "2",
+ "diff": "38.3400",
+ "rate": "+4.78",
+ "open": "809.0000",
+ "high": "842.0000",
+ "low": "802.2601",
+ "tvol": "28009607",
+ "tamt": "23198872371",
+ "pbid": "841.9500",
+ "vbid": "100",
+ "pask": "842.5000",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220315",
+ "clos": "801.8900",
+ "sign": "2",
+ "diff": "35.5200",
+ "rate": "+4.63",
+ "open": "775.2700",
+ "high": "805.5700",
+ "low": "756.5700",
+ "tvol": "22280381",
+ "tamt": "17560285765",
+ "pbid": "801.0000",
+ "vbid": "200",
+ "pask": "801.8000",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220314",
+ "clos": "766.3700",
+ "sign": "5",
+ "diff": "28.9800",
+ "rate": "-3.64",
+ "open": "780.6100",
+ "high": "800.7000",
+ "low": "756.0400",
+ "tvol": "23717421",
+ "tamt": "18350554191",
+ "pbid": "762.5100",
+ "vbid": "100",
+ "pask": "763.6900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220311",
+ "clos": "795.3500",
+ "sign": "5",
+ "diff": "42.9500",
+ "rate": "-5.12",
+ "open": "840.1970",
+ "high": "843.8020",
+ "low": "793.7700",
+ "tvol": "22345722",
+ "tamt": "18076185507",
+ "pbid": "794.6000",
+ "vbid": "100",
+ "pask": "794.9900",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220310",
+ "clos": "838.3000",
+ "sign": "5",
+ "diff": "20.6700",
+ "rate": "-2.41",
+ "open": "851.4500",
+ "high": "854.4500",
+ "low": "810.3601",
+ "tvol": "19549548",
+ "tamt": "16229710911",
+ "pbid": "836.2000",
+ "vbid": "800",
+ "pask": "836.5000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220309",
+ "clos": "858.9700",
+ "sign": "2",
+ "diff": "34.5700",
+ "rate": "+4.19",
+ "open": "839.4800",
+ "high": "860.5600",
+ "low": "832.0100",
+ "tvol": "19727993",
+ "tamt": "16782318027",
+ "pbid": "860.1000",
+ "vbid": "200",
+ "pask": "860.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220308",
+ "clos": "824.4000",
+ "sign": "2",
+ "diff": "19.8200",
+ "rate": "+2.46",
+ "open": "795.5300",
+ "high": "849.9900",
+ "low": "782.1700",
+ "tvol": "26799702",
+ "tamt": "22014058629",
+ "pbid": "819.5900",
+ "vbid": "100",
+ "pask": "820.8500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220307",
+ "clos": "804.5800",
+ "sign": "5",
+ "diff": "33.7100",
+ "rate": "-4.02",
+ "open": "856.3000",
+ "high": "866.1400",
+ "low": "804.5700",
+ "tvol": "24164724",
+ "tamt": "20086515519",
+ "pbid": "798.7500",
+ "vbid": "500",
+ "pask": "799.5700",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220304",
+ "clos": "838.2900",
+ "sign": "5",
+ "diff": "1.0000",
+ "rate": "-0.12",
+ "open": "849.1000",
+ "high": "855.6500",
+ "low": "825.1609",
+ "tvol": "22393287",
+ "tamt": "18802769433",
+ "pbid": "837.5000",
+ "vbid": "200",
+ "pask": "837.8600",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220303",
+ "clos": "839.2900",
+ "sign": "5",
+ "diff": "40.6000",
+ "rate": "-4.61",
+ "open": "878.7700",
+ "high": "886.4390",
+ "low": "832.6001",
+ "tvol": "20541169",
+ "tamt": "17565872720",
+ "pbid": "843.6500",
+ "vbid": "100",
+ "pask": "844.1500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220302",
+ "clos": "879.8900",
+ "sign": "2",
+ "diff": "15.5200",
+ "rate": "+1.80",
+ "open": "872.1300",
+ "high": "886.4800",
+ "low": "844.2721",
+ "tvol": "24881146",
+ "tamt": "21649806528",
+ "pbid": "871.0500",
+ "vbid": "100",
+ "pask": "871.9900",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220301",
+ "clos": "864.3700",
+ "sign": "5",
+ "diff": "6.0600",
+ "rate": "-0.70",
+ "open": "869.6800",
+ "high": "889.8800",
+ "low": "853.7800",
+ "tvol": "24922287",
+ "tamt": "21622906438",
+ "pbid": "861.5700",
+ "vbid": "100",
+ "pask": "862.3700",
+ "vask": "2500"
+ },
+ {
+ "xymd": "20220228",
+ "clos": "870.4300",
+ "sign": "2",
+ "diff": "60.5600",
+ "rate": "+7.48",
+ "open": "815.0100",
+ "high": "876.8600",
+ "low": "814.7075",
+ "tvol": "33002289",
+ "tamt": "28246358471",
+ "pbid": "870.0800",
+ "vbid": "500",
+ "pask": "870.4800",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220225",
+ "clos": "809.8700",
+ "sign": "2",
+ "diff": "9.1000",
+ "rate": "+1.14",
+ "open": "809.2300",
+ "high": "819.5000",
+ "low": "782.4005",
+ "tvol": "25355921",
+ "tamt": "20339391276",
+ "pbid": "809.9500",
+ "vbid": "200",
+ "pask": "810.0000",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220224",
+ "clos": "800.7700",
+ "sign": "2",
+ "diff": "36.7300",
+ "rate": "+4.81",
+ "open": "700.3900",
+ "high": "802.4800",
+ "low": "700.0000",
+ "tvol": "45107425",
+ "tamt": "34166549623",
+ "pbid": "798.4500",
+ "vbid": "100",
+ "pask": "799.0000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220223",
+ "clos": "764.0400",
+ "sign": "5",
+ "diff": "57.4900",
+ "rate": "-7.00",
+ "open": "830.4300",
+ "high": "835.2997",
+ "low": "760.5600",
+ "tvol": "31752336",
+ "tamt": "25094325267",
+ "pbid": "757.3000",
+ "vbid": "100",
+ "pask": "757.8000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220222",
+ "clos": "821.5300",
+ "sign": "5",
+ "diff": "35.4500",
+ "rate": "-4.14",
+ "open": "834.1300",
+ "high": "856.7338",
+ "low": "801.1001",
+ "tvol": "27762734",
+ "tamt": "23190823879",
+ "pbid": "823.0000",
+ "vbid": "100",
+ "pask": "824.0800",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220218",
+ "clos": "856.9800",
+ "sign": "5",
+ "diff": "19.3700",
+ "rate": "-2.21",
+ "open": "886.0000",
+ "high": "886.8700",
+ "low": "837.6100",
+ "tvol": "22833947",
+ "tamt": "19556715049",
+ "pbid": "854.8300",
+ "vbid": "100",
+ "pask": "854.9300",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220217",
+ "clos": "876.3500",
+ "sign": "5",
+ "diff": "47.0400",
+ "rate": "-5.09",
+ "open": "913.2600",
+ "high": "918.4999",
+ "low": "874.1000",
+ "tvol": "18392806",
+ "tamt": "16381253397",
+ "pbid": "874.0500",
+ "vbid": "100",
+ "pask": "874.9000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220216",
+ "clos": "923.3900",
+ "sign": "2",
+ "diff": "0.9600",
+ "rate": "+0.10",
+ "open": "914.0500",
+ "high": "926.4299",
+ "low": "901.2100",
+ "tvol": "17098132",
+ "tamt": "15630459694",
+ "pbid": "919.6000",
+ "vbid": "100",
+ "pask": "919.9900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220215",
+ "clos": "922.4300",
+ "sign": "2",
+ "diff": "46.6700",
+ "rate": "+5.33",
+ "open": "900.0000",
+ "high": "923.0000",
+ "low": "893.3774",
+ "tvol": "19216514",
+ "tamt": "17583891909",
+ "pbid": "919.9000",
+ "vbid": "100",
+ "pask": "920.2000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220214",
+ "clos": "875.7600",
+ "sign": "2",
+ "diff": "15.7600",
+ "rate": "+1.83",
+ "open": "861.5700",
+ "high": "898.8799",
+ "low": "853.1500",
+ "tvol": "22585472",
+ "tamt": "19771806435",
+ "pbid": "874.2200",
+ "vbid": "100",
+ "pask": "874.9000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220211",
+ "clos": "860.0000",
+ "sign": "5",
+ "diff": "44.5500",
+ "rate": "-4.93",
+ "open": "909.6300",
+ "high": "915.9600",
+ "low": "850.7000",
+ "tvol": "26548623",
+ "tamt": "23354363403",
+ "pbid": "860.3100",
+ "vbid": "200",
+ "pask": "860.7900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220210",
+ "clos": "904.5500",
+ "sign": "5",
+ "diff": "27.4500",
+ "rate": "-2.95",
+ "open": "908.3700",
+ "high": "943.8100",
+ "low": "896.7000",
+ "tvol": "22042277",
+ "tamt": "20302484250",
+ "pbid": "903.1400",
+ "vbid": "100",
+ "pask": "903.9800",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220209",
+ "clos": "932.0000",
+ "sign": "2",
+ "diff": "10.0000",
+ "rate": "+1.08",
+ "open": "935.0000",
+ "high": "946.2699",
+ "low": "920.0000",
+ "tvol": "17419848",
+ "tamt": "16264353533",
+ "pbid": "932.6100",
+ "vbid": "200",
+ "pask": "933.0000",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220208",
+ "clos": "922.0000",
+ "sign": "2",
+ "diff": "14.6600",
+ "rate": "+1.62",
+ "open": "905.5300",
+ "high": "926.2899",
+ "low": "894.8000",
+ "tvol": "16909671",
+ "tamt": "15469715617",
+ "pbid": "921.7500",
+ "vbid": "100",
+ "pask": "922.2500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220207",
+ "clos": "907.3400",
+ "sign": "5",
+ "diff": "15.9800",
+ "rate": "-1.73",
+ "open": "923.7900",
+ "high": "947.7700",
+ "low": "902.7089",
+ "tvol": "20331488",
+ "tamt": "18757045232",
+ "pbid": "908.7000",
+ "vbid": "100",
+ "pask": "909.0000",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220204",
+ "clos": "923.3200",
+ "sign": "2",
+ "diff": "32.1800",
+ "rate": "+3.61",
+ "open": "897.2200",
+ "high": "936.5000",
+ "low": "881.1700",
+ "tvol": "24541822",
+ "tamt": "22445587121",
+ "pbid": "921.5000",
+ "vbid": "1200",
+ "pask": "922.0000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220203",
+ "clos": "891.1400",
+ "sign": "5",
+ "diff": "14.5200",
+ "rate": "-1.60",
+ "open": "882.0000",
+ "high": "937.0000",
+ "low": "880.5200",
+ "tvol": "26285186",
+ "tamt": "23895432177",
+ "pbid": "906.5000",
+ "vbid": "100",
+ "pask": "907.3900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220202",
+ "clos": "905.6600",
+ "sign": "5",
+ "diff": "25.5900",
+ "rate": "-2.75",
+ "open": "928.1800",
+ "high": "931.5000",
+ "low": "889.4100",
+ "tvol": "22264345",
+ "tamt": "20251309655",
+ "pbid": "887.5000",
+ "vbid": "100",
+ "pask": "888.0000",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220201",
+ "clos": "931.2500",
+ "sign": "5",
+ "diff": "5.4700",
+ "rate": "-0.58",
+ "open": "935.2100",
+ "high": "943.7000",
+ "low": "905.0000",
+ "tvol": "24379446",
+ "tamt": "22603049750",
+ "pbid": "934.4000",
+ "vbid": "300",
+ "pask": "934.9900",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220131",
+ "clos": "936.7200",
+ "sign": "2",
+ "diff": "90.3700",
+ "rate": "+10.68",
+ "open": "872.7100",
+ "high": "937.9900",
+ "low": "862.0500",
+ "tvol": "34812032",
+ "tamt": "31796186854",
+ "pbid": "934.5000",
+ "vbid": "1000",
+ "pask": "934.9700",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220128",
+ "clos": "846.3500",
+ "sign": "2",
+ "diff": "17.2500",
+ "rate": "+2.08",
+ "open": "831.5600",
+ "high": "857.5000",
+ "low": "792.0100",
+ "tvol": "44929650",
+ "tamt": "37312553843",
+ "pbid": "847.6600",
+ "vbid": "100",
+ "pask": "848.4000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220127",
+ "clos": "829.1000",
+ "sign": "5",
+ "diff": "108.3100",
+ "rate": "-11.55",
+ "open": "933.3600",
+ "high": "935.3900",
+ "low": "829.0000",
+ "tvol": "49036523",
+ "tamt": "42522912142",
+ "pbid": "837.6200",
+ "vbid": "200",
+ "pask": "838.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220126",
+ "clos": "937.4100",
+ "sign": "2",
+ "diff": "19.0100",
+ "rate": "+2.07",
+ "open": "952.4300",
+ "high": "987.6900",
+ "low": "906.0000",
+ "tvol": "34955761",
+ "tamt": "33134684349",
+ "pbid": "932.5500",
+ "vbid": "100",
+ "pask": "933.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220125",
+ "clos": "918.4000",
+ "sign": "5",
+ "diff": "11.6000",
+ "rate": "-1.25",
+ "open": "914.2000",
+ "high": "951.2600",
+ "low": "903.2100",
+ "tvol": "28865302",
+ "tamt": "26613334628",
+ "pbid": "903.0000",
+ "vbid": "400",
+ "pask": "903.5500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220124",
+ "clos": "930.0000",
+ "sign": "5",
+ "diff": "13.9000",
+ "rate": "-1.47",
+ "open": "904.7600",
+ "high": "933.5131",
+ "low": "851.4700",
+ "tvol": "50791714",
+ "tamt": "45100773316",
+ "pbid": "926.2500",
+ "vbid": "500",
+ "pask": "926.6500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220121",
+ "clos": "943.9000",
+ "sign": "5",
+ "diff": "52.3700",
+ "rate": "-5.26",
+ "open": "996.3400",
+ "high": "1004.5500",
+ "low": "940.5000",
+ "tvol": "34472009",
+ "tamt": "33231719767",
+ "pbid": "939.8000",
+ "vbid": "100",
+ "pask": "940.0000",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220120",
+ "clos": "996.2700",
+ "sign": "2",
+ "diff": "0.6200",
+ "rate": "+0.06",
+ "open": "1009.7300",
+ "high": "1041.6600",
+ "low": "994.0000",
+ "tvol": "23496248",
+ "tamt": "23944890598",
+ "pbid": "989.9900",
+ "vbid": "200",
+ "pask": "991.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220119",
+ "clos": "995.6500",
+ "sign": "5",
+ "diff": "34.8600",
+ "rate": "-3.38",
+ "open": "1041.7050",
+ "high": "1054.6699",
+ "low": "995.0000",
+ "tvol": "25147496",
+ "tamt": "25534130239",
+ "pbid": "993.5100",
+ "vbid": "200",
+ "pask": "994.0000",
+ "vask": "700"
+ },
+ {
+ "xymd": "20220118",
+ "clos": "1030.5100",
+ "sign": "5",
+ "diff": "19.1000",
+ "rate": "-1.82",
+ "open": "1026.6050",
+ "high": "1070.7899",
+ "low": "1016.0600",
+ "tvol": "22329803",
+ "tamt": "23272387126",
+ "pbid": "1031.0000",
+ "vbid": "100",
+ "pask": "1031.9500",
+ "vask": "500"
+ },
+ {
+ "xymd": "20220114",
+ "clos": "1049.6100",
+ "sign": "2",
+ "diff": "18.0500",
+ "rate": "+1.75",
+ "open": "1019.8800",
+ "high": "1052.0000",
+ "low": "1013.3788",
+ "tvol": "24308137",
+ "tamt": "25162720831",
+ "pbid": "1049.9200",
+ "vbid": "100",
+ "pask": "1050.0900",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220113",
+ "clos": "1031.5600",
+ "sign": "5",
+ "diff": "74.6600",
+ "rate": "-6.75",
+ "open": "1109.0650",
+ "high": "1115.6000",
+ "low": "1026.5391",
+ "tvol": "32403264",
+ "tamt": "34906936185",
+ "pbid": "1034.1000",
+ "vbid": "200",
+ "pask": "1034.8400",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220112",
+ "clos": "1106.2200",
+ "sign": "2",
+ "diff": "41.8200",
+ "rate": "+3.93",
+ "open": "1078.8500",
+ "high": "1114.8400",
+ "low": "1072.5901",
+ "tvol": "27913005",
+ "tamt": "30590414517",
+ "pbid": "1107.1300",
+ "vbid": "100",
+ "pask": "1107.7300",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220111",
+ "clos": "1064.4000",
+ "sign": "2",
+ "diff": "6.2800",
+ "rate": "+0.59",
+ "open": "1053.6700",
+ "high": "1075.8500",
+ "low": "1038.8200",
+ "tvol": "22021070",
+ "tamt": "23353565457",
+ "pbid": "1060.5900",
+ "vbid": "100",
+ "pask": "1061.2800",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220110",
+ "clos": "1058.1200",
+ "sign": "2",
+ "diff": "31.1600",
+ "rate": "+3.03",
+ "open": "1000.0000",
+ "high": "1059.1000",
+ "low": "980.0000",
+ "tvol": "30604959",
+ "tamt": "31132010979",
+ "pbid": "1061.1500",
+ "vbid": "100",
+ "pask": "1061.9300",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220107",
+ "clos": "1026.9600",
+ "sign": "5",
+ "diff": "37.7400",
+ "rate": "-3.54",
+ "open": "1080.3700",
+ "high": "1080.9299",
+ "low": "1010.0000",
+ "tvol": "28054916",
+ "tamt": "29158872307",
+ "pbid": "1025.0000",
+ "vbid": "300",
+ "pask": "1025.2500",
+ "vask": "300"
+ },
+ {
+ "xymd": "20220106",
+ "clos": "1064.7000",
+ "sign": "5",
+ "diff": "23.4200",
+ "rate": "-2.15",
+ "open": "1077.0000",
+ "high": "1088.0000",
+ "low": "1020.5000",
+ "tvol": "30112158",
+ "tamt": "31965624488",
+ "pbid": "1066.7900",
+ "vbid": "100",
+ "pask": "1067.0000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20220105",
+ "clos": "1088.1200",
+ "sign": "5",
+ "diff": "61.4700",
+ "rate": "-5.35",
+ "open": "1146.6500",
+ "high": "1170.3400",
+ "low": "1081.0101",
+ "tvol": "26706599",
+ "tamt": "30187690088",
+ "pbid": "1079.0000",
+ "vbid": "200",
+ "pask": "1079.9500",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220104",
+ "clos": "1149.5900",
+ "sign": "5",
+ "diff": "50.1900",
+ "rate": "-4.18",
+ "open": "1189.5500",
+ "high": "1208.0000",
+ "low": "1123.0500",
+ "tvol": "33416086",
+ "tamt": "38836082001",
+ "pbid": "1147.5000",
+ "vbid": "500",
+ "pask": "1147.8900",
+ "vask": "200"
+ },
+ {
+ "xymd": "20220103",
+ "clos": "1199.7800",
+ "sign": "2",
+ "diff": "143.0000",
+ "rate": "+13.53",
+ "open": "1147.7500",
+ "high": "1201.0700",
+ "low": "1136.0400",
+ "tvol": "34895349",
+ "tamt": "40850633547",
+ "pbid": "1205.0200",
+ "vbid": "100",
+ "pask": "1205.4200",
+ "vask": "200"
+ },
+ {
+ "xymd": "20211231",
+ "clos": "1056.7800",
+ "sign": "5",
+ "diff": "13.5600",
+ "rate": "-1.27",
+ "open": "1073.4444",
+ "high": "1081.9999",
+ "low": "1054.5900",
+ "tvol": "13577875",
+ "tamt": "14495135610",
+ "pbid": "1060.0000",
+ "vbid": "900",
+ "pask": "1060.0500",
+ "vask": "400"
+ },
+ {
+ "xymd": "20211230",
+ "clos": "1070.3400",
+ "sign": "5",
+ "diff": "15.8500",
+ "rate": "-1.46",
+ "open": "1061.3300",
+ "high": "1095.5500",
+ "low": "1053.1500",
+ "tvol": "15680313",
+ "tamt": "16895880951",
+ "pbid": "1065.5100",
+ "vbid": "100",
+ "pask": "1066.0000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211229",
+ "clos": "1086.1900",
+ "sign": "5",
+ "diff": "2.2800",
+ "rate": "-0.21",
+ "open": "1098.6400",
+ "high": "1104.0000",
+ "low": "1064.1400",
+ "tvol": "18718015",
+ "tamt": "20304732279",
+ "pbid": "1082.6500",
+ "vbid": "100",
+ "pask": "1083.2500",
+ "vask": "400"
+ },
+ {
+ "xymd": "20211228",
+ "clos": "1088.4700",
+ "sign": "5",
+ "diff": "5.4700",
+ "rate": "-0.50",
+ "open": "1109.4900",
+ "high": "1118.9999",
+ "low": "1078.4200",
+ "tvol": "20107969",
+ "tamt": "21985026462",
+ "pbid": "1088.5000",
+ "vbid": "200",
+ "pask": "1089.2000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20211227",
+ "clos": "1093.9400",
+ "sign": "2",
+ "diff": "26.9400",
+ "rate": "+2.52",
+ "open": "1073.6700",
+ "high": "1117.0000",
+ "low": "1070.7152",
+ "tvol": "23715273",
+ "tamt": "26093712075",
+ "pbid": "1095.0000",
+ "vbid": "400",
+ "pask": "1095.5000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20211223",
+ "clos": "1067.0000",
+ "sign": "2",
+ "diff": "58.1300",
+ "rate": "+5.76",
+ "open": "1006.8000",
+ "high": "1072.9767",
+ "low": "997.5600",
+ "tvol": "30904429",
+ "tamt": "32322659050",
+ "pbid": "1065.1100",
+ "vbid": "200",
+ "pask": "1065.3800",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211222",
+ "clos": "1008.8700",
+ "sign": "2",
+ "diff": "70.3400",
+ "rate": "+7.49",
+ "open": "965.6600",
+ "high": "1015.6599",
+ "low": "957.0500",
+ "tvol": "31211362",
+ "tamt": "31022952137",
+ "pbid": "1011.5500",
+ "vbid": "400",
+ "pask": "1011.8500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211221",
+ "clos": "938.5300",
+ "sign": "2",
+ "diff": "38.5900",
+ "rate": "+4.29",
+ "open": "916.8700",
+ "high": "939.5000",
+ "low": "886.1200",
+ "tvol": "23839305",
+ "tamt": "21840827169",
+ "pbid": "934.5600",
+ "vbid": "100",
+ "pask": "935.5000",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211220",
+ "clos": "899.9400",
+ "sign": "5",
+ "diff": "32.6300",
+ "rate": "-3.50",
+ "open": "910.7000",
+ "high": "921.6884",
+ "low": "893.3900",
+ "tvol": "18826671",
+ "tamt": "17012127943",
+ "pbid": "901.5000",
+ "vbid": "200",
+ "pask": "902.4400",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211217",
+ "clos": "932.5700",
+ "sign": "2",
+ "diff": "5.6500",
+ "rate": "+0.61",
+ "open": "914.7700",
+ "high": "960.6599",
+ "low": "909.0401",
+ "tvol": "33626754",
+ "tamt": "31525298596",
+ "pbid": "934.6000",
+ "vbid": "100",
+ "pask": "935.1200",
+ "vask": "300"
+ },
+ {
+ "xymd": "20211216",
+ "clos": "926.9200",
+ "sign": "5",
+ "diff": "49.0700",
+ "rate": "-5.03",
+ "open": "994.5000",
+ "high": "994.9800",
+ "low": "921.8500",
+ "tvol": "27590483",
+ "tamt": "26096160964",
+ "pbid": "926.1000",
+ "vbid": "100",
+ "pask": "926.5000",
+ "vask": "1100"
+ },
+ {
+ "xymd": "20211215",
+ "clos": "975.9900",
+ "sign": "2",
+ "diff": "17.4800",
+ "rate": "+1.82",
+ "open": "953.2100",
+ "high": "978.7499",
+ "low": "928.2501",
+ "tvol": "25056410",
+ "tamt": "23881193367",
+ "pbid": "975.9000",
+ "vbid": "200",
+ "pask": "976.2500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211214",
+ "clos": "958.5100",
+ "sign": "5",
+ "diff": "7.9000",
+ "rate": "-0.82",
+ "open": "945.0000",
+ "high": "966.4100",
+ "low": "930.0000",
+ "tvol": "23602090",
+ "tamt": "22364807150",
+ "pbid": "957.1000",
+ "vbid": "100",
+ "pask": "957.6500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211213",
+ "clos": "966.4100",
+ "sign": "5",
+ "diff": "50.6200",
+ "rate": "-4.98",
+ "open": "1001.0900",
+ "high": "1005.0000",
+ "low": "951.4200",
+ "tvol": "26198502",
+ "tamt": "25425098410",
+ "pbid": "963.6100",
+ "vbid": "100",
+ "pask": "964.3600",
+ "vask": "200"
+ },
+ {
+ "xymd": "20211210",
+ "clos": "1017.0300",
+ "sign": "2",
+ "diff": "13.2300",
+ "rate": "+1.32",
+ "open": "1008.7500",
+ "high": "1020.9797",
+ "low": "982.5300",
+ "tvol": "19888122",
+ "tamt": "19981816818",
+ "pbid": "1015.0000",
+ "vbid": "900",
+ "pask": "1015.5700",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211209",
+ "clos": "1003.8000",
+ "sign": "5",
+ "diff": "65.1600",
+ "rate": "-6.10",
+ "open": "1060.6400",
+ "high": "1062.4900",
+ "low": "1002.3600",
+ "tvol": "19812832",
+ "tamt": "20343865631",
+ "pbid": "1005.5000",
+ "vbid": "100",
+ "pask": "1006.0000",
+ "vask": "300"
+ },
+ {
+ "xymd": "20211208",
+ "clos": "1068.9600",
+ "sign": "2",
+ "diff": "17.2100",
+ "rate": "+1.64",
+ "open": "1052.7100",
+ "high": "1072.3800",
+ "low": "1033.0001",
+ "tvol": "13968790",
+ "tamt": "14723658662",
+ "pbid": "1067.0000",
+ "vbid": "100",
+ "pask": "1067.9500",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211207",
+ "clos": "1051.7500",
+ "sign": "2",
+ "diff": "42.7400",
+ "rate": "+4.24",
+ "open": "1044.2000",
+ "high": "1057.6739",
+ "low": "1026.8100",
+ "tvol": "18694857",
+ "tamt": "19529382052",
+ "pbid": "1054.6700",
+ "vbid": "200",
+ "pask": "1054.9000",
+ "vask": "900"
+ },
+ {
+ "xymd": "20211206",
+ "clos": "1009.0100",
+ "sign": "5",
+ "diff": "5.9600",
+ "rate": "-0.59",
+ "open": "1001.5100",
+ "high": "1021.6400",
+ "low": "950.5000",
+ "tvol": "27221037",
+ "tamt": "26964573844",
+ "pbid": "1007.6500",
+ "vbid": "200",
+ "pask": "1008.1100",
+ "vask": "100"
+ },
+ {
+ "xymd": "20211203",
+ "clos": "1014.9700",
+ "sign": "5",
+ "diff": "69.6300",
+ "rate": "-6.42",
+ "open": "1084.7900",
+ "high": "1090.5753",
+ "low": "1000.2100",
+ "tvol": "30773995",
+ "tamt": "31668617672",
+ "pbid": "1010.2600",
+ "vbid": "200",
+ "pask": "1011.0000",
+ "vask": "200"
+ },
+ {
+ "xymd": "20211202",
+ "clos": "1084.6000",
+ "sign": "5",
+ "diff": "10.4000",
+ "rate": "-0
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/254_해외주식-017_해외결제일자조회.md b/docs/broker/kis/rest/해외주식/기본시세/254_해외주식-017_해외결제일자조회.md
new file mode 100644
index 0000000..e81f490
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/254_해외주식-017_해외결제일자조회.md
@@ -0,0 +1,188 @@
+# 해외결제일자조회
+
+- 원본 시트명: 해외결제일자조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식-017
+- HTTP Method: GET
+- 실전 TR_ID: CTOS5011R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/quotations/countries-holiday
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외결제일자조회 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTOS5011R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| TRAD_DT | 기준일자 | string | Y | 8 | 기준일자(YYYYMMDD) |
+| CTX_AREA_NK | 연속조회키 | string | Y | 20 | 공백으로 입력 |
+| CTX_AREA_FK | 연속조회검색조건 | string | Y | 20 | 공백으로 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | 512 미국 나스닥 / 513 미국 뉴욕거래소 / 529 미국 아멕스
515 일본
501 홍콩 / 543 홍콩CNY / 558 홍콩USD
507 베트남 하노이거래소 / 508 베트남 호치민거래소
551 중국 상해A / 552 중국 심천A |
+| tr_natn_cd | 거래국가코드 | string | Y | 3 | 840 미국 / 392 일본 / 344 홍콩
704 베트남 / 156 중국 |
+| tr_natn_name | 거래국가명 | string | Y | 60 | |
+| natn_eng_abrv_cd | 국가영문약어코드 | string | Y | 2 | US 미국 / JP 일본 / HK 홍콩
VN 베트남 / CN 중국 |
+| tr_mket_cd | 거래시장코드 | string | Y | 2 | |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| acpl_sttl_dt | 현지결제일자 | string | Y | 8 | 현지결제일자(YYYYMMDD) |
+| dmst_sttl_dt | 국내결제일자 | string | Y | 8 | 국내결제일자(YYYYMMDD) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "TRAD_DT":"20221227",
+ "CTX_AREA_NK":"",
+ "CTX_AREA_FK":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk": "20221227 ",
+ "ctx_area_nk": " ",
+ "output": [
+ {
+ "prdt_type_cd": "507",
+ "tr_natn_cd": "704",
+ "tr_natn_name": "베트남",
+ "natn_eng_abrv_cd": "VN",
+ "tr_mket_cd": "01",
+ "tr_mket_name": "하노이거래소",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221229"
+ },
+ {
+ "prdt_type_cd": "508",
+ "tr_natn_cd": "704",
+ "tr_natn_name": "베트남",
+ "natn_eng_abrv_cd": "VN",
+ "tr_mket_cd": "02",
+ "tr_mket_name": "호치민거래소",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221229"
+ },
+ {
+ "prdt_type_cd": "512",
+ "tr_natn_cd": "840",
+ "tr_natn_name": "미국",
+ "natn_eng_abrv_cd": "US",
+ "tr_mket_cd": "01",
+ "tr_mket_name": "나스닥",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221230"
+ },
+ {
+ "prdt_type_cd": "513",
+ "tr_natn_cd": "840",
+ "tr_natn_name": "미국",
+ "natn_eng_abrv_cd": "US",
+ "tr_mket_cd": "02",
+ "tr_mket_name": "뉴욕거래소",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221230"
+ },
+ {
+ "prdt_type_cd": "515",
+ "tr_natn_cd": "392",
+ "tr_natn_name": "일본",
+ "natn_eng_abrv_cd": "JP",
+ "tr_mket_cd": "01",
+ "tr_mket_name": "일본",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221229"
+ },
+ {
+ "prdt_type_cd": "527",
+ "tr_natn_cd": "840",
+ "tr_natn_name": "미국",
+ "natn_eng_abrv_cd": "US",
+ "tr_mket_cd": "03",
+ "tr_mket_name": "미국",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221230"
+ },
+ {
+ "prdt_type_cd": "528",
+ "tr_natn_cd": "840",
+ "tr_natn_name": "미국",
+ "natn_eng_abrv_cd": "US",
+ "tr_mket_cd": "04",
+ "tr_mket_name": "미국",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221230"
+ },
+ {
+ "prdt_type_cd": "529",
+ "tr_natn_cd": "840",
+ "tr_natn_name": "미국",
+ "natn_eng_abrv_cd": "US",
+ "tr_mket_cd": "05",
+ "tr_mket_name": "아멕스",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221230"
+ },
+ {
+ "prdt_type_cd": "556",
+ "tr_natn_cd": "704",
+ "tr_natn_name": "베트남",
+ "natn_eng_abrv_cd": "VN",
+ "tr_mket_cd": "03",
+ "tr_mket_name": "업콤거래소",
+ "acpl_sttl_dt": "20221229",
+ "dmst_sttl_dt": "20221229"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/255_v1_해외주식-009_해외주식-현재체결가.md b/docs/broker/kis/rest/해외주식/기본시세/255_v1_해외주식-009_해외주식-현재체결가.md
new file mode 100644
index 0000000..c151213
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/255_v1_해외주식-009_해외주식-현재체결가.md
@@ -0,0 +1,124 @@
+# 해외주식 현재체결가
+
+- 원본 시트명: 해외주식 현재체결가
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-009
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS00000300
+- 모의 TR_ID: HHDFS00000300
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-price/v1/quotations/price
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식종목의 현재체결가를 확인하는 API 입니다.
+
+해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
HHDFS00000300 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | "" (Null 값 설정) |
+| EXCD | 거래소코드 | string | Y | 4 | HKS : 홍콩
NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
TSE : 도쿄
SHS : 상해
SZS : 심천
SHI : 상해지수
SZI : 심천지수
HSX : 호치민
HNX : 하노이
BAY : 뉴욕(주간)
BAQ : 나스닥(주간)
BAA : 아멕스(주간) |
+| SYMB | 종목코드 | string | Y | 16 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | |
+| rsym | 실시간조회종목코드 | string | Y | 16 | D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이 |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| base | 전일종가 | string | Y | 12 | 전일의 종가 |
+| pvol | 전일거래량 | string | Y | 14 | 전일의 거래량 |
+| last | 현재가 | string | Y | 12 | 당일 조회시점의 현재 가격 |
+| sign | 대비기호 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| diff | 대비 | string | Y | 12 | 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가) |
+| rate | 등락율 | string | Y | 12 | 전일 대비 / 당일 현재가 * 100 |
+| tvol | 거래량 | string | Y | 14 | 당일 조회시점까지 전체 거래량 |
+| tamt | 거래대금 | string | Y | 14 | 당일 조회시점까지 전체 거래금액 |
+| ordy | 매수가능여부 | string | Y | 20 | 매수주문 가능 종목 여부 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"AUTH": "",
+"EXCD": "NAS",
+"SYMB": "TSLA"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "rsym": "DNASTSLA",
+ "zdiv": "4",
+ "base": "1091.2600",
+ "pvol": "26691673",
+ "last": "1091.2600",
+ "sign": "0",
+ "diff": "0.0000",
+ "rate": " 0.00",
+ "tvol": "0",
+ "tamt": "0",
+ "ordy": "매도불가"
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md b/docs/broker/kis/rest/해외주식/기본시세/256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md
new file mode 100644
index 0000000..c47039e
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md
@@ -0,0 +1,130 @@
+# 해외주식 복수종목 시세조회
+
+- 원본 시트명: 해외주식 복수종목 시세조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식 복수종목 시세조회
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76220000
+- 모의 TR_ID: 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/multprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76220000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 입력 필수 |
+| NREC | 종목요청개수 | string | Y | 4 | 최대 10 |
+| EXCD_01 ~ 10 | 거래소코드 | string | Y | 4 | HKS : 홍콩
NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
TSE : 도쿄
SHS : 상해
SZS : 심천
SHI : 상해지수
SZI : 심천지수
HSX : 호치민
HNX : 하노이
BAY : 뉴욕(주간)
BAQ : 나스닥(주간)
BAA : 아멕스(주간) |
+| SYMB_01 ~ 10 | 종목코드 | string | Y | 16 | API 문서 -> 종목정보파일 -> 마스터 파일 참조 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| nrec | Output 개수 | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | Array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 16 | |
+| knam | 종목명 | string | Y | 48 | |
+| exnm | 거래소명 | string | Y | 20 | |
+| nnam | 국가명 | string | Y | 20 | |
+| stat1 | 실 지 휴 정 재 | string | Y | 4 | |
+| stat2 | 실시간 지연15분 휴장 거래정지 거래재개 | string | Y | 16 | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| last | Last Price | string | Y | 12 | |
+| sign | 대비기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| open | 시가 | string | Y | 12 | |
+| high | 고가 | string | Y | 12 | |
+| low | 저가 | string | Y | 12 | |
+| pbid | Bid Price | string | Y | 12 | |
+| pask | Ask Price | string | Y | 12 | |
+| vbid | 매수호가잔량 | string | Y | 10 | |
+| vask | 매도호가잔량 | string | Y | 10 | |
+| bvol | 매수호가총잔량 | string | Y | 10 | |
+| avol | 매도호가총잔량 | string | Y | 10 | |
+| evol | 체결량 | string | Y | 10 | |
+| tvol | 거래량 | string | Y | 14 | |
+| tamt | 거래대금 | string | Y | 14 | |
+| powx | 체결강도 | string | Y | 10 | |
+| xhms | 현지기준시간(HHMMSS) | string | Y | 6 | |
+| khms | 한국기준시간(HHMMSS) | string | Y | 6 | |
+| curr | 통화코드 | string | Y | 4 | |
+| base | Base Price | string | Y | 12 | |
+| pvol | Previous Volume | string | Y | 14 | |
+| pamt | 전일거래대금 | string | Y | 14 | |
+| popen | 전일시가 | string | Y | 12 | |
+| phigh | 전일고가 | string | Y | 12 | |
+| plow | 전일저가 | string | Y | 12 | |
+| shar | 상장주수 | string | Y | 16 | |
+| mcap | 자본금 | string | Y | 16 | |
+| tomv | 시가총액 | string | Y | 16 | |
+| h52p | 52주최고가 | string | Y | 12 | |
+| l52p | 52주최저가 | string | Y | 12 | |
+| h52d | 52주최고일자 | string | Y | 8 | |
+| l52d | 52주최저일자 | string | Y | 8 | |
+| hanp | High Anual Price | string | Y | 12 | |
+| lanp | Low Anual Price | string | Y | 12 | |
+| hand | 연중최고일자 | string | Y | 8 | |
+| land | 연중최저일자 | string | Y | 8 | |
+| bnit | 매매단위 | string | Y | 6 | |
+| t_xprc | 원환산당일가격 | string | Y | 12 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/기본시세/257_v1_해외주식-015_해외주식조건검색.md b/docs/broker/kis/rest/해외주식/기본시세/257_v1_해외주식-015_해외주식조건검색.md
new file mode 100644
index 0000000..70ca48c
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/257_v1_해외주식-015_해외주식조건검색.md
@@ -0,0 +1,238 @@
+# 해외주식조건검색
+
+- 원본 시트명: 해외주식조건검색
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-015
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76410000
+- 모의 TR_ID: HHDFS76410000
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-search
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 조건검색 API입니다.
+한국투자 HTS(eFriend Plus) > [7641] 해외주식 조건검색 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+현재 조건검색 결과값은 최대 100개까지 조회 가능합니다. 다음 조회(100개 이후의 값) 기능에 대해서는 개선검토 중에 있습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분지연) / 홍콩, 베트남, 중국, 일본 - 15분지연 (중국은 실시간시세 신청 시 무료실시간시세 제공)
+ 미국의 경우 0분지연시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+※ 2024년 12월 13일(금) 오후 5시부터 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 후 접근토큰 발급하면 최대 2시간 이후 실시간 유료 시세 수신 가능
+
+※ 그날 거래량이나 시세 형성이 안된 종목은 해외주식 기간별시세(HHDFS76240000)에서는 조회되지만
+ 해외주식 조건검색(HHDFS76410000)에서 조회되지 않습니다. (EX. NAS AATC)
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세 서비스가 기본 제공되며, 유료 실시간 시세 서비스는 HTS ‘[7781] 시세신청 (실시간)’과 MTS(모바일) ‘고객서비스 > 거래 서비스신청 > 해외주식 > 해외 실시간시세 신청’ 에서 신청 가능합니다.
+※ 무료(매수/매도 각 1호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : 미국 전체 거래소들의 통합 주문체결 및 최우선 호가
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로
+현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료∙유료 모두 미국에 상장된 종목(뉴욕, 나스닥, 아멕스 등)의 시세를 제공하며, 동일한 시스템을 사용하여 주문∙체결됩니다.
+단, 무료∙유료의 기반 데이터 차이로 호가 및 체결 데이터는 차이가 발생할 수 있고, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 유료 실시간 시세 서비스와 다를 수 있으며,
+종목별 과거 데이터(거래량, 시가, 종가, 고가, 차트 데이터 등)는 장 종료 후(오후 12시경) 유료 실시간 시세 서비스 데이터와 동일하게 업데이트됩니다.
+■ 유료 실시간 시세 서비스는 신청 시 1~12개월까지 기간 선택 후 해당 요금을 일괄 납부하며,
+해지 시 해지한 달의 말일까지 시세 제공 후 남은 기간 해당 금액이 환급되니 유의하시기 바랍니다.
+(출처: 한국투자증권 외화증권 거래설명서 - https://www.truefriend.com/main/customer/guide/Guide.jsp?&cmd=TF04ag010002¤tPage=1&num=64)
+■ output2에 조회되는 순위(rank)는 거래량을 기준으로 내림차순 정렬 시 나오는 순위인 점 참고 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76410000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default 개인: "" |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | "" (Null 값 설정) |
+| EXCD | 거래소코드 | string | Y | 4 | NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 |
+| CO_YN_PRICECUR | 현재가선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_PRICECUR | 현재가시작범위가 | string | N | 12 | 단위: 각국통화(JPY, USD, HKD, CNY, VND) |
+| CO_EN_PRICECUR | 현재가끝범위가 | string | N | 12 | 단위: 각국통화(JPY, USD, HKD, CNY, VND) |
+| CO_YN_RATE | 등락율선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_RATE | 등락율시작율 | string | N | 12 | % |
+| CO_EN_RATE | 등락율끝율 | string | N | 12 | % |
+| CO_YN_VALX | 시가총액선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_VALX | 시가총액시작액 | string | N | 12 | 단위: 천 |
+| CO_EN_VALX | 시가총액끝액 | string | N | 12 | 단위: 천 |
+| CO_YN_SHAR | 발행주식수선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_SHAR | 발행주식시작수 | string | N | 12 | 단위: 천 |
+| CO_EN_SHAR | 발행주식끝수 | string | N | 112 | 단위: 천 |
+| CO_YN_VOLUME | 거래량선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_VOLUME | 거래량시작량 | string | N | 12 | 단위: 주 |
+| CO_EN_VOLUME | 거래량끝량 | string | N | 12 | 단위: 주 |
+| CO_YN_AMT | 거래대금선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_AMT | 거래대금시작금 | string | N | 12 | 단위: 천 |
+| CO_EN_AMT | 거래대금끝금 | string | N | 12 | 단위: 천 |
+| CO_YN_EPS | EPS선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_EPS | EPS시작 | string | N | 12 | |
+| CO_EN_EPS | EPS끝 | string | N | 12 | |
+| CO_YN_PER | PER선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
+| CO_ST_PER | PER시작 | string | N | 12 | |
+| CO_EN_PER | PER끝 | string | N | 12 | |
+| KEYB | NEXT KEY BUFF | string | N | 8 | "" 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | 소수점자리수 |
+| stat | 거래상태정보 | string | Y | 20 | 거래상태정보 |
+| crec | 현재조회종목수 | string | Y | 6 | 현재조회종목수 |
+| trec | 전체조회종목수 | string | Y | 6 | 전체조회종목수 |
+| nrec | Record Count | string | Y | 4 | Record Count |
+| output2 | 응답상세2 | object array | Y | | 조회결과 상세 |
+| rsym | 실시간조회심볼 | string | N | 32 | 실시간조회심볼
D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이 |
+| excd | 거래소코드 | string | N | 4 | 거래소코드 |
+| name | 종목명 | string | N | 48 | 종목명 |
+| symb | 종목코드 | string | N | 16 | 종목코드 |
+| last | 현재가 | string | N | 12 | 현재가 |
+| shar | 발행주식 | string | N | 14 | 발행주식수(단위: 천) |
+| valx | 시가총액 | string | N | 14 | 시가총액(단위: 천) |
+| plow | 저가 | string | N | 12 | 저가 |
+| phigh | 고가 | string | N | 12 | 고가 |
+| popen | 시가 | string | N | 12 | 시가 |
+| tvol | 거래량 | string | N | 14 | 거래량(단위: 주) |
+| rate | 등락율 | string | N | 12 | 등락율(%) |
+| diff | 대비 | string | N | 12 | 대비 |
+| sign | 기호 | string | N | 1 | 기호 |
+| avol | 거래대금 | string | N | 14 | 거래대금(단위: 천) |
+| eps | EPS | string | N | 14 | EPS |
+| per | PER | string | N | 14 | PER |
+| rank | 순위 | string | N | 6 | 순위 |
+| ename | 영문종목명 | string | N | 48 | 영문종목명 |
+| e_ordyn | 매매가능 | string | N | 2 | 가능 : O |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "AUTH":"",
+ "EXCD":"NAS",
+ "CO_YN_PRICECUR":"1",
+ "CO_ST_PRICECUR":"160",
+ "CO_EN_PRICECUR":"161",
+ "CO_YN_RATE":"",
+ "CO_ST_RATE":"",
+ "CO_EN_RATE":"",
+ "CO_YN_VALX":"",
+ "CO_ST_VALX":"",
+ "CO_EN_VALX":"",
+ "CO_YN_SHAR":"",
+ "CO_ST_SHAR":"",
+ "CO_EN_SHAR":"",
+ "CO_YN_VOLUME":"",
+ "CO_ST_VOLUME":"",
+ "CO_EN_VOLUME":"",
+ "CO_YN_AMT":"",
+ "CO_ST_AMT":"",
+ "CO_EN_AMT":"",
+ CO_YN_EPS":"",
+ CO_ST_EPS":"",
+ CO_EN_EPS":"",
+ CO_YN_PER":"",
+ CO_ST_PER":"",
+ CO_EN_PER":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "zdiv": "4",
+ "stat": "무료실시간",
+ "crec": "2",
+ "trec": "2",
+ "nrec": "2"
+ },
+ "output2": [
+ {
+ "rsym": "DNASTSLA",
+ "excd": "NAS",
+ "symb": "TSLA",
+ "name": "테슬라",
+ "last": "160.9500",
+ "sign": "5",
+ "diff": "6.8700",
+ "rate": "-4.09",
+ "tvol": "175862722",
+ "popen": "174.8700",
+ "phigh": "175.0500",
+ "plow": "156.9100",
+ "valx": "508239862",
+ "shar": "3157750000",
+ "avol": "28842552711",
+ "eps": "3.24",
+ "per": "49.73",
+ "rank": "1",
+ "ename": "TESLA INC",
+ "e_ordyn": "○"
+ },
+ {
+ "rsym": "DNASPANW",
+ "excd": "NAS",
+ "symb": "PANW",
+ "name": "팔로 알토 네트웍스",
+ "last": "160.7500",
+ "sign": "5",
+ "diff": "1.0300",
+ "rate": "-0.64",
+ "tvol": "3570070",
+ "popen": "168.2200",
+ "phigh": "168.9900",
+ "plow": "159.7700",
+ "valx": "48603888",
+ "shar": "302357000",
+ "avol": "580983313",
+ "eps": "0.50",
+ "per": "324.62",
+ "rank": "2",
+ "ename": "PALO ALTO NETWORKS INC",
+ "e_ordyn": "○"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/258_v1_해외주식-034_해외주식-상품기본정보.md b/docs/broker/kis/rest/해외주식/기본시세/258_v1_해외주식-034_해외주식-상품기본정보.md
new file mode 100644
index 0000000..feaf0b7
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/258_v1_해외주식-034_해외주식-상품기본정보.md
@@ -0,0 +1,197 @@
+# 해외주식 상품기본정보
+
+- 원본 시트명: 해외주식 상품기본정보
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-034
+- HTTP Method: GET
+- 실전 TR_ID: CTPF1702R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/search-info
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 상품기본정보 API입니다.
+시세제공기관(연합)에서 제공하는 해외주식 상품기본정보 데이터를 확인하실 수 있습니다.
+
+※ 해당자료는 시세제공기관(연합)의 자료를 제공하고 있으며, 오류와 지연이 발생할 수 있습니다.
+※ 위 정보에 의한 투자판단의 최종책임은 정보이용자에게 있으며, 당사와 시세제공기관(연합)는 어떠한 법적인 책임도 지지 않사오니 투자에 참고로만 이용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTPF1702R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 512 미국 나스닥 / 513 미국 뉴욕 / 529 미국 아멕스
515 일본
501 홍콩 / 543 홍콩CNY / 558 홍콩USD
507 베트남 하노이 / 508 베트남 호치민
551 중국 상해A / 552 중국 심천A |
+| PDNO | 상품번호 | string | Y | 12 | 예) AAPL (애플) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | Y | | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| prdt_eng_name | 상품영문명 | string | Y | 60 | |
+| natn_cd | 국가코드 | string | Y | 3 | |
+| natn_name | 국가명 | string | Y | 60 | |
+| tr_mket_cd | 거래시장코드 | string | Y | 2 | |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | |
+| ovrs_excg_name | 해외거래소명 | string | Y | 60 | |
+| tr_crcy_cd | 거래통화코드 | string | Y | 3 | |
+| ovrs_papr | 해외액면가 | string | Y | 195 | |
+| crcy_name | 통화명 | string | Y | 60 | |
+| ovrs_stck_dvsn_cd | 해외주식구분코드 | string | Y | 2 | 01.주식
02.WARRANT
03.ETF
04.우선주 |
+| prdt_clsf_cd | 상품분류코드 | string | Y | 6 | |
+| prdt_clsf_name | 상품분류명 | string | Y | 60 | |
+| sll_unit_qty | 매도단위수량 | string | Y | 10 | |
+| buy_unit_qty | 매수단위수량 | string | Y | 10 | |
+| tr_unit_amt | 거래단위금액 | string | Y | 238 | |
+| lstg_stck_num | 상장주식수 | string | Y | 19 | |
+| lstg_dt | 상장일자 | string | Y | 8 | |
+| ovrs_stck_tr_stop_dvsn_cd | 해외주식거래정지구분코드 | string | Y | 2 | ※ 해당 값 지연 반영될 수 있는 점 유의 부탁드립니다.
01.정상
02.거래정지(ALL)
03.거래중단
04.매도정지
05.거래정지(위탁)
06.매수정지 |
+| lstg_abol_item_yn | 상장폐지종목여부 | string | Y | 1 | |
+| ovrs_stck_prdt_grp_no | 해외주식상품그룹번호 | string | Y | 20 | |
+| lstg_yn | 상장여부 | string | Y | 1 | |
+| tax_levy_yn | 세금징수여부 | string | Y | 1 | |
+| ovrs_stck_erlm_rosn_cd | 해외주식등록사유코드 | string | Y | 2 | |
+| ovrs_stck_hist_rght_dvsn_cd | 해외주식이력권리구분코드 | string | Y | 2 | |
+| chng_bf_pdno | 변경전상품번호 | string | Y | 12 | |
+| prdt_type_cd_2 | 상품유형코드2 | string | Y | 3 | |
+| ovrs_item_name | 해외종목명 | string | Y | 60 | |
+| sedol_no | SEDOL번호 | string | Y | 15 | |
+| blbg_tckr_text | 블름버그티커내용 | string | Y | 100 | |
+| ovrs_stck_etf_risk_drtp_cd | 해외주식ETF위험지표코드 | string | Y | 3 | 001.ETF
002.ETN
003.ETC(Exchage Traded Commodity)
004.Others(REIT's, Mutual Fund)
005.VIX Underlying ETF
006.VIX Underlying ETN |
+| etp_chas_erng_rt_dbnb | ETP추적수익율배수 | string | Y | 236 | |
+| istt_usge_isin_cd | 기관용도ISIN코드 | string | Y | 12 | |
+| mint_svc_yn | MINT서비스여부 | string | Y | 1 | |
+| mint_svc_yn_chng_dt | MINT서비스여부변경일자 | string | Y | 8 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| lei_cd | LEI코드 | string | Y | 20 | |
+| ovrs_stck_stop_rson_cd | 해외주식정지사유코드 | string | Y | 2 | 01.권리발생
02.ISIN상이
03.기타
04.급등락종목
05.상장폐지(예정)
06.종목코드,거래소변경
07.PTP종목 |
+| lstg_abol_dt | 상장폐지일자 | string | Y | 8 | |
+| mini_stk_tr_stat_dvsn_cd | 미니스탁거래상태구분코드 | string | Y | 2 | 01.정상
02.매매 불가
03.매수 불가
04.매도 불가 |
+| mint_frst_svc_erlm_dt | MINT최초서비스등록일자 | string | Y | 8 | |
+| mint_dcpt_trad_psbl_yn | MINT소수점매매가능여부 | string | Y | 1 | |
+| mint_fnum_trad_psbl_yn | MINT정수매매가능여부 | string | Y | 1 | |
+| mint_cblc_cvsn_ipsb_yn | MINT잔고전환불가여부 | string | Y | 1 | |
+| ptp_item_yn | PTP종목여부 | string | Y | 1 | |
+| ptp_item_trfx_exmt_yn | PTP종목양도세면제여부 | string | Y | 1 | |
+| ptp_item_trfx_exmt_strt_dt | PTP종목양도세면제시작일자 | string | Y | 8 | |
+| ptp_item_trfx_exmt_end_dt | PTP종목양도세면제종료일자 | string | Y | 8 | |
+| dtm_tr_psbl_yn | 주간거래가능여부 | string | Y | 1 | |
+| sdrf_stop_ecls_yn | 급등락정지제외여부 | string | Y | 1 | |
+| sdrf_stop_ecls_erlm_dt | 급등락정지제외등록일자 | string | Y | 8 | |
+| memo_text1 | 메모내용1 | string | Y | 500 | |
+| ovrs_now_pric1 | 해외현재가격1 | string | Y | 23 | 23.5 |
+| last_rcvg_dtime | 최종수신일시 | string | Y | 14 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"PDNO":"AAPL",
+"PRDT_TYPE_CD":"512"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "std_pdno": "US0378331005",
+ "prdt_eng_name": "APPLE INC",
+ "natn_cd": "840",
+ "natn_name": "미국",
+ "tr_mket_cd": "01",
+ "tr_mket_name": "나스닥",
+ "ovrs_excg_cd": "NASD",
+ "ovrs_excg_name": "나스닥",
+ "tr_crcy_cd": "USD",
+ "ovrs_papr": "0.00000",
+ "crcy_name": "미국달러",
+ "ovrs_stck_dvsn_cd": "01",
+ "prdt_clsf_cd": "101210",
+ "prdt_clsf_name": "해외주식",
+ "sll_unit_qty": "1",
+ "buy_unit_qty": "1",
+ "tr_unit_amt": "0",
+ "lstg_stck_num": "15441900000",
+ "lstg_dt": "",
+ "ovrs_stck_tr_stop_dvsn_cd": "01",
+ "lstg_abol_item_yn": "N",
+ "ovrs_stck_prdt_grp_no": "4621",
+ "lstg_yn": "Y",
+ "tax_levy_yn": "N",
+ "ovrs_stck_erlm_rosn_cd": "00",
+ "ovrs_stck_hist_rght_dvsn_cd": "00",
+ "chng_bf_pdno": "",
+ "prdt_type_cd_2": "",
+ "ovrs_item_name": "",
+ "sedol_no": "2046251",
+ "blbg_tckr_text": "AAPL US",
+ "ovrs_stck_etf_risk_drtp_cd": "",
+ "etp_chas_erng_rt_dbnb": "0.000000",
+ "istt_usge_isin_cd": "US0378331005",
+ "mint_svc_yn": "Y",
+ "mint_svc_yn_chng_dt": "20220711",
+ "prdt_name": "애플",
+ "lei_cd": "HWUPKR0MPOU8FGXBT394",
+ "ovrs_stck_stop_rson_cd": "",
+ "lstg_abol_dt": "",
+ "mini_stk_tr_stat_dvsn_cd": "01",
+ "mint_frst_svc_erlm_dt": "20220711",
+ "mint_dcpt_trad_psbl_yn": "Y",
+ "mint_fnum_trad_psbl_yn": "Y",
+ "mint_cblc_cvsn_ipsb_yn": "N",
+ "ptp_item_yn": "N",
+ "ptp_item_trfx_exmt_yn": "N",
+ "ptp_item_trfx_exmt_strt_dt": "",
+ "ptp_item_trfx_exmt_end_dt": "",
+ "dtm_tr_psbl_yn": "Y",
+ "sdrf_stop_ecls_yn": "N",
+ "sdrf_stop_ecls_erlm_dt": "00000000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/259_v1_해외주식-031_해외지수분봉조회.md b/docs/broker/kis/rest/해외주식/기본시세/259_v1_해외주식-031_해외지수분봉조회.md
new file mode 100644
index 0000000..eb53bd3
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/259_v1_해외주식-031_해외지수분봉조회.md
@@ -0,0 +1,1042 @@
+# 해외지수분봉조회
+
+- 원본 시트명: 해외지수분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-031
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03030200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-time-indexchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외지수분봉조회 API입니다.
+한국투자 HTS(eFriend Plus) > [0303] 해외지수 종합차트 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+실전계좌의 경우, 한 번의 호출에 최대 102건까지 확인 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST03030200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | N 해외지수
X 환율
KX 원화환율 |
+| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호(ex. TSLA) |
+| FID_HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 5 | 0: 정규장, 1: 시간외 |
+| FID_PW_DATA_INCU_YN | 과거 데이터 포함 여부 | string | Y | 2 | Y/N |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| ovrs_nmix_prdy_vrss | 해외 지수 전일 대비 | string | Y | 114 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
+| ovrs_nmix_prdy_clpr | 해외 지수 전일 종가 | string | Y | 114 | |
+| acml_vol | 누적 거래량 | string | Y | 18 | |
+| ovrs_nmix_prpr | 해외 지수 현재가 | string | Y | 114 | |
+| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
+| ovrs_prod_oprc | 해외 상품 시가2 | string | Y | 114 | 시가 |
+| ovrs_prod_hgpr | 해외 상품 최고가 | string | Y | 114 | 최고가 |
+| ovrs_prod_lwpr | 해외 상품 최저가 | string | Y | 114 | 최저가 |
+| output2 | 응답상세2 | object array | Y | | array |
+| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | 영업 일자 |
+| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | 체결 시간 |
+| optn_prpr | 옵션 현재가 | string | Y | 112 | 현재가 |
+| optn_oprc | 옵션 시가2 | string | Y | 112 | 시가 |
+| optn_hgpr | 옵션 최고가 | string | Y | 112 | 최고가 |
+| optn_lwpr | 옵션 최저가 | string | Y | 112 | 최저가 |
+| cntg_vol | 체결 거래량 | string | Y | 18 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"FID_COND_MRKT_DIV_CODE":"N",
+"FID_INPUT_ISCD":"SPX",
+"FID_HOUR_CLS_CODE":"0",
+"FID_PW_DATA_INCU_YN":"Y"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "ovrs_nmix_prdy_vrss": "105.23",
+ "prdy_vrss_sign": "2",
+ "prdy_ctrt": "2.11",
+ "ovrs_nmix_prdy_clpr": "4981.80",
+ "acml_vol": "0",
+ "hts_kor_isnm": "S&P500",
+ "ovrs_nmix_prpr": "5087.03",
+ "stck_shrn_iscd": "SPX",
+ "ovrs_prod_oprc": "5038.83",
+ "ovrs_prod_hgpr": "5094.39",
+ "ovrs_prod_lwpr": "5038.83"
+ },
+ "output2": [
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "170600",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "162000",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161900",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161800",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161700",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161600",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161500",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161400",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161300",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161200",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161100",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "161000",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160900",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160800",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160700",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160600",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160500",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160400",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160300",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.03",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160200",
+ "optn_prpr": "5087.03",
+ "optn_oprc": "5087.02",
+ "optn_hgpr": "5087.03",
+ "optn_lwpr": "5087.02",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160100",
+ "optn_prpr": "5087.02",
+ "optn_oprc": "5087.02",
+ "optn_hgpr": "5087.02",
+ "optn_lwpr": "5087.02",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "160000",
+ "optn_prpr": "5087.02",
+ "optn_oprc": "5086.46",
+ "optn_hgpr": "5087.02",
+ "optn_lwpr": "5086.46",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155900",
+ "optn_prpr": "5086.19",
+ "optn_oprc": "5086.73",
+ "optn_hgpr": "5087.67",
+ "optn_lwpr": "5085.72",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155800",
+ "optn_prpr": "5086.62",
+ "optn_oprc": "5088.75",
+ "optn_hgpr": "5088.75",
+ "optn_lwpr": "5085.99",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155700",
+ "optn_prpr": "5088.55",
+ "optn_oprc": "5090.37",
+ "optn_hgpr": "5090.40",
+ "optn_lwpr": "5087.35",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155600",
+ "optn_prpr": "5090.28",
+ "optn_oprc": "5089.28",
+ "optn_hgpr": "5090.28",
+ "optn_lwpr": "5088.76",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155500",
+ "optn_prpr": "5089.37",
+ "optn_oprc": "5087.89",
+ "optn_hgpr": "5092.58",
+ "optn_lwpr": "5087.89",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155400",
+ "optn_prpr": "5087.82",
+ "optn_oprc": "5089.10",
+ "optn_hgpr": "5089.17",
+ "optn_lwpr": "5086.64",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155300",
+ "optn_prpr": "5089.13",
+ "optn_oprc": "5087.97",
+ "optn_hgpr": "5089.33",
+ "optn_lwpr": "5087.53",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155200",
+ "optn_prpr": "5087.93",
+ "optn_oprc": "5086.30",
+ "optn_hgpr": "5088.03",
+ "optn_lwpr": "5086.30",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155100",
+ "optn_prpr": "5086.19",
+ "optn_oprc": "5087.40",
+ "optn_hgpr": "5087.40",
+ "optn_lwpr": "5085.22",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "155000",
+ "optn_prpr": "5087.42",
+ "optn_oprc": "5086.76",
+ "optn_hgpr": "5088.79",
+ "optn_lwpr": "5086.37",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154900",
+ "optn_prpr": "5086.81",
+ "optn_oprc": "5086.47",
+ "optn_hgpr": "5087.24",
+ "optn_lwpr": "5086.09",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154800",
+ "optn_prpr": "5086.39",
+ "optn_oprc": "5086.93",
+ "optn_hgpr": "5087.27",
+ "optn_lwpr": "5086.34",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154700",
+ "optn_prpr": "5086.85",
+ "optn_oprc": "5087.45",
+ "optn_hgpr": "5087.91",
+ "optn_lwpr": "5086.78",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154600",
+ "optn_prpr": "5087.49",
+ "optn_oprc": "5087.78",
+ "optn_hgpr": "5088.12",
+ "optn_lwpr": "5087.14",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154500",
+ "optn_prpr": "5087.71",
+ "optn_oprc": "5087.73",
+ "optn_hgpr": "5087.83",
+ "optn_lwpr": "5086.98",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154400",
+ "optn_prpr": "5087.87",
+ "optn_oprc": "5089.52",
+ "optn_hgpr": "5090.29",
+ "optn_lwpr": "5087.87",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154300",
+ "optn_prpr": "5089.44",
+ "optn_oprc": "5092.13",
+ "optn_hgpr": "5092.29",
+ "optn_lwpr": "5089.41",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154200",
+ "optn_prpr": "5092.09",
+ "optn_oprc": "5091.81",
+ "optn_hgpr": "5092.86",
+ "optn_lwpr": "5091.61",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154100",
+ "optn_prpr": "5091.82",
+ "optn_oprc": "5091.07",
+ "optn_hgpr": "5091.93",
+ "optn_lwpr": "5090.69",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "154000",
+ "optn_prpr": "5091.08",
+ "optn_oprc": "5090.41",
+ "optn_hgpr": "5091.10",
+ "optn_lwpr": "5090.37",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153900",
+ "optn_prpr": "5090.27",
+ "optn_oprc": "5089.71",
+ "optn_hgpr": "5090.39",
+ "optn_lwpr": "5089.00",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153800",
+ "optn_prpr": "5089.42",
+ "optn_oprc": "5089.06",
+ "optn_hgpr": "5090.42",
+ "optn_lwpr": "5089.04",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153700",
+ "optn_prpr": "5089.02",
+ "optn_oprc": "5088.11",
+ "optn_hgpr": "5089.14",
+ "optn_lwpr": "5088.02",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153600",
+ "optn_prpr": "5088.15",
+ "optn_oprc": "5087.72",
+ "optn_hgpr": "5088.24",
+ "optn_lwpr": "5087.08",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153500",
+ "optn_prpr": "5087.69",
+ "optn_oprc": "5085.66",
+ "optn_hgpr": "5087.78",
+ "optn_lwpr": "5085.03",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153400",
+ "optn_prpr": "5085.75",
+ "optn_oprc": "5085.03",
+ "optn_hgpr": "5086.00",
+ "optn_lwpr": "5084.40",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153300",
+ "optn_prpr": "5085.00",
+ "optn_oprc": "5084.04",
+ "optn_hgpr": "5085.03",
+ "optn_lwpr": "5083.99",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153200",
+ "optn_prpr": "5083.97",
+ "optn_oprc": "5084.93",
+ "optn_hgpr": "5085.65",
+ "optn_lwpr": "5083.85",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153100",
+ "optn_prpr": "5085.05",
+ "optn_oprc": "5087.11",
+ "optn_hgpr": "5087.25",
+ "optn_lwpr": "5085.05",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "153000",
+ "optn_prpr": "5087.01",
+ "optn_oprc": "5087.39",
+ "optn_hgpr": "5087.74",
+ "optn_lwpr": "5086.44",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152900",
+ "optn_prpr": "5087.30",
+ "optn_oprc": "5089.37",
+ "optn_hgpr": "5089.87",
+ "optn_lwpr": "5087.27",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152800",
+ "optn_prpr": "5089.29",
+ "optn_oprc": "5090.04",
+ "optn_hgpr": "5090.04",
+ "optn_lwpr": "5089.09",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152700",
+ "optn_prpr": "5090.04",
+ "optn_oprc": "5089.97",
+ "optn_hgpr": "5090.36",
+ "optn_lwpr": "5089.24",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152600",
+ "optn_prpr": "5089.92",
+ "optn_oprc": "5089.77",
+ "optn_hgpr": "5090.02",
+ "optn_lwpr": "5089.28",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152500",
+ "optn_prpr": "5089.68",
+ "optn_oprc": "5089.07",
+ "optn_hgpr": "5089.73",
+ "optn_lwpr": "5088.87",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152400",
+ "optn_prpr": "5088.91",
+ "optn_oprc": "5089.75",
+ "optn_hgpr": "5089.75",
+ "optn_lwpr": "5088.17",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152300",
+ "optn_prpr": "5089.78",
+ "optn_oprc": "5089.37",
+ "optn_hgpr": "5089.85",
+ "optn_lwpr": "5088.89",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152200",
+ "optn_prpr": "5089.37",
+ "optn_oprc": "5087.83",
+ "optn_hgpr": "5089.39",
+ "optn_lwpr": "5087.82",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152100",
+ "optn_prpr": "5087.72",
+ "optn_oprc": "5087.44",
+ "optn_hgpr": "5088.23",
+ "optn_lwpr": "5087.44",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "152000",
+ "optn_prpr": "5087.46",
+ "optn_oprc": "5088.20",
+ "optn_hgpr": "5088.51",
+ "optn_lwpr": "5087.29",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151900",
+ "optn_prpr": "5088.08",
+ "optn_oprc": "5087.59",
+ "optn_hgpr": "5088.09",
+ "optn_lwpr": "5087.11",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151800",
+ "optn_prpr": "5087.50",
+ "optn_oprc": "5086.13",
+ "optn_hgpr": "5087.79",
+ "optn_lwpr": "5086.13",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151700",
+ "optn_prpr": "5086.13",
+ "optn_oprc": "5086.15",
+ "optn_hgpr": "5086.75",
+ "optn_lwpr": "5085.64",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151600",
+ "optn_prpr": "5086.09",
+ "optn_oprc": "5085.59",
+ "optn_hgpr": "5086.77",
+ "optn_lwpr": "5085.57",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151500",
+ "optn_prpr": "5085.52",
+ "optn_oprc": "5085.34",
+ "optn_hgpr": "5086.10",
+ "optn_lwpr": "5085.11",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151400",
+ "optn_prpr": "5085.35",
+ "optn_oprc": "5085.13",
+ "optn_hgpr": "5085.38",
+ "optn_lwpr": "5084.35",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151300",
+ "optn_prpr": "5085.09",
+ "optn_oprc": "5084.68",
+ "optn_hgpr": "5086.24",
+ "optn_lwpr": "5084.65",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151200",
+ "optn_prpr": "5084.67",
+ "optn_oprc": "5084.37",
+ "optn_hgpr": "5084.72",
+ "optn_lwpr": "5083.81",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151100",
+ "optn_prpr": "5084.39",
+ "optn_oprc": "5084.85",
+ "optn_hgpr": "5084.85",
+ "optn_lwpr": "5084.26",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "151000",
+ "optn_prpr": "5084.80",
+ "optn_oprc": "5083.57",
+ "optn_hgpr": "5084.80",
+ "optn_lwpr": "5082.58",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150900",
+ "optn_prpr": "5083.58",
+ "optn_oprc": "5084.67",
+ "optn_hgpr": "5084.67",
+ "optn_lwpr": "5083.33",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150800",
+ "optn_prpr": "5084.65",
+ "optn_oprc": "5084.90",
+ "optn_hgpr": "5085.29",
+ "optn_lwpr": "5084.16",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150700",
+ "optn_prpr": "5084.71",
+ "optn_oprc": "5086.41",
+ "optn_hgpr": "5086.64",
+ "optn_lwpr": "5084.15",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150600",
+ "optn_prpr": "5086.59",
+ "optn_oprc": "5086.16",
+ "optn_hgpr": "5087.41",
+ "optn_lwpr": "5086.09",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150500",
+ "optn_prpr": "5086.16",
+ "optn_oprc": "5086.06",
+ "optn_hgpr": "5086.48",
+ "optn_lwpr": "5085.66",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150400",
+ "optn_prpr": "5086.21",
+ "optn_oprc": "5085.47",
+ "optn_hgpr": "5086.24",
+ "optn_lwpr": "5085.36",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150300",
+ "optn_prpr": "5085.34",
+ "optn_oprc": "5083.47",
+ "optn_hgpr": "5085.45",
+ "optn_lwpr": "5083.47",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150200",
+ "optn_prpr": "5083.44",
+ "optn_oprc": "5081.88",
+ "optn_hgpr": "5084.21",
+ "optn_lwpr": "5081.87",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150100",
+ "optn_prpr": "5081.85",
+ "optn_oprc": "5082.40",
+ "optn_hgpr": "5082.40",
+ "optn_lwpr": "5081.02",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "150000",
+ "optn_prpr": "5082.43",
+ "optn_oprc": "5081.86",
+ "optn_hgpr": "5082.59",
+ "optn_lwpr": "5081.22",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145900",
+ "optn_prpr": "5081.86",
+ "optn_oprc": "5081.31",
+ "optn_hgpr": "5082.59",
+ "optn_lwpr": "5081.26",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145800",
+ "optn_prpr": "5081.44",
+ "optn_oprc": "5079.44",
+ "optn_hgpr": "5081.97",
+ "optn_lwpr": "5079.44",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145700",
+ "optn_prpr": "5079.46",
+ "optn_oprc": "5080.86",
+ "optn_hgpr": "5081.53",
+ "optn_lwpr": "5079.36",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145600",
+ "optn_prpr": "5080.99",
+ "optn_oprc": "5085.84",
+ "optn_hgpr": "5085.86",
+ "optn_lwpr": "5080.99",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145500",
+ "optn_prpr": "5085.87",
+ "optn_oprc": "5085.68",
+ "optn_hgpr": "5086.25",
+ "optn_lwpr": "5085.52",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145400",
+ "optn_prpr": "5085.65",
+ "optn_oprc": "5085.31",
+ "optn_hgpr": "5085.65",
+ "optn_lwpr": "5084.91",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145300",
+ "optn_prpr": "5085.31",
+ "optn_oprc": "5085.00",
+ "optn_hgpr": "5085.33",
+ "optn_lwpr": "5084.55",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145200",
+ "optn_prpr": "5084.97",
+ "optn_oprc": "5085.08",
+ "optn_hgpr": "5085.53",
+ "optn_lwpr": "5084.95",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145100",
+ "optn_prpr": "5085.12",
+ "optn_oprc": "5083.58",
+ "optn_hgpr": "5085.12",
+ "optn_lwpr": "5083.58",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "145000",
+ "optn_prpr": "5083.60",
+ "optn_oprc": "5085.14",
+ "optn_hgpr": "5085.16",
+ "optn_lwpr": "5083.60",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144900",
+ "optn_prpr": "5085.18",
+ "optn_oprc": "5085.61",
+ "optn_hgpr": "5086.11",
+ "optn_lwpr": "5084.90",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144800",
+ "optn_prpr": "5085.58",
+ "optn_oprc": "5085.85",
+ "optn_hgpr": "5085.97",
+ "optn_lwpr": "5085.27",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144700",
+ "optn_prpr": "5085.82",
+ "optn_oprc": "5086.21",
+ "optn_hgpr": "5086.22",
+ "optn_lwpr": "5084.99",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144600",
+ "optn_prpr": "5086.21",
+ "optn_oprc": "5088.44",
+ "optn_hgpr": "5088.44",
+ "optn_lwpr": "5085.95",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144500",
+ "optn_prpr": "5088.44",
+ "optn_oprc": "5087.92",
+ "optn_hgpr": "5088.44",
+ "optn_lwpr": "5087.88",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144400",
+ "optn_prpr": "5087.87",
+ "optn_oprc": "5087.02",
+ "optn_hgpr": "5088.13",
+ "optn_lwpr": "5087.02",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144300",
+ "optn_prpr": "5087.11",
+ "optn_oprc": "5086.53",
+ "optn_hgpr": "5087.11",
+ "optn_lwpr": "5086.29",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144200",
+ "optn_prpr": "5086.53",
+ "optn_oprc": "5085.60",
+ "optn_hgpr": "5086.61",
+ "optn_lwpr": "5085.60",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144100",
+ "optn_prpr": "5085.53",
+ "optn_oprc": "5086.30",
+ "optn_hgpr": "5086.30",
+ "optn_lwpr": "5085.20",
+ "cntg_vol": "0"
+ },
+ {
+ "stck_bsop_date": "20240222",
+ "stck_cntg_hour": "144000",
+ "optn_prpr": "5086.34",
+ "optn_oprc": "5087.80",
+ "optn_hgpr": "5087.80",
+ "optn_lwpr": "5086.02",
+ "cntg_vol": "0"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/260_v1_해외주식-030_해외주식분봉조회.md b/docs/broker/kis/rest/해외주식/기본시세/260_v1_해외주식-030_해외주식분봉조회.md
new file mode 100644
index 0000000..ab37c3b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/260_v1_해외주식-030_해외주식분봉조회.md
@@ -0,0 +1,1267 @@
+# 해외주식분봉조회
+
+- 원본 시트명: 해외주식분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-030
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76950200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-time-itemchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식분봉조회 API입니다. 실전계좌의 경우, 한 번의 호출에 최근 120건까지 확인 가능합니다.
+NEXT 및 KEYB 값을 사용하여 데이터를 계속해서 다음 조회할 수 있으며, 최대 다음조회 가능 기간은 약 1개월입니다.
+
+※ 해외주식분봉조회 조회 방법
+params
+. 초기 조회:
+ - PINC: "1" 입력
+ - NEXT: 처음 조회 시, "" 공백 입력
+ - KEYB: 처음 조회 시, "" 공백 입력
+. 다음 조회:
+ - PINC: "1" 입력
+ - NEXT: "1" 입력
+ - KEYB: 이전 조회 결과의 마지막 분봉 데이터를 이용하여, 1분 전 혹은 n분 전의 시간을 입력 (형식: YYYYMMDDHHMMSS, ex. 20241014140100)
+
+* 따라서 분봉데이터를 기간별로 수집하고자 하실 경우 NEXT, KEYB 값을 이용하시면서 다음조회하시면 됩니다.
+* 한국투자 Github에서 해외주식 분봉 다음조회 파이썬 샘플코드 참고하실 수 있습니다. (아래 링크 참고)
+ https://github.com/koreainvestment/open-trading-api/blob/main/rest/get_ovsstk_chart_price.py
+
+※ 해외주식 분봉은 정규장만 과거조회 가능합니다.
+미국주식 주간거래( EXCD: BAY, BAQ, BAA )의 경우 본 API로 최대 1일치 분봉만 조회가 가능합니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분지연) / 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분지연시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76950200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | "" 공백으로 입력 |
+| EXCD | 거래소코드 | string | Y | 4 | NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
HKS : 홍콩
SHS : 상해
SZS : 심천
HSX : 호치민
HNX : 하노이
TSE : 도쿄
※ 주간거래는 최대 1일치 분봉만 조회 가능
BAY : 뉴욕(주간)
BAQ : 나스닥(주간)
BAA : 아멕스(주간) |
+| SYMB | 종목코드 | string | Y | 16 | 종목코드(ex. TSLA) |
+| NMIN | 분갭 | string | Y | 4 | 분단위(1: 1분봉, 2: 2분봉, ...) |
+| PINC | 전일포함여부 | string | Y | 1 | 0:당일 1:전일포함
※ 다음조회 시 반드시 "1"로 입력 |
+| NEXT | 다음여부 | string | Y | 1 | 처음조회 시, "" 공백 입력
다음조회 시, "1" 입력 |
+| NREC | 요청갯수 | string | Y | 4 | 레코드요청갯수 (최대 120) |
+| FILL | 미체결채움구분 | string | Y | 1 | "" 공백으로 입력 |
+| KEYB | NEXT KEY BUFF | string | Y | 32 | 처음 조회 시, "" 공백 입력
다음 조회 시, 이전 조회 결과의 마지막 분봉 데이터를 이용하여, 1분 전 혹은 n분 전의 시간을 입력
(형식: YYYYMMDDHHMMSS, ex. 20241014140100) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | |
+| rsym | 실시간종목코드 | string | Y | 16 | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stim | 장시작현지시간 | string | Y | 6 | |
+| etim | 장종료현지시간 | string | Y | 6 | |
+| sktm | 장시작한국시간 | string | Y | 6 | |
+| ektm | 장종료한국시간 | string | Y | 6 | |
+| next | 다음가능여부 | string | Y | 1 | |
+| more | 추가데이타여부 | string | Y | 1 | |
+| nrec | 레코드갯수 | string | Y | 4 | |
+| output2 | 응답상세2 | object | Y | | array |
+| tymd | 현지영업일자 | string | Y | 8 | |
+| xymd | 현지기준일자 | string | Y | 8 | |
+| xhms | 현지기준시간 | string | Y | 6 | |
+| kymd | 한국기준일자 | string | Y | 8 | |
+| khms | 한국기준시간 | string | Y | 6 | |
+| open | 시가 | string | Y | 12 | |
+| high | 고가 | string | Y | 12 | |
+| low | 저가 | string | Y | 12 | |
+| last | 종가 | string | Y | 12 | |
+| evol | 체결량 | string | Y | 12 | |
+| eamt | 체결대금 | string | Y | 14 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"AUTH":"",
+"EXCD":"NAS",
+"SYMB":"TSLA",
+"NMIN":"5",
+"PINC":"1",
+"NEXT":"1",
+"NREC":"120",
+"FILL":"",
+"KEYB":""
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "rsym": "DNASTSLA",
+ "zdiv": "4",
+ "stim": "093000",
+ "etim": "160000",
+ "sktm": "233000",
+ "ektm": "060000",
+ "next": "1",
+ "more": "0",
+ "nrec": "120"
+ },
+ "output2": [
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "160000",
+ "kymd": "20240223",
+ "khms": "060000",
+ "open": "197.3400",
+ "high": "197.4100",
+ "low": "197.2800",
+ "last": "197.4100",
+ "evol": "5695",
+ "eamt": "1123799"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "155500",
+ "kymd": "20240223",
+ "khms": "055500",
+ "open": "197.7200",
+ "high": "197.9900",
+ "low": "197.1700",
+ "last": "197.3800",
+ "evol": "1810184",
+ "eamt": "357462976"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "155000",
+ "kymd": "20240223",
+ "khms": "055000",
+ "open": "197.3800",
+ "high": "197.8200",
+ "low": "197.3400",
+ "last": "197.7320",
+ "evol": "1063296",
+ "eamt": "210158482"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "154500",
+ "kymd": "20240223",
+ "khms": "054500",
+ "open": "197.8572",
+ "high": "197.8800",
+ "low": "197.3000",
+ "last": "197.3800",
+ "evol": "924730",
+ "eamt": "182753296"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "154000",
+ "kymd": "20240223",
+ "khms": "054000",
+ "open": "198.1258",
+ "high": "198.3200",
+ "low": "197.7200",
+ "last": "197.8572",
+ "evol": "1057656",
+ "eamt": "209470055"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "153500",
+ "kymd": "20240223",
+ "khms": "053500",
+ "open": "197.6900",
+ "high": "198.1500",
+ "low": "197.6600",
+ "last": "198.1258",
+ "evol": "1139444",
+ "eamt": "225542973"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "153000",
+ "kymd": "20240223",
+ "khms": "053000",
+ "open": "197.6600",
+ "high": "197.8600",
+ "low": "197.4300",
+ "last": "197.6900",
+ "evol": "761441",
+ "eamt": "150467794"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "152500",
+ "kymd": "20240223",
+ "khms": "052500",
+ "open": "197.8660",
+ "high": "197.9900",
+ "low": "197.6121",
+ "last": "197.6600",
+ "evol": "819504",
+ "eamt": "162136366"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "152000",
+ "kymd": "20240223",
+ "khms": "052000",
+ "open": "197.5600",
+ "high": "197.9800",
+ "low": "197.5068",
+ "last": "197.8660",
+ "evol": "782871",
+ "eamt": "154797120"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "151500",
+ "kymd": "20240223",
+ "khms": "051500",
+ "open": "197.1000",
+ "high": "197.5900",
+ "low": "196.9900",
+ "last": "197.5600",
+ "evol": "867446",
+ "eamt": "171222685"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "151000",
+ "kymd": "20240223",
+ "khms": "051000",
+ "open": "196.7074",
+ "high": "197.1800",
+ "low": "196.6400",
+ "last": "197.1000",
+ "evol": "569977",
+ "eamt": "112253777"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "150500",
+ "kymd": "20240223",
+ "khms": "050500",
+ "open": "197.3599",
+ "high": "197.4343",
+ "low": "196.6700",
+ "last": "196.7074",
+ "evol": "849967",
+ "eamt": "167469928"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "150000",
+ "kymd": "20240223",
+ "khms": "050000",
+ "open": "197.0850",
+ "high": "197.4300",
+ "low": "196.8300",
+ "last": "197.3500",
+ "evol": "659810",
+ "eamt": "130081018"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "145500",
+ "kymd": "20240223",
+ "khms": "045500",
+ "open": "197.1479",
+ "high": "197.2500",
+ "low": "196.7101",
+ "last": "197.0850",
+ "evol": "619793",
+ "eamt": "122098483"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "145000",
+ "kymd": "20240223",
+ "khms": "045000",
+ "open": "196.8100",
+ "high": "197.1900",
+ "low": "196.5000",
+ "last": "197.1479",
+ "evol": "873328",
+ "eamt": "171928260"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "144500",
+ "kymd": "20240223",
+ "khms": "044500",
+ "open": "196.9101",
+ "high": "197.0800",
+ "low": "196.7700",
+ "last": "196.8100",
+ "evol": "581293",
+ "eamt": "114481341"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "144000",
+ "kymd": "20240223",
+ "khms": "044000",
+ "open": "196.9500",
+ "high": "196.9700",
+ "low": "196.7800",
+ "last": "196.9101",
+ "evol": "445301",
+ "eamt": "87672935"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "143500",
+ "kymd": "20240223",
+ "khms": "043500",
+ "open": "196.9000",
+ "high": "197.1000",
+ "low": "196.7300",
+ "last": "196.9700",
+ "evol": "668604",
+ "eamt": "131649303"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "143000",
+ "kymd": "20240223",
+ "khms": "043000",
+ "open": "197.5350",
+ "high": "197.5800",
+ "low": "196.8600",
+ "last": "196.9000",
+ "evol": "632781",
+ "eamt": "124810145"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "142500",
+ "kymd": "20240223",
+ "khms": "042500",
+ "open": "197.4899",
+ "high": "197.5500",
+ "low": "197.2101",
+ "last": "197.5350",
+ "evol": "467904",
+ "eamt": "92355303"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "142000",
+ "kymd": "20240223",
+ "khms": "042000",
+ "open": "197.2050",
+ "high": "197.5100",
+ "low": "197.2000",
+ "last": "197.4899",
+ "evol": "569973",
+ "eamt": "112499816"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "141500",
+ "kymd": "20240223",
+ "khms": "041500",
+ "open": "197.3400",
+ "high": "197.5300",
+ "low": "197.1400",
+ "last": "197.2000",
+ "evol": "649456",
+ "eamt": "128189425"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "141000",
+ "kymd": "20240223",
+ "khms": "041000",
+ "open": "197.1300",
+ "high": "197.3900",
+ "low": "196.8100",
+ "last": "197.3400",
+ "evol": "782988",
+ "eamt": "154313193"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "140500",
+ "kymd": "20240223",
+ "khms": "040500",
+ "open": "196.9650",
+ "high": "197.3500",
+ "low": "196.8300",
+ "last": "197.1300",
+ "evol": "656325",
+ "eamt": "129386566"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "140000",
+ "kymd": "20240223",
+ "khms": "040000",
+ "open": "196.9000",
+ "high": "197.1500",
+ "low": "196.8100",
+ "last": "196.9650",
+ "evol": "615130",
+ "eamt": "121166181"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "135500",
+ "kymd": "20240223",
+ "khms": "035500",
+ "open": "197.1420",
+ "high": "197.2250",
+ "low": "196.7000",
+ "last": "196.9000",
+ "evol": "866814",
+ "eamt": "170720320"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "135000",
+ "kymd": "20240223",
+ "khms": "035000",
+ "open": "197.4801",
+ "high": "197.6000",
+ "low": "196.8900",
+ "last": "197.1420",
+ "evol": "1022321",
+ "eamt": "201612257"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "134500",
+ "kymd": "20240223",
+ "khms": "034500",
+ "open": "197.6611",
+ "high": "197.6900",
+ "low": "197.2700",
+ "last": "197.4900",
+ "evol": "760553",
+ "eamt": "150216953"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "134000",
+ "kymd": "20240223",
+ "khms": "034000",
+ "open": "197.6105",
+ "high": "197.8600",
+ "low": "197.4580",
+ "last": "197.6611",
+ "evol": "919295",
+ "eamt": "181745095"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "133500",
+ "kymd": "20240223",
+ "khms": "033500",
+ "open": "197.2399",
+ "high": "197.6800",
+ "low": "197.2200",
+ "last": "197.6105",
+ "evol": "879318",
+ "eamt": "173669092"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "133000",
+ "kymd": "20240223",
+ "khms": "033000",
+ "open": "197.2800",
+ "high": "197.4500",
+ "low": "197.1936",
+ "last": "197.2400",
+ "evol": "678779",
+ "eamt": "133936325"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "132500",
+ "kymd": "20240223",
+ "khms": "032500",
+ "open": "197.1400",
+ "high": "197.4000",
+ "low": "196.9000",
+ "last": "197.2850",
+ "evol": "1368950",
+ "eamt": "269897694"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "132000",
+ "kymd": "20240223",
+ "khms": "032000",
+ "open": "197.1871",
+ "high": "197.2600",
+ "low": "197.0000",
+ "last": "197.1415",
+ "evol": "614010",
+ "eamt": "121048703"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "131500",
+ "kymd": "20240223",
+ "khms": "031500",
+ "open": "196.7600",
+ "high": "197.3899",
+ "low": "196.7600",
+ "last": "197.1989",
+ "evol": "1205848",
+ "eamt": "237706856"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "131000",
+ "kymd": "20240223",
+ "khms": "031000",
+ "open": "196.6600",
+ "high": "196.7700",
+ "low": "196.2500",
+ "last": "196.7600",
+ "evol": "817284",
+ "eamt": "160599464"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "130500",
+ "kymd": "20240223",
+ "khms": "030500",
+ "open": "196.7329",
+ "high": "196.8700",
+ "low": "196.5000",
+ "last": "196.6600",
+ "evol": "773879",
+ "eamt": "152168496"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "130000",
+ "kymd": "20240223",
+ "khms": "030000",
+ "open": "196.4700",
+ "high": "196.8400",
+ "low": "196.4000",
+ "last": "196.7329",
+ "evol": "997013",
+ "eamt": "196017987"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "125500",
+ "kymd": "20240223",
+ "khms": "025500",
+ "open": "196.1565",
+ "high": "196.5000",
+ "low": "196.0000",
+ "last": "196.4700",
+ "evol": "1402472",
+ "eamt": "275108172"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "125000",
+ "kymd": "20240223",
+ "khms": "025000",
+ "open": "195.7900",
+ "high": "196.2400",
+ "low": "195.7900",
+ "last": "196.1500",
+ "evol": "724616",
+ "eamt": "142057985"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "124500",
+ "kymd": "20240223",
+ "khms": "024500",
+ "open": "195.9650",
+ "high": "196.1200",
+ "low": "195.6300",
+ "last": "195.7900",
+ "evol": "731597",
+ "eamt": "143315155"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "124000",
+ "kymd": "20240223",
+ "khms": "024000",
+ "open": "196.1800",
+ "high": "196.2000",
+ "low": "195.3300",
+ "last": "195.9650",
+ "evol": "1650897",
+ "eamt": "323200735"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "123500",
+ "kymd": "20240223",
+ "khms": "023500",
+ "open": "195.7994",
+ "high": "196.4700",
+ "low": "195.7709",
+ "last": "196.1986",
+ "evol": "1077671",
+ "eamt": "211388949"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "123000",
+ "kymd": "20240223",
+ "khms": "023000",
+ "open": "195.9050",
+ "high": "196.0500",
+ "low": "195.6600",
+ "last": "195.7994",
+ "evol": "1466167",
+ "eamt": "287231878"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "122500",
+ "kymd": "20240223",
+ "khms": "022500",
+ "open": "196.0824",
+ "high": "196.1200",
+ "low": "195.8300",
+ "last": "195.9050",
+ "evol": "694628",
+ "eamt": "136126676"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "122000",
+ "kymd": "20240223",
+ "khms": "022000",
+ "open": "195.7950",
+ "high": "196.1800",
+ "low": "195.6100",
+ "last": "196.0824",
+ "evol": "1088972",
+ "eamt": "213363586"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "121500",
+ "kymd": "20240223",
+ "khms": "021500",
+ "open": "195.3500",
+ "high": "195.8299",
+ "low": "195.1100",
+ "last": "195.7950",
+ "evol": "862850",
+ "eamt": "168642290"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "121000",
+ "kymd": "20240223",
+ "khms": "021000",
+ "open": "195.7939",
+ "high": "195.8500",
+ "low": "195.1451",
+ "last": "195.3500",
+ "evol": "945068",
+ "eamt": "184752544"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "120500",
+ "kymd": "20240223",
+ "khms": "020500",
+ "open": "194.8500",
+ "high": "195.9100",
+ "low": "194.8100",
+ "last": "195.7939",
+ "evol": "1211841",
+ "eamt": "236762153"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "120000",
+ "kymd": "20240223",
+ "khms": "020000",
+ "open": "194.5600",
+ "high": "195.0500",
+ "low": "194.3700",
+ "last": "194.8500",
+ "evol": "773910",
+ "eamt": "150724507"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "115500",
+ "kymd": "20240223",
+ "khms": "015500",
+ "open": "194.2200",
+ "high": "194.7300",
+ "low": "194.1700",
+ "last": "194.5600",
+ "evol": "718495",
+ "eamt": "139761181"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "115000",
+ "kymd": "20240223",
+ "khms": "015000",
+ "open": "194.4200",
+ "high": "194.4700",
+ "low": "194.1700",
+ "last": "194.2200",
+ "evol": "579935",
+ "eamt": "112701458"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "114500",
+ "kymd": "20240223",
+ "khms": "014500",
+ "open": "195.0000",
+ "high": "195.0400",
+ "low": "194.0601",
+ "last": "194.3900",
+ "evol": "1160400",
+ "eamt": "225686790"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "114000",
+ "kymd": "20240223",
+ "khms": "014000",
+ "open": "194.8100",
+ "high": "195.0500",
+ "low": "194.5701",
+ "last": "195.0000",
+ "evol": "920600",
+ "eamt": "179353816"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "113500",
+ "kymd": "20240223",
+ "khms": "013500",
+ "open": "194.6650",
+ "high": "194.8400",
+ "low": "194.2800",
+ "last": "194.8100",
+ "evol": "1325692",
+ "eamt": "257999048"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "113000",
+ "kymd": "20240223",
+ "khms": "013000",
+ "open": "193.9000",
+ "high": "194.7100",
+ "low": "193.8901",
+ "last": "194.6650",
+ "evol": "1088470",
+ "eamt": "211605921"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "112500",
+ "kymd": "20240223",
+ "khms": "012500",
+ "open": "193.9000",
+ "high": "194.2700",
+ "low": "193.8000",
+ "last": "193.9000",
+ "evol": "943018",
+ "eamt": "183000343"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "112000",
+ "kymd": "20240223",
+ "khms": "012000",
+ "open": "193.5700",
+ "high": "194.1100",
+ "low": "193.2650",
+ "last": "193.9000",
+ "evol": "1000913",
+ "eamt": "193911350"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "111500",
+ "kymd": "20240223",
+ "khms": "011500",
+ "open": "193.6272",
+ "high": "193.7500",
+ "low": "193.4000",
+ "last": "193.5700",
+ "evol": "828731",
+ "eamt": "160451259"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "111000",
+ "kymd": "20240223",
+ "khms": "011000",
+ "open": "193.3900",
+ "high": "193.6500",
+ "low": "193.2000",
+ "last": "193.6272",
+ "evol": "857727",
+ "eamt": "165875323"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "110500",
+ "kymd": "20240223",
+ "khms": "010500",
+ "open": "192.9700",
+ "high": "193.5000",
+ "low": "192.8400",
+ "last": "193.3900",
+ "evol": "1059410",
+ "eamt": "204686966"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "110000",
+ "kymd": "20240223",
+ "khms": "010000",
+ "open": "193.2000",
+ "high": "193.2500",
+ "low": "192.7300",
+ "last": "192.9700",
+ "evol": "947701",
+ "eamt": "182878463"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "105500",
+ "kymd": "20240223",
+ "khms": "005500",
+ "open": "192.7500",
+ "high": "193.2100",
+ "low": "192.6500",
+ "last": "193.2000",
+ "evol": "1068442",
+ "eamt": "206104973"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "105000",
+ "kymd": "20240223",
+ "khms": "005000",
+ "open": "192.5100",
+ "high": "192.8800",
+ "low": "192.4700",
+ "last": "192.7500",
+ "evol": "1270027",
+ "eamt": "244704237"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "104500",
+ "kymd": "20240223",
+ "khms": "004500",
+ "open": "192.0301",
+ "high": "192.5400",
+ "low": "191.3900",
+ "last": "192.5100",
+ "evol": "2212812",
+ "eamt": "424463260"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "104000",
+ "kymd": "20240223",
+ "khms": "004000",
+ "open": "192.5250",
+ "high": "192.8700",
+ "low": "191.9700",
+ "last": "192.0300",
+ "evol": "1679593",
+ "eamt": "323107778"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "103500",
+ "kymd": "20240223",
+ "khms": "003500",
+ "open": "192.9499",
+ "high": "193.1800",
+ "low": "192.4900",
+ "last": "192.5250",
+ "evol": "1503653",
+ "eamt": "289911663"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "103000",
+ "kymd": "20240223",
+ "khms": "003000",
+ "open": "193.2250",
+ "high": "193.3999",
+ "low": "192.5900",
+ "last": "192.9499",
+ "evol": "1667872",
+ "eamt": "321710100"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "102500",
+ "kymd": "20240223",
+ "khms": "002500",
+ "open": "193.5550",
+ "high": "193.7500",
+ "low": "192.9601",
+ "last": "193.2250",
+ "evol": "1348645",
+ "eamt": "260572277"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "102000",
+ "kymd": "20240223",
+ "khms": "002000",
+ "open": "194.2120",
+ "high": "194.2120",
+ "low": "193.3706",
+ "last": "193.5550",
+ "evol": "1495301",
+ "eamt": "289774601"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "101500",
+ "kymd": "20240223",
+ "khms": "001500",
+ "open": "194.7200",
+ "high": "195.3700",
+ "low": "194.1100",
+ "last": "194.2120",
+ "evol": "1768809",
+ "eamt": "344578091"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "101000",
+ "kymd": "20240223",
+ "khms": "001000",
+ "open": "194.5134",
+ "high": "194.8300",
+ "low": "193.9700",
+ "last": "194.7200",
+ "evol": "1402838",
+ "eamt": "272825843"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "100500",
+ "kymd": "20240223",
+ "khms": "000500",
+ "open": "194.1109",
+ "high": "194.7200",
+ "low": "193.9200",
+ "last": "194.5134",
+ "evol": "1538510",
+ "eamt": "298949025"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "100000",
+ "kymd": "20240223",
+ "khms": "000000",
+ "open": "192.9500",
+ "high": "194.1800",
+ "low": "192.1000",
+ "last": "194.1000",
+ "evol": "2128350",
+ "eamt": "411408371"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "095500",
+ "kymd": "20240222",
+ "khms": "235500",
+ "open": "193.3050",
+ "high": "193.9900",
+ "low": "192.8800",
+ "last": "192.9200",
+ "evol": "1313537",
+ "eamt": "254115390"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "095000",
+ "kymd": "20240222",
+ "khms": "235000",
+ "open": "193.8900",
+ "high": "194.2500",
+ "low": "192.6800",
+ "last": "193.3050",
+ "evol": "1883937",
+ "eamt": "364537424"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "094500",
+ "kymd": "20240222",
+ "khms": "234500",
+ "open": "193.1280",
+ "high": "194.1400",
+ "low": "192.7700",
+ "last": "193.8900",
+ "evol": "1908198",
+ "eamt": "368889083"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "094000",
+ "kymd": "20240222",
+ "khms": "234000",
+ "open": "192.3000",
+ "high": "193.8300",
+ "low": "192.2940",
+ "last": "193.1280",
+ "evol": "2095911",
+ "eamt": "404757381"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "093500",
+ "kymd": "20240222",
+ "khms": "233500",
+ "open": "191.4772",
+ "high": "193.2700",
+ "low": "191.3600",
+ "last": "192.3000",
+ "evol": "2795070",
+ "eamt": "537882973"
+ },
+ {
+ "tymd": "20240222",
+ "xymd": "20240222",
+ "xhms": "093000",
+ "kymd": "20240222",
+ "khms": "233000",
+ "open": "194.0000",
+ "high": "194.3000",
+ "low": "191.3801",
+ "last": "191.4772",
+ "evol": "3537695",
+ "eamt": "682410049"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "160000",
+ "kymd": "20240222",
+ "khms": "060000",
+ "open": "194.8400",
+ "high": "194.8400",
+ "low": "194.7700",
+ "last": "194.7700",
+ "evol": "31421",
+ "eamt": "6119886"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "155500",
+ "kymd": "20240222",
+ "khms": "055500",
+ "open": "194.2100",
+ "high": "194.8800",
+ "low": "194.2100",
+ "last": "194.8799",
+ "evol": "1848035",
+ "eamt": "359756004"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "155000",
+ "kymd": "20240222",
+ "khms": "055000",
+ "open": "194.2000",
+ "high": "194.4300",
+ "low": "193.9500",
+ "last": "194.2100",
+ "evol": "1120789",
+ "eamt": "217632045"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "154500",
+ "kymd": "20240222",
+ "khms": "054500",
+ "open": "194.4650",
+ "high": "194.4800",
+ "low": "194.0350",
+ "last": "194.2000",
+ "evol": "985171",
+ "eamt": "191345989"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "154000",
+ "kymd": "20240222",
+ "khms": "054000",
+ "open": "194.5231",
+ "high": "194.6700",
+ "low": "194.2600",
+ "last": "194.4650",
+ "evol": "967078",
+ "eamt": "188061926"
+ },
+ {
+ "tymd": "20240221",
+ "xymd": "20240221",
+ "xhms": "153500",
+ "kymd": "20240222",
+ "khms": "053500",
+ "open": "193.7400",
+ "high": "194.5500",
+ "low": "193.7200",
+ "last": "194.5231",
+ "evol": "1176735",
+ "eamt": "228544
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/261_v1_해외주식-029_해외주식-현재가상세.md b/docs/broker/kis/rest/해외주식/기본시세/261_v1_해외주식-029_해외주식-현재가상세.md
new file mode 100644
index 0000000..848bb36
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/261_v1_해외주식-029_해외주식-현재가상세.md
@@ -0,0 +1,186 @@
+# 해외주식 현재가상세
+
+- 원본 시트명: 해외주식 현재가상세
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-029
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76200200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/price-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 현재가상세 API입니다.
+
+해당 API를 활용하여 해외주식 종목의 매매단위(vnit), 호가단위(e_hogau), PER, PBR, EPS, BPS 등의 데이터를 확인하실 수 있습니다.
+
+해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76200200 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | |
+| EXCD | 거래소명 | string | Y | 4 | HKS : 홍콩
NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
TSE : 도쿄
SHS : 상해
SZS : 심천
SHI : 상해지수
SZI : 심천지수
HSX : 호치민
HNX : 하노이
BAY : 뉴욕(주간)
BAQ : 나스닥(주간)
BAA : 아멕스(주간) |
+| SYMB | 종목코드 | string | Y | 16 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | Y | | |
+| rsym | 실시간조회종목코드 | string | Y | 16 | |
+| pvol | 전일거래량 | string | Y | 14 | |
+| open | 시가 | string | Y | 12 | |
+| high | 고가 | string | Y | 12 | |
+| low | 저가 | string | Y | 12 | |
+| last | 현재가 | string | Y | 12 | |
+| base | 전일종가 | string | Y | 12 | |
+| tomv | 시가총액 | string | Y | 16 | |
+| pamt | 전일거래대금 | string | Y | 14 | |
+| uplp | 상한가 | string | Y | 12 | |
+| dnlp | 하한가 | string | Y | 12 | |
+| h52p | 52주최고가 | string | Y | 12 | |
+| h52d | 52주최고일자 | string | Y | 8 | |
+| l52p | 52주최저가 | string | Y | 12 | |
+| l52d | 52주최저일자 | string | Y | 8 | |
+| perx | PER | string | Y | 10 | |
+| pbrx | PBR | string | Y | 10 | |
+| epsx | EPS | string | Y | 10 | |
+| bpsx | BPS | string | Y | 10 | |
+| shar | 상장주수 | string | Y | 16 | |
+| mcap | 자본금 | string | Y | 16 | |
+| curr | 통화 | string | Y | 4 | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| vnit | 매매단위 | string | Y | 6 | |
+| t_xprc | 원환산당일가격 | string | Y | 12 | |
+| t_xdif | 원환산당일대비 | string | Y | 12 | |
+| t_xrat | 원환산당일등락 | string | Y | 12 | |
+| p_xprc | 원환산전일가격 | string | Y | 12 | |
+| p_xdif | 원환산전일대비 | string | Y | 12 | |
+| p_xrat | 원환산전일등락 | string | Y | 12 | |
+| t_rate | 당일환율 | string | Y | 12 | |
+| p_rate | 전일환율 | string | Y | 12 | |
+| t_xsgn | 원환산당일기호 | string | Y | 1 | HTS 색상표시용 |
+| p_xsng | 원환산전일기호 | string | Y | 1 | HTS 색상표시용 |
+| e_ordyn | 거래가능여부 | string | Y | 20 | |
+| e_hogau | 호가단위 | string | Y | 8 | |
+| e_icod | 업종(섹터) | string | Y | 40 | |
+| e_parp | 액면가 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| tamt | 거래대금 | string | Y | 14 | |
+| etyp_nm | ETP 분류명 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "AUTH":"",
+ "EXCD":"NAS",
+ "SYMB":"TSLA"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output": {
+ "rsym": "DNASTSLA",
+ "zdiv": "4",
+ "curr": "USD",
+ "vnit": "1",
+ "open": "257.2600",
+ "high": "259.0794",
+ "low": "242.0100",
+ "last": "245.0100",
+ "base": "258.0800",
+ "pvol": "108861698",
+ "pamt": "28090405673",
+ "uplp": "0.0000",
+ "dnlp": "0.0000",
+ "h52p": "313.8000",
+ "h52d": "20220921",
+ "l52p": "101.8100",
+ "l52d": "20230106",
+ "perx": "69.51",
+ "pbrx": "15.21",
+ "epsx": "3.52",
+ "bpsx": "16.11",
+ "shar": "3173990000",
+ "mcap": "3000000",
+ "tomv": "777659289900",
+ "t_xprc": "323658",
+ "t_xdif": "17265",
+ "t_xrat": "-5.06",
+ "p_xprc": "0",
+ "p_xdif": "0",
+ "p_xrat": " 0.00",
+ "t_rate": "1321.00",
+ "p_rate": "",
+ "t_xsgn": "5",
+ "p_xsng": "3",
+ "e_ordyn": "매매 가능",
+ "e_hogau": "0.0100",
+ "e_icod": "자동차",
+ "e_parp": "0.0000",
+ "tvol": "132541640",
+ "tamt": "32907071789",
+ "etyp_nm": ""
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/262_해외주식-049_해외주식-업종별코드조회.md b/docs/broker/kis/rest/해외주식/기본시세/262_해외주식-049_해외주식-업종별코드조회.md
new file mode 100644
index 0000000..93c86e5
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/262_해외주식-049_해외주식-업종별코드조회.md
@@ -0,0 +1,99 @@
+# 해외주식 업종별코드조회
+
+- 원본 시트명: 해외주식 업종별코드조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식-049
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76370100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/industry-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 업종별코드조회 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76370100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| icod | 업종코드 | string | Y | 4 | |
+| name | 업종명 | string | Y | 32 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+AUTH:
+EXCD:NAS
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "nrec": "42"
+ },
+ "output2": [
+ {
+ "icod": "000",
+ "name": "전체"
+ },
+ {
+ "icod": "010",
+ "name": "에너지 및 관련 서비스"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md b/docs/broker/kis/rest/해외주식/기본시세/263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md
new file mode 100644
index 0000000..680aea4
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md
@@ -0,0 +1,143 @@
+# 해외주식 종목_지수_환율기간별시세(일_주_월_년)
+
+- 원본 시트명: 해외주식 종목_지수_환율기간별시세(일_주_월_년)
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: v1_해외주식-012
+- HTTP Method: GET
+- 실전 TR_ID: FHKST03030100
+- 모의 TR_ID: FHKST03030100
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-daily-chartprice
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 종목/지수/환율기간별시세(일/주/월/년) API입니다.
+
+해외지수 당일 시세의 경우 지연시세 or 종가시세가 제공됩니다.
+
+※ 해당 API로 미국주식 조회 시, 다우30, 나스닥100, S&P500 종목만 조회 가능합니다.
+ 더 많은 미국주식 종목 시세를 이용할 시에는, 해외주식기간별시세 API 사용 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]
FHKST03030100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | N: 해외지수, X 환율, I: 국채, S:금선물 |
+| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목코드
※ 해외주식 마스터 코드 참조
(포럼 > FAQ > 종목정보 다운로드(해외) > 해외지수)
※ 해당 API로 미국주식 조회 시, 다우30, 나스닥100, S&P500 종목만 조회 가능합니다. 더 많은 미국주식 종목 시세를 이용할 시에는, 해외주식기간별시세 API 사용 부탁드립니다. |
+| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | 시작일자(YYYYMMDD) |
+| FID_INPUT_DATE_2 | FID 입력 날짜2 | string | Y | 10 | 종료일자(YYYYMMDD) |
+| FID_PERIOD_DIV_CODE | FID 기간 분류 코드 | string | Y | 32 | D:일, W:주, M:월, Y:년 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세1 | object | N | | 기본정보 |
+| ovrs_nmix_prdy_vrss | 전일 대비 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
+| prdy_ctrt | 전일 대비율 | string | N | 11 | 11(8.2) 정수부분 8자리, 소수부분 2자리 |
+| ovrs_nmix_prdy_clpr | 전일 종가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| acml_vol | 누적 거래량 | string | N | 18 | |
+| hts_kor_isnm | HTS 한글 종목명 | string | N | 40 | |
+| ovrs_nmix_prpr | 현재가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| stck_shrn_iscd | 단축 종목코드 | string | N | 9 | |
+| prdy_vol | 전일 거래량 | string | N | 18 | |
+| ovrs_prod_oprc | 시가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| ovrs_prod_hgpr | 최고가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| ovrs_prod_lwpr | 최저가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| output2 | 응답상세2 | object array | N | | 일자별 정보 |
+| stck_bsop_date | 영업 일자 | string | N | 8 | |
+| ovrs_nmix_prpr | 현재가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| ovrs_nmix_oprc | 시가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| ovrs_nmix_hgpr | 최고가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| ovrs_nmix_lwpr | 최저가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
+| acml_vol | 누적 거래량 | string | N | 18 | |
+| mod_yn | 변경 여부 | string | N | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "fid_cond_mrkt_div_code": "N",
+ "fid_input_date_1": "20220401",
+ "fid_input_date_2": "20220613",
+ "fid_input_iscd": ".DJI",
+ "fid_period_div_code": "D"
+ }
+```
+
+### Response Example
+
+```text
+"output1": {
+ "acml_vol": "397268510",
+ "hts_kor_isnm": "다우존스 산업지수",
+ "ovrs_nmix_prdy_clpr": "31029.31",
+ "ovrs_nmix_prdy_vrss": "-253.88",
+ "ovrs_nmix_prpr": "30775.43",
+ "ovrs_prod_hgpr": "30979.85",
+ "ovrs_prod_lwpr": "30431.87",
+ "ovrs_prod_oprc": "30790.00",
+ "prdy_ctrt": "-0.82",
+ "prdy_vrss_sign": "5",
+ "stck_shrn_iscd": ".DJI"
+ },
+ "output2": [
+ {
+ "acml_vol": "480501460",
+ "mod_yn": "N",
+ "ovrs_nmix_hgpr": "31144.91",
+ "ovrs_nmix_lwpr": "30373.72",
+ "ovrs_nmix_oprc": "31144.91",
+ "ovrs_nmix_prpr": "30516.74",
+ "stck_bsop_date": "20220613"
+ },
+....
+ {
+ "acml_vol": "346813590",
+ "mod_yn": "N",
+ "ovrs_nmix_hgpr": "34847.91",
+ "ovrs_nmix_lwpr": "34538.25",
+ "ovrs_nmix_oprc": "34740.89",
+ "ovrs_nmix_prpr": "34818.27",
+ "stck_bsop_date": "20220401"
+ }
+```
diff --git a/docs/broker/kis/rest/해외주식/기본시세/264_해외주식-048_해외주식-업종별시세.md b/docs/broker/kis/rest/해외주식/기본시세/264_해외주식-048_해외주식-업종별시세.md
new file mode 100644
index 0000000..8dd52a9
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/264_해외주식-048_해외주식-업종별시세.md
@@ -0,0 +1,93 @@
+# 해외주식 업종별시세
+
+- 원본 시트명: 해외주식 업종별시세
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식-048
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76370000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/industry-theme
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 업종별시세 API입니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76370000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| ICOD | 업종코드 | string | Y | 1 | 업종코드별조회(HHDFS76370100) 를 통해 확인 |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메시지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| vask | 매도잔량 | string | Y | 10 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| vbid | 매수잔량 | string | Y | 10 | |
+| seqn | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/기본시세/265_해외주식-033_해외주식-현재가-호가.md b/docs/broker/kis/rest/해외주식/기본시세/265_해외주식-033_해외주식-현재가-호가.md
new file mode 100644
index 0000000..942d6c5
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/기본시세/265_해외주식-033_해외주식-현재가-호가.md
@@ -0,0 +1,280 @@
+# 해외주식 현재가 호가
+
+- 원본 시트명: 해외주식 현재가 호가
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 기본시세
+- API ID: 해외주식-033
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76200100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/inquire-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 현재가 호가 API입니다.
+미국 거래소는 10호가, 그 외 국가 거래소는 1호가만 제공됩니다.
+한국투자 HTS(eFriend Plus) > [7620] 해외주식 현재가 화면에서 "왼쪽 호가 창" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+ 홍콩, 베트남, 중국, 일본 - 15분지연
+ 미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+[미국주식시세 이용시 유의사항]
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+ 이용에 유의 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76200100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | NYS : 뉴욕
NAS : 나스닥
AMS : 아멕스
HKS : 홍콩
SHS : 상해
SZS : 심천
HSX : 호치민
HNX : 하노이
TSE : 도쿄
BAY : 뉴욕(주간)
BAQ : 나스닥(주간)
BAA : 아멕스(주간) |
+| SYMB | 종목코드 | string | Y | 16 | 종목코드 예)TSLA |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | 100 | |
+| rsym | 실시간조회종목코드 | string | Y | 16 | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| curr | 통화 | string | Y | 4 | |
+| base | 전일종가 | string | Y | 12 | |
+| open | 시가 | string | Y | 12 | |
+| high | 고가 | string | Y | 12 | |
+| low | 저가 | string | Y | 12 | |
+| last | 현재가 | string | Y | 12 | |
+| dymd | 호가일자 | string | Y | 8 | |
+| dhms | 호가시간 | string | Y | 6 | |
+| bvol | 매수호가총잔량 | string | Y | 10 | |
+| avol | 매도호가총잔량 | string | Y | 10 | |
+| bdvl | 매수호가총잔량대비 | string | Y | 10 | |
+| advl | 매도호가총잔량대비 | string | Y | 10 | |
+| code | 종목코드 | string | Y | 16 | |
+| ropen | 시가율 | string | Y | 12 | |
+| rhigh | 고가율 | string | Y | 12 | |
+| rlow | 저가율 | string | Y | 12 | |
+| rclose | 현재가율 | string | Y | 12 | |
+| output2 | 응답상세 | array | Y | 100 | |
+| pbid1 | 매수호가가격1 | string | Y | 12 | |
+| pask1 | 매도호가가격1 | string | Y | 12 | |
+| vbid1 | 매수호가잔량1 | string | Y | 10 | |
+| vask1 | 매도호가잔량1 | string | Y | 10 | |
+| dbid1 | 매수호가대비1 | string | Y | 10 | |
+| dask1 | 매도호가대비1 | string | Y | 10 | |
+| pbid2 | 매수호가가격2 | string | Y | 12 | 미국 거래소만 수신 |
+| pask2 | 매도호가가격2 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid2 | 매수호가잔량2 | string | Y | 10 | 미국 거래소만 수신 |
+| vask2 | 매도호가잔량2 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid2 | 매수호가대비2 | string | Y | 10 | 미국 거래소만 수신 |
+| dask2 | 매도호가대비2 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid3 | 매수호가가격3 | string | Y | 12 | 미국 거래소만 수신 |
+| pask3 | 매도호가가격3 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid3 | 매수호가잔량3 | string | Y | 10 | 미국 거래소만 수신 |
+| vask3 | 매도호가잔량3 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid3 | 매수호가대비3 | string | Y | 10 | 미국 거래소만 수신 |
+| dask3 | 매도호가대비3 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid4 | 매수호가가격4 | string | Y | 12 | 미국 거래소만 수신 |
+| pask4 | 매도호가가격4 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid4 | 매수호가잔량4 | string | Y | 10 | 미국 거래소만 수신 |
+| vask4 | 매도호가잔량4 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid4 | 매수호가대비4 | string | Y | 10 | 미국 거래소만 수신 |
+| dask4 | 매도호가대비4 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid5 | 매수호가가격5 | string | Y | 12 | 미국 거래소만 수신 |
+| pask5 | 매도호가가격5 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid5 | 매수호가잔량5 | string | Y | 10 | 미국 거래소만 수신 |
+| vask5 | 매도호가잔량5 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid5 | 매수호가대비5 | string | Y | 10 | 미국 거래소만 수신 |
+| dask5 | 매도호가대비5 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid6 | 매수호가가격6 | string | Y | 12 | 미국 거래소만 수신 |
+| pask6 | 매도호가가격6 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid6 | 매수호가잔량6 | string | Y | 10 | 미국 거래소만 수신 |
+| vask6 | 매도호가잔량6 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid6 | 매수호가대비6 | string | Y | 10 | 미국 거래소만 수신 |
+| dask6 | 매도호가대비6 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid7 | 매수호가가격7 | string | Y | 12 | 미국 거래소만 수신 |
+| pask7 | 매도호가가격7 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid7 | 매수호가잔량7 | string | Y | 10 | 미국 거래소만 수신 |
+| vask7 | 매도호가잔량7 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid7 | 매수호가대비7 | string | Y | 10 | 미국 거래소만 수신 |
+| dask7 | 매도호가대비7 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid8 | 매수호가가격8 | string | Y | 12 | 미국 거래소만 수신 |
+| pask8 | 매도호가가격8 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid8 | 매수호가잔량8 | string | Y | 10 | 미국 거래소만 수신 |
+| vask8 | 매도호가잔량8 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid8 | 매수호가대비8 | string | Y | 10 | 미국 거래소만 수신 |
+| dask8 | 매도호가대비8 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid9 | 매수호가가격9 | string | Y | 12 | 미국 거래소만 수신 |
+| pask9 | 매도호가가격9 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid9 | 매수호가잔량9 | string | Y | 10 | 미국 거래소만 수신 |
+| vask9 | 매도호가잔량9 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid9 | 매수호가대비9 | string | Y | 10 | 미국 거래소만 수신 |
+| dask9 | 매도호가대비9 | string | Y | 10 | 미국 거래소만 수신 |
+| pbid10 | 매수호가가격10 | string | Y | 12 | 미국 거래소만 수신 |
+| pask10 | 매도호가가격10 | string | Y | 12 | 미국 거래소만 수신 |
+| vbid10 | 매수호가잔량10 | string | Y | 10 | 미국 거래소만 수신 |
+| vask10 | 매도호가잔량10 | string | Y | 10 | 미국 거래소만 수신 |
+| dbid10 | 매수호가대비10 | string | Y | 10 | 미국 거래소만 수신 |
+| dask10 | 매도호가대비10 | string | Y | 10 | 미국 거래소만 수신 |
+| output3 | 응답상세 | object array | Y | 100 | |
+| vstm | VCMStart시간 | string | Y | 6 | 데이터 없음 |
+| vetm | VCMEnd시간 | string | Y | 6 | 데이터 없음 |
+| csbp | CAS/VCM기준가 | string | Y | 12 | 데이터 없음 |
+| cshi | CAS/VCMHighprice | string | Y | 12 | 데이터 없음 |
+| cslo | CAS/VCMLowprice | string | Y | 12 | 데이터 없음 |
+| iep | IEP | string | Y | 12 | 데이터 없음 |
+| iev | IEV | string | Y | 12 | 데이터 없음 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+AUTH:
+EXCD:NAS
+SYMB:TSLA
+```
+
+### Response Example
+
+```text
+{
+ "output1": {
+ "rsym": "DNASTSLA",
+ "zdiv": "4",
+ "curr": "USD",
+ "base": "149.9300",
+ "open": "148.9700",
+ "high": "150.9400",
+ "low": "146.2200",
+ "last": "147.0500",
+ "dymd": "20240420",
+ "dhms": "090000",
+ "bvol": "0",
+ "avol": "10759",
+ "bdvl": "-1053",
+ "advl": "-985",
+ "code": "TSLA",
+ "ropen": "-0.64",
+ "rhigh": "+0.67",
+ "rlow": "-2.47",
+ "rclose": "-1.92"
+ },
+ "output2": {
+ "pbid1": "0.0000",
+ "pask1": "147.0000",
+ "vbid1": "0",
+ "vask1": "9730",
+ "dbid1": "-275",
+ "dask1": "9720",
+ "pbid2": "0.0000",
+ "pask2": "147.0000",
+ "vbid2": "0",
+ "vask2": "11",
+ "dbid2": "-300",
+ "dask2": "-216",
+ "pbid3": "0.0000",
+ "pask3": "147.0000",
+ "vbid3": "0",
+ "vask3": "643",
+ "dbid3": "-5",
+ "dask3": "-28",
+ "pbid4": "0.0000",
+ "pask4": "147.0000",
+ "vbid4": "0",
+ "vask4": "299",
+ "dbid4": "-135",
+ "dask4": "289",
+ "pbid5": "0.0000",
+ "pask5": "147.0000",
+ "vbid5": "0",
+ "vask5": "43",
+ "dbid5": "-300",
+ "dask5": "-57",
+ "pbid6": "0.0000",
+ "pask6": "147.0000",
+ "vbid6": "0",
+ "vask6": "15",
+ "dbid6": "-30",
+ "dask6": "-9715",
+ "pbid7": "0.0000",
+ "pask7": "147.0000",
+ "vbid7": "0",
+ "vask7": "18",
+ "dbid7": "-2",
+ "dask7": "7",
+ "pbid8": "0.0000",
+ "pask8": "0.0000",
+ "vbid8": "0",
+ "vask8": "0",
+ "dbid8": "-3",
+ "dask8": "-643",
+ "pbid9": "0.0000",
+ "pask9": "0.0000",
+ "vbid9": "0",
+ "vask9": "0",
+ "dbid9": "-1",
+ "dask9": "-299",
+ "pbid10": "0.0000",
+ "pask10": "0.0000",
+ "vbid10": "0",
+ "vask10": "0",
+ "dbid10": "-2",
+ "dask10": "-43"
+ },
+ "output3": {
+ "vstm": "",
+ "vetm": "",
+ "csbp": "",
+ "cshi": "",
+ "cslo": "",
+ "iep": "",
+ "iev": ""
+ },
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/266_해외주식-045_해외주식-거래증가율순위.md b/docs/broker/kis/rest/해외주식/시세분석/266_해외주식-045_해외주식-거래증가율순위.md
new file mode 100644
index 0000000..92d2aa4
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/266_해외주식-045_해외주식-거래증가율순위.md
@@ -0,0 +1,94 @@
+# 해외주식 거래증가율순위
+
+- 원본 시트명: 해외주식 거래증가율순위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-045
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76330000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/trade-growth
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 거래증가율순위 API입니다.
+한국투자 HTS(eFriend Plus) > [7633] 거래증가율순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76330000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(당일), 1(2일), 2(3일), 3(5일), 4(10일), 5(20일전), 6(30일), 7(60일), 8(120일), 9(1년) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메시지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| n_tvol | 평균거래량 | string | Y | 14 | |
+| n_rate | 증가율 | string | Y | 12 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/267_해외주식-052_해외주식-기간별권리조회.md b/docs/broker/kis/rest/해외주식/시세분석/267_해외주식-052_해외주식-기간별권리조회.md
new file mode 100644
index 0000000..b02219f
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/267_해외주식-052_해외주식-기간별권리조회.md
@@ -0,0 +1,341 @@
+# 해외주식 기간별권리조회
+
+- 원본 시트명: 해외주식 기간별권리조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-052
+- HTTP Method: GET
+- 실전 TR_ID: CTRGT011R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/period-rights
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 기간별권리조회 API입니다.
+한국투자 HTS(eFriend Plus) > [7520] 기간별해외증권권리조회 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 확정여부가 '예정'으로 표시되는 경우는 권리정보가 변경될 수 있으니 참고자료로만 활용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTRGT011R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| RGHT_TYPE_CD | 권리유형코드 | string | Y | 2 | '%%(전체), 01(유상), 02(무상), 03(배당), 11(합병),
14(액면분할), 15(액면병합), 17(감자), 54(WR청구),
61(원리금상환), 71(WR소멸), 74(배당옵션), 75(특별배당), 76(ISINCODE변경), 77(실권주청약)' |
+| INQR_DVSN_CD | 조회구분코드 | string | Y | 2 | 02(현지기준일), 03(청약시작일), 04(청약종료일) |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 일자 ~ |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | ~ 일자 |
+| PDNO | 상품번호 | string | Y | 12 | 공백 |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 공백 |
+| CTX_AREA_NK50 | 연속조회키50 | string | Y | 50 | 공백 |
+| CTX_AREA_FK50 | 연속조회검색조건50 | string | Y | 50 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| bass_dt | 기준일자 | string | Y | 8 | |
+| rght_type_cd | 권리유형코드 | string | Y | 2 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| acpl_bass_dt | 현지기준일자 | string | Y | 8 | |
+| sbsc_strt_dt | 청약시작일자 | string | Y | 8 | |
+| sbsc_end_dt | 청약종료일자 | string | Y | 8 | |
+| cash_alct_rt | 현금배정비율 | string | Y | 191 | |
+| stck_alct_rt | 주식배정비율 | string | Y | 2012 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| crcy_cd2 | 통화코드2 | string | Y | 3 | |
+| crcy_cd3 | 통화코드3 | string | Y | 3 | |
+| crcy_cd4 | 통화코드4 | string | Y | 3 | |
+| alct_frcr_unpr | 배정외화단가 | string | Y | 195 | |
+| stkp_dvdn_frcr_amt2 | 주당배당외화금액2 | string | Y | 195 | |
+| stkp_dvdn_frcr_amt3 | 주당배당외화금액3 | string | Y | 195 | |
+| stkp_dvdn_frcr_amt4 | 주당배당외화금액4 | string | Y | 195 | |
+| dfnt_yn | 확정여부 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+RGHT_TYPE_CD:%%
+INQR_DVSN_CD:02
+INQR_STRT_DT:20240417
+INQR_END_DT:20240417
+PDNO:
+PRDT_TYPE_CD:
+CTX_AREA_NK50:
+CTX_AREA_FK50:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk50": " ",
+ "ctx_area_fk50": "%%!^02!^20240417!^20240417!^!^ ",
+ "output": [
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "03",
+ "pdno": "000661",
+ "prdt_name": "[000661]CHANGCHUN HIGH-TECH INDUSTRY (GROUP",
+ "prdt_type_cd": "552",
+ "std_pdno": "CNE0000007J8",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "450.0000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "CNY",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "4.50000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "03",
+ "pdno": "AIR",
+ "prdt_name": "AIRBUS GROUP NV",
+ "prdt_type_cd": "542",
+ "std_pdno": "NL0000235190",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "180.0000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "EUR",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "1.80000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "03",
+ "pdno": "GYLD",
+ "prdt_name": "ARROW ETF TR ARROW DOW JONES GLOBAL YIELD ETF",
+ "prdt_type_cd": "513",
+ "std_pdno": "US04273H1041",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "12.6000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.12600",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "03",
+ "pdno": "NORAM",
+ "prdt_name": "NORAM DRILLING",
+ "prdt_type_cd": "525",
+ "std_pdno": "NO0010360019",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "43.8000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "NOK",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.43800",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "15",
+ "pdno": "BENF",
+ "prdt_name": "BENEFICIENT",
+ "prdt_type_cd": "512",
+ "std_pdno": "US08178Q3092",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "0.0000000000",
+ "stck_alct_rt": "1.250000000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.00000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "15",
+ "pdno": "NCNA",
+ "prdt_name": "NUCANA PLC SPON ADR EACH REP 25 ORD SHS(POST SPLIT)",
+ "prdt_type_cd": "512",
+ "std_pdno": "US67022C2052",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "0.0000000000",
+ "stck_alct_rt": "4.000000000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.00000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240415",
+ "rght_type_cd": "54",
+ "pdno": "WWRSF",
+ "prdt_name": "RIVERNORTH CAPITAL AND INCM FD INC",
+ "prdt_type_cd": "513",
+ "std_pdno": "USX589013472",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "20240415",
+ "sbsc_end_dt": "20240417",
+ "cash_alct_rt": "0.0000000000",
+ "stck_alct_rt": "33.333340000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "15.28000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240411",
+ "rght_type_cd": "74",
+ "pdno": "FTF",
+ "prdt_name": "FRANKLIN LIMITED DURATION INCOME TR",
+ "prdt_type_cd": "529",
+ "std_pdno": "US35472T1016",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "20240411",
+ "sbsc_end_dt": "20240416",
+ "cash_alct_rt": "0.0000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "USD",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.00000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240411",
+ "rght_type_cd": "74",
+ "pdno": "TEI",
+ "prdt_name": "TEMPLETON EMERGING MARKETS INC FD",
+ "prdt_type_cd": "513",
+ "std_pdno": "US8801921094",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "20240411",
+ "sbsc_end_dt": "20240416",
+ "cash_alct_rt": "0.0000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "USD",
+ "crcy_cd2": "USD",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "0.00000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ },
+ {
+ "bass_dt": "20240418",
+ "rght_type_cd": "75",
+ "pdno": "AIR",
+ "prdt_name": "AIRBUS GROUP NV",
+ "prdt_type_cd": "542",
+ "std_pdno": "NL0000235190",
+ "acpl_bass_dt": "20240417",
+ "sbsc_strt_dt": "",
+ "sbsc_end_dt": "",
+ "cash_alct_rt": "100.0000000000",
+ "stck_alct_rt": "0.000000000000",
+ "crcy_cd": "EUR",
+ "crcy_cd2": "",
+ "crcy_cd3": "",
+ "crcy_cd4": "",
+ "alct_frcr_unpr": "1.00000",
+ "stkp_dvdn_frcr_amt2": "0.00000",
+ "stkp_dvdn_frcr_amt3": "0.00000",
+ "stkp_dvdn_frcr_amt4": "0.00000",
+ "dfnt_yn": "Y"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/268_해외주식-038_해외주식-가격급등락.md b/docs/broker/kis/rest/해외주식/시세분석/268_해외주식-038_해외주식-가격급등락.md
new file mode 100644
index 0000000..ba23823
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/268_해외주식-038_해외주식-가격급등락.md
@@ -0,0 +1,93 @@
+# 해외주식 가격급등락
+
+- 원본 시트명: 해외주식 가격급등락
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-038
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76260000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/price-fluct
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 가격급등락 API입니다.
+한국투자 HTS(eFriend Plus) > [7626] 가격급등락 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76260000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| GUBN | 급등/급락구분 | string | Y | 1 | 0(급락), 1(급등) |
+| MINX | N분전콤보값 | string | Y | 1 | N분전 : 0(1분전), 1(2분전), 2(3분전), 3(5분전), 4(10분전), 5(15분전), 6(20분전), 7(30분전), 8(60분전), 9(120분전) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태 | string | Y | 20 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 16 | |
+| knam | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 12 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| n_base | 기준가격 | string | Y | 12 | |
+| n_diff | 기준가격대비 | string | Y | 12 | |
+| n_rate | 기준가격대비율 | string | Y | 12 | |
+| enam | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/269_해외주식-044_해외주식-거래대금순위.md b/docs/broker/kis/rest/해외주식/시세분석/269_해외주식-044_해외주식-거래대금순위.md
new file mode 100644
index 0000000..88f178f
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/269_해외주식-044_해외주식-거래대금순위.md
@@ -0,0 +1,96 @@
+# 해외주식 거래대금순위
+
+- 원본 시트명: 해외주식 거래대금순위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-044
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76320010
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/trade-pbmn
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 거래대금순위 API입니다.
+한국투자 HTS(eFriend Plus) > [7632] 거래대금순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76320010 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(당일), 1(2일), 2(3일), 3(5일), 4(10일), 5(20일전), 6(30일), 7(60일), 8(120일), 9(1년) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+| PRC1 | 현재가 필터범위 1 | string | Y | 12 | 가격 ~ |
+| PRC2 | 현재가 필터범위 2 | string | Y | 12 | ~ 가격 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| tamt | 거래대금 | string | Y | 14 | |
+| a_tamt | 평균거래대금 | string | Y | 14 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/270_해외주식-039_해외주식-거래량급증.md b/docs/broker/kis/rest/해외주식/시세분석/270_해외주식-039_해외주식-거래량급증.md
new file mode 100644
index 0000000..9c5660c
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/270_해외주식-039_해외주식-거래량급증.md
@@ -0,0 +1,92 @@
+# 해외주식 거래량급증
+
+- 원본 시트명: 해외주식 거래량급증
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-039
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76270000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/volume-surge
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 거래량급증 API입니다.
+한국투자 HTS(eFriend Plus) > [7627] 거래대금순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76270000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| MINX | N분전콤보값 | string | Y | 1 | N분전 : 0(1분전), 1(2분전), 2(3분전), 3(5분전), 4(10분전), 5(15분전), 6(20분전), 7(30분전), 8(60분전), 9(120분전) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태 | string | Y | 20 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 16 | |
+| knam | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 12 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| n_tvol | 기준거래량 | string | Y | 14 | |
+| n_diff | 증가량 | string | Y | 12 | |
+| n_rate | 증가율 | string | Y | 12 | |
+| enam | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/271_해외주식-042_해외주식-신고_신저가.md b/docs/broker/kis/rest/해외주식/시세분석/271_해외주식-042_해외주식-신고_신저가.md
new file mode 100644
index 0000000..c3c04f4
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/271_해외주식-042_해외주식-신고_신저가.md
@@ -0,0 +1,94 @@
+# 해외주식 신고_신저가
+
+- 원본 시트명: 해외주식 신고_신저가
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-042
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76300000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/new-highlow
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+"해외주식 신고/신저가 API입니다.
+한국투자 HTS(eFriend Plus) > [7630] 신고/신저가 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다."
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76300000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| GUBN | 신고/신저 구분 | string | Y | 1 | 신고(1) 신저(0) |
+| GUBN2 | 일시돌파/돌파 구분 | string | Y | 1 | 일시돌파(0) 돌파유지(1) |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(5일), 1(10일), 2(20일), 3(30일), 4(60일), 5(120일전), 6(52주), 7(1년) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| n_base | 기준가 | string | Y | 12 | |
+| n_diff | 기준가대비 | string | Y | 12 | |
+| n_rate | 기준가대비율 | string | Y | 12 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/272_해외주식-040_해외주식-매수체결강도상위.md b/docs/broker/kis/rest/해외주식/시세분석/272_해외주식-040_해외주식-매수체결강도상위.md
new file mode 100644
index 0000000..7e49ecf
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/272_해외주식-040_해외주식-매수체결강도상위.md
@@ -0,0 +1,91 @@
+# 해외주식 매수체결강도상위
+
+- 원본 시트명: 해외주식 매수체결강도상위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-040
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76280000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/volume-power
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 매수체결강도상위 API입니다.
+한국투자 HTS(eFriend Plus) > [7628] 매수체결강도상위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76280000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| NDAY | N일자값 | string | Y | 1 | N분전 : 0(1분전), 1(2분전), 2(3분전), 3(5분전), 4(10분전), 5(15분전), 6(20분전), 7(30분전), 8(60분전), 9(120분전) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태 | string | Y | 20 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 16 | |
+| knam | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 12 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| tpow | 당일체결강도 | string | Y | 10 | |
+| powx | 체결강도 | string | Y | 10 | |
+| enam | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/273_해외주식-046_해외주식-거래회전율순위.md b/docs/broker/kis/rest/해외주식/시세분석/273_해외주식-046_해외주식-거래회전율순위.md
new file mode 100644
index 0000000..73e70b6
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/273_해외주식-046_해외주식-거래회전율순위.md
@@ -0,0 +1,95 @@
+# 해외주식 거래회전율순위
+
+- 원본 시트명: 해외주식 거래회전율순위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-046
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76340000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/trade-turnover
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 거래회전율순위 API입니다.
+한국투자 HTS(eFriend Plus) > [7634] 거래회전율순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76340000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(당일), 1(2일), 2(3일), 3(5일), 4(10일), 5(20일전), 6(30일), 7(60일), 8(120일), 9(1년) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| n_tvol | 평균거래량 | string | Y | 14 | |
+| shar | 상장주식수 | string | Y | 16 | |
+| tover | 회전율 | string | Y | 10 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/274_해외주식-053_해외뉴스종합제목.md b/docs/broker/kis/rest/해외주식/시세분석/274_해외주식-053_해외뉴스종합제목.md
new file mode 100644
index 0000000..7442300
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/274_해외주식-053_해외뉴스종합제목.md
@@ -0,0 +1,249 @@
+# 해외뉴스종합(제목)
+
+- 원본 시트명: 해외뉴스종합(제목)
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-053
+- HTTP Method: GET
+- 실전 TR_ID: HHPSTH60100C1
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/news-title
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외뉴스종합(제목) API입니다.
+한국투자 HTS(eFriend Plus) > [7702] 해외뉴스종합 화면의 "우측 상단 뉴스목록" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHPSTH60100C1 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| INFO_GB | 뉴스구분 | string | Y | 1 | 전체: 공백 |
+| CLASS_CD | 중분류 | string | Y | 2 | 전체: 공백 |
+| NATION_CD | 국가코드 | string | Y | 2 | 전체: 공백
CN(중국), HK(홍콩), US(미국) |
+| EXCHANGE_CD | 거래소코드 | string | Y | 3 | 전체: 공백 |
+| SYMB | 종목코드 | string | Y | 20 | 전체: 공백 |
+| DATA_DT | 조회일자 | string | Y | 8 | 전체: 공백
특정일자(YYYYMMDD) ex. 20240502 |
+| DATA_TM | 조회시간 | string | Y | 6 | 전체: 공백
전체: 공백
특정시간(HHMMSS) ex. 093500 |
+| CTS | 다음키 | string | Y | 35 | 공백 입력 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| outblock1 | 응답상세 | object array | Y | | array |
+| info_gb | 뉴스구분 | string | Y | 1 | |
+| news_key | 뉴스키 | string | Y | 20 | |
+| data_dt | 조회일자 | string | Y | 8 | |
+| data_tm | 조회시간 | string | Y | 6 | |
+| class_cd | 중분류 | string | Y | 2 | |
+| class_name | 중분류명 | string | Y | 20 | |
+| source | 자료원 | string | Y | 20 | |
+| nation_cd | 국가코드 | string | Y | 2 | |
+| exchange_cd | 거래소코드 | string | Y | 3 | |
+| symb | 종목코드 | string | Y | 20 | |
+| symb_name | 종목명 | string | Y | 48 | |
+| title | 제목 | string | Y | 128 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+INFO_GB:
+CLASS_CD:
+NATION_CD:
+EXCHANGE_CD:
+SYMB:
+DATA_DT:
+DATA_TM:
+CTS:
+```
+
+### Response Example
+
+```text
+{
+ "outblock1": [
+ {
+ "info_gb": "t",
+ "news_key": "ICH709214",
+ "data_dt": "20240503",
+ "data_tm": "145447",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "",
+ "symb": "",
+ "symb_name": "",
+ "title": "톰 리 “단기 내 금리인하 가능”"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709213",
+ "data_dt": "20240503",
+ "data_tm": "144451",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "",
+ "symb": "",
+ "symb_name": "",
+ "title": "美 연준, 7월 금리인하 예상 GS 외"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709212",
+ "data_dt": "20240503",
+ "data_tm": "144313",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "NAS",
+ "symb": "NFLX",
+ "symb_name": "넷플릭스",
+ "title": "넷플릭스, 광고 전망 낙관 제프리스"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709215",
+ "data_dt": "20240503",
+ "data_tm": "143706",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "",
+ "symb": "",
+ "symb_name": "",
+ "title": "美 4월 비농업부문 고용자 수 +24.0만 명 추정 아데코"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709208",
+ "data_dt": "20240503",
+ "data_tm": "142518",
+ "class_cd": "03",
+ "class_name": "전략/산업",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "",
+ "symb": "",
+ "symb_name": "",
+ "title": "美 모기지 금리, 5주 연속 상승"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709207",
+ "data_dt": "20240503",
+ "data_tm": "141851",
+ "class_cd": "02",
+ "class_name": "정책",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "",
+ "symb": "",
+ "symb_name": "",
+ "title": "금리, 현재 정점에 있을 확률 높아 펀드스트랫"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709206",
+ "data_dt": "20240503",
+ "data_tm": "140506",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "NYS",
+ "symb": "FSLY",
+ "symb_name": "패스틀리",
+ "title": "패스틀리, 단기 악재 직면 - BofA"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709205",
+ "data_dt": "20240503",
+ "data_tm": "135416",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "NYS",
+ "symb": "TJX",
+ "symb_name": "TJX",
+ "title": "TJX, 기존 소매점 위협 중 - UBS"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709204",
+ "data_dt": "20240503",
+ "data_tm": "134647",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "NAS",
+ "symb": "TTD",
+ "symb_name": "트레이드 데스크",
+ "title": "트레이드 데스크, 광고시장 현대화로 수혜 가능 - 제프리스"
+ },
+ {
+ "info_gb": "t",
+ "news_key": "ICH709203",
+ "data_dt": "20240503",
+ "data_tm": "133734",
+ "class_cd": "05",
+ "class_name": "종목리포트",
+ "source": "연합미국",
+ "nation_cd": "US",
+ "exchange_cd": "NYS",
+ "symb": "MGM",
+ "symb_name": "MGM 리조츠 인터내셔널",
+ "title": "MGM 리조트, 매출 증가세 가속 중 - 서스퀘하나"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/275_해외주식-051_당사-해외주식담보대출-가능-종목.md b/docs/broker/kis/rest/해외주식/시세분석/275_해외주식-051_당사-해외주식담보대출-가능-종목.md
new file mode 100644
index 0000000..b192f8b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/275_해외주식-051_당사-해외주식담보대출-가능-종목.md
@@ -0,0 +1,140 @@
+# 당사 해외주식담보대출 가능 종목
+
+- 원본 시트명: 당사 해외주식담보대출 가능 종목
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-051
+- HTTP Method: GET
+- 실전 TR_ID: CTLN4050R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/colable-by-company
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+당사 해외주식담보대출 가능 종목 API입니다.
+한국투자 HTS(eFriend Plus) > [0497] 당사 해외주식담보대출 가능 종목 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+한 번의 호출에 20건까지 조회가 가능하며 다음조회가 불가하기에, PDNO에 데이터 확인하고자 하는 종목코드를 입력하여 단건조회용으로 사용하시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTLN4050R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| PDNO | 상품번호 | string | Y | 12 | ex)AMD |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 공백 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 공백 |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | 공백 |
+| INQR_DVSN | 조회구분 | string | Y | 2 | 공백 |
+| NATN_CD | 국가코드 | string | Y | 3 | 840(미국), 344(홍콩), 156(중국) |
+| INQR_SQN_DVSN | 조회순서구분 | string | Y | 2 | 01(이름순), 02(코드순) |
+| RT_DVSN_CD | 비율구분코드 | string | Y | 2 | 공백 |
+| RT | 비율 | string | Y | 238 | 공백 |
+| LOAN_PSBL_YN | 대출가능여부 | string | Y | 1 | 공백 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공백 |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | array | Y | | |
+| pdno | 상품번호 | string | Y | 12 | |
+| ovrs_item_name | 해외종목명 | string | Y | 60 | |
+| loan_rt | 대출비율 | string | Y | 238 | |
+| mgge_mntn_rt | 담보유지비율 | string | Y | 238 | |
+| mgge_ensu_rt | 담보확보비율 | string | Y | 238 | |
+| loan_exec_psbl_yn | 대출실행가능여부 | string | Y | 1 | |
+| stff_name | 직원명 | string | Y | 60 | |
+| erlm_dt | 등록일자 | string | Y | 8 | |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| natn_kor_name | 국가한글명 | string | Y | 60 | |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | |
+| output2 | 응답상세 | object | Y | | array |
+| loan_psbl_item_num | 대출가능종목수 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+PDNO:AMD
+PRDT_TYPE_CD:
+INQR_STRT_DT:
+INQR_END_DT:
+INQR_DVSN:
+NATN_CD:840
+INQR_SQN_DVSN:02
+RT_DVSN_CD:
+RT:
+LOAN_PSBL_YN:
+CTX_AREA_FK100:
+CTX_AREA_NK100:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "AMD!^!^!^!^!^840!^02 ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "pdno": "AMD",
+ "ovrs_item_name": "AMD",
+ "loan_rt": "50.00000000",
+ "mgge_mntn_rt": "170.00000000",
+ "mgge_ensu_rt": "170.00000000",
+ "loan_exec_psbl_yn": "Y",
+ "stff_name": "109477.석재민",
+ "erlm_dt": "20221230",
+ "tr_mket_name": "나스닥",
+ "crcy_cd": "USD",
+ "natn_kor_name": "미국",
+ "ovrs_excg_cd": "NASD"
+ }
+ ],
+ "output2": {
+ "loan_psbl_item_num": "403"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/276_해외주식-047_해외주식-시가총액순위.md b/docs/broker/kis/rest/해외주식/시세분석/276_해외주식-047_해외주식-시가총액순위.md
new file mode 100644
index 0000000..2652aea
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/276_해외주식-047_해외주식-시가총액순위.md
@@ -0,0 +1,92 @@
+# 해외주식 시가총액순위
+
+- 원본 시트명: 해외주식 시가총액순위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-047
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76350100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/market-cap
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 시가총액순위 API입니다.
+한국투자 HTS(eFriend Plus) > [7635] 시가총액순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76350100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 1 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| shar | 상장주식수 | string | Y | 16 | |
+| tomv | 시가총액 | string | Y | 16 | |
+| grav | 비중 | string | Y | 10 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/277_해외주식-055_해외속보제목.md b/docs/broker/kis/rest/해외주식/시세분석/277_해외주식-055_해외속보제목.md
new file mode 100644
index 0000000..f9965e3
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/277_해외주식-055_해외속보제목.md
@@ -0,0 +1,302 @@
+# 해외속보(제목)
+
+- 원본 시트명: 해외속보(제목)
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-055
+- HTTP Method: GET
+- 실전 TR_ID: FHKST01011801
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/brknews-title
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외속보(제목) API입니다.
+한국투자 HTS(eFriend Plus) > [7704] 해외속보 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+최대 100건까지 조회 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHKST01011801 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_NEWS_OFER_ENTP_CODE | 뉴스제공업체코드 | string | Y | 40 | 뉴스제공업체구분=>0:전체조회 |
+| FID_COND_MRKT_CLS_CODE | 조건시장구분코드 | string | Y | 6 | 공백 |
+| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 공백 |
+| FID_TITL_CNTT | 제목내용 | string | Y | 132 | 공백 |
+| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 공백 |
+| FID_INPUT_HOUR_1 | 입력시간1 | string | Y | 10 | 공백 |
+| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | string | Y | 2 | 공백 |
+| FID_INPUT_SRNO | 입력일련번호 | string | Y | 20 | 공백 |
+| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 화면번호:11801 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| cntt_usiq_srno | 내용조회용일련번호 | string | Y | 20 | |
+| news_ofer_entp_code | 뉴스제공업체코드 | string | Y | 1 | |
+| data_dt | 작성일자 | string | Y | 8 | |
+| data_tm | 작성시간 | string | Y | 6 | |
+| hts_pbnt_titl_cntt | HTS공시제목내용 | string | Y | 400 | |
+| news_lrdv_code | 뉴스대구분 | string | Y | 8 | |
+| dorg | 자료원 | string | Y | 20 | |
+| iscd1 | 종목코드1 | string | Y | 9 | |
+| iscd2 | 종목코드2 | string | Y | 9 | |
+| iscd3 | 종목코드3 | string | Y | 9 | |
+| iscd4 | 종목코드4 | string | Y | 9 | |
+| iscd5 | 종목코드5 | string | Y | 9 | |
+| iscd6 | 종목코드6 | string | Y | 9 | |
+| iscd7 | 종목코드7 | string | Y | 9 | |
+| iscd8 | 종목코드8 | string | Y | 9 | |
+| iscd9 | 종목코드9 | string | Y | 9 | |
+| iscd10 | 종목코드10 | string | Y | 9 | |
+| kor_isnm1 | 한글종목명1 | string | Y | 40 | |
+| kor_isnm2 | 한글종목명2 | string | Y | 40 | |
+| kor_isnm3 | 한글종목명3 | string | Y | 40 | |
+| kor_isnm4 | 한글종목명4 | string | Y | 40 | |
+| kor_isnm5 | 한글종목명5 | string | Y | 40 | |
+| kor_isnm6 | 한글종목명6 | string | Y | 40 | |
+| kor_isnm7 | 한글종목명7 | string | Y | 40 | |
+| kor_isnm8 | 한글종목명8 | string | Y | 40 | |
+| kor_isnm9 | 한글종목명9 | string | Y | 40 | |
+| kor_isnm10 | 한글종목명10 | string | Y | 40 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_NEWS_OFER_ENTP_CODE:0
+FID_COND_MRKT_CLS_CODE:00
+FID_INPUT_ISCD:
+FID_TITL_CNTT:
+FID_INPUT_DATE_1:
+FID_INPUT_HOUR_1:
+FID_RANK_SORT_CLS_CODE:
+FID_INPUT_SRNO:
+FID_COND_SCR_DIV_CODE:11801
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "cntt_usiq_srno": "2024052817340622954",
+ "news_ofer_entp_code": "U",
+ "data_dt": "20240528",
+ "data_tm": "173406",
+ "hts_pbnt_titl_cntt": "“시진핑, 기업인들 만나 신에너지 분야 과잉투자 경고”",
+ "news_lrdv_code": "38",
+ "dorg": "서울경제",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024052817332725534",
+ "news_ofer_entp_code": "6",
+ "data_dt": "20240528",
+ "data_tm": "173327",
+ "hts_pbnt_titl_cntt": "군부대 찾은 라이칭더, 中포위훈련 언급하며 \"모두 잘 대응\"",
+ "news_lrdv_code": "11",
+ "dorg": "연합뉴스",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024052817332721133",
+ "news_ofer_entp_code": "6",
+ "data_dt": "20240528",
+ "data_tm": "173327",
+ "hts_pbnt_titl_cntt": "적십자 \"기후변화로 '극단적 더위' 일수 1년 새 26일 증가\"",
+ "news_lrdv_code": "11",
+ "dorg": "연합뉴스",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024052817312094823",
+ "news_ofer_entp_code": "6",
+ "data_dt": "20240528",
+ "data_tm": "173120",
+ "hts_pbnt_titl_cntt": "미국제재 우려했나…중국 하이크비전, 러시아 사업 중단설",
+ "news_lrdv_code": "11",
+ "dorg": "연합뉴스",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024052817304250020",
+ "news_ofer_entp_code": "8",
+ "data_dt": "20240528",
+ "data_tm": "173042",
+ "hts_pbnt_titl_cntt": "[유럽개장]장 초반 혼조세…獨 0.25%↑",
+ "news_lrdv_code": "10",
+ "dorg": "아시아 경제",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },
+ {
+ "cntt_usiq_srno": "2024052817264510344",
+ "news_ofer_entp_code": "A",
+ "data_dt": "20240528",
+ "data_tm": "172645",
+ "hts_pbnt_titl_cntt": "122m 협곡 아래로 떨어졌는데 멀쩡하디니…기적 일어난 美 10대",
+ "news_lrdv_code": "10",
+ "dorg": "매일경제",
+ "iscd1": "",
+ "iscd2": "",
+ "iscd3": "",
+ "iscd4": "",
+ "iscd5": "",
+ "iscd6": "",
+ "iscd7": "",
+ "iscd8": "",
+ "iscd9": "",
+ "iscd10": "",
+ "kor_isnm1": " ",
+ "kor_isnm2": "",
+ "kor_isnm3": "",
+ "kor_isnm4": "",
+ "kor_isnm5": "",
+ "kor_isnm6": "",
+ "kor_isnm7": "",
+ "kor_isnm8": "",
+ "kor_isnm9": "",
+ "kor_isnm10": ""
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/278_해외주식-041_해외주식-상승율_하락율.md b/docs/broker/kis/rest/해외주식/시세분석/278_해외주식-041_해외주식-상승율_하락율.md
new file mode 100644
index 0000000..e0dc2b0
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/278_해외주식-041_해외주식-상승율_하락율.md
@@ -0,0 +1,96 @@
+# 해외주식 상승율_하락율
+
+- 원본 시트명: 해외주식 상승율_하락율
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-041
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76290000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/updown-rate
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 상승율/하락율 API입니다.
+한국투자 HTS(eFriend Plus) > [7629] 상승율/하락율 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76290000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| GUBN | 상승율/하락율 구분 | string | Y | 1 | 0(하락율), 1(상승율) |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(당일), 1(2일), 2(3일), 3(5일), 4(10일), 5(20일전), 6(30일), 7(60일), 8(120일), 9(1년) |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재Count | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| n_base | 기준가격 | string | Y | 12 | |
+| n_diff | 기준가격대비 | string | Y | 12 | |
+| n_rate | 기준가격대비율 | string | Y | 12 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/시세분석/279_해외주식-050_해외주식-권리종합.md b/docs/broker/kis/rest/해외주식/시세분석/279_해외주식-050_해외주식-권리종합.md
new file mode 100644
index 0000000..0a4a698
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/279_해외주식-050_해외주식-권리종합.md
@@ -0,0 +1,187 @@
+# 해외주식 권리종합
+
+- 원본 시트명: 해외주식 권리종합
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-050
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS78330900
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-price/v1/quotations/rights-by-ice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 권리종합 API입니다.
+한국투자 HTS(eFriend Plus) > [7833] 해외주식 권리(ICE제공) 화면의 "전체" 탭 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 조회기간 기준일 입력시 참고 - 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS78330900 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| NCOD | 국가코드 | string | Y | 2 | CN:중국 HK:홍콩 US:미국 JP:일본 VN:베트남 |
+| SYMB | 심볼 | string | Y | 20 | 종목코드 |
+| ST_YMD | 일자 시작일 | string | Y | 8 | 미입력 시, 오늘-3개월
기간지정 시, 종료일 입력(ex. 20240514)
※ 조회기간 기준일 입력시 참고
- 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일 |
+| ED_YMD | 일자 종료일 | string | Y | 8 | 미입력 시, 오늘+3개월
기간지정 시, 종료일 입력(ex. 20240514)
※ 조회기간 기준일 입력시 참고
- 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| anno_dt | ICE공시일 | string | Y | 8 | |
+| ca_title | 권리유형 | string | Y | 12 | |
+| div_lock_dt | 배당락일 | string | Y | 8 | |
+| pay_dt | 지급일 | string | Y | 8 | |
+| record_dt | 기준일 | string | Y | 8 | |
+| validity_dt | 효력일자 | string | Y | 8 | |
+| local_end_dt | 현지지시마감일 | string | Y | 8 | |
+| lock_dt | 권리락일 | string | Y | 8 | |
+| delist_dt | 상장폐지일 | string | Y | 8 | |
+| redempt_dt | 상환일자 | string | Y | 8 | |
+| early_redempt_dt | 조기상환일자 | string | Y | 8 | |
+| effective_dt | 적용일 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+NCOD:US
+SYMB:MAIN
+ST_YMD:20240214
+ED_YMD:20240514
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "anno_dt": "20240221",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240607",
+ "pay_dt": "20240614",
+ "record_dt": "20240607",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ },
+ {
+ "anno_dt": "20240221",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240405",
+ "pay_dt": "20240415",
+ "record_dt": "20240408",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ },
+ {
+ "anno_dt": "20240221",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240507",
+ "pay_dt": "20240515",
+ "record_dt": "20240508",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ },
+ {
+ "anno_dt": "20240507",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240808",
+ "pay_dt": "20240815",
+ "record_dt": "20240808",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ },
+ {
+ "anno_dt": "20240507",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240708",
+ "pay_dt": "20240715",
+ "record_dt": "20240708",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ },
+ {
+ "anno_dt": "20240507",
+ "ca_title": "현금배당",
+ "div_lock_dt": "20240906",
+ "pay_dt": "20240913",
+ "record_dt": "20240906",
+ "validity_dt": "",
+ "local_end_dt": "",
+ "lock_dt": "",
+ "delist_dt": "",
+ "redempt_dt": "",
+ "early_redempt_dt": "",
+ "effective_dt": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/시세분석/280_해외주식-043_해외주식-거래량순위.md b/docs/broker/kis/rest/해외주식/시세분석/280_해외주식-043_해외주식-거래량순위.md
new file mode 100644
index 0000000..9d79911
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/시세분석/280_해외주식-043_해외주식-거래량순위.md
@@ -0,0 +1,96 @@
+# 해외주식 거래량순위
+
+- 원본 시트명: 해외주식 거래량순위
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 시세분석
+- API ID: 해외주식-043
+- HTTP Method: GET
+- 실전 TR_ID: HHDFS76310010
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/ranking/trade-vol
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 거래량순위 API입니다.
+한국투자 HTS(eFriend Plus) > [7631] 거래대금순위 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFS76310010 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
+| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
+| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천
HSX : 호치민, HNX : 하노이
TSE : 도쿄 ' |
+| NDAY | N일자값 | string | Y | 1 | N일전 : 0(당일), 1(2일), 2(3일), 3(5일), 4(10일), 5(20일전), 6(30일), 7(60일), 8(120일), 9(1년) |
+| PRC1 | 현재가 필터범위 1 | string | Y | 12 | 가격 ~ |
+| PRC2 | 현재가 필터범위 2 | string | Y | 12 | ~ 가격 |
+| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | |
+| zdiv | 소수점자리수 | string | Y | 1 | |
+| stat | 거래상태정보 | string | Y | 20 | |
+| crec | 현재조회종목수 | string | Y | 6 | |
+| trec | 전체조회종목수 | string | Y | 6 | |
+| nrec | RecordCount | string | Y | 4 | |
+| output2 | 응답상세 | object array | Y | | array |
+| rsym | 실시간조회심볼 | string | Y | 16 | |
+| excd | 거래소코드 | string | Y | 4 | |
+| symb | 종목코드 | string | Y | 1 | |
+| name | 종목명 | string | Y | 48 | |
+| last | 현재가 | string | Y | 16 | |
+| sign | 기호 | string | Y | 1 | |
+| diff | 대비 | string | Y | 12 | |
+| rate | 등락율 | string | Y | 12 | |
+| pask | 매도호가 | string | Y | 12 | |
+| pbid | 매수호가 | string | Y | 12 | |
+| tvol | 거래량 | string | Y | 14 | |
+| tamt | 거래대금 | string | Y | 14 | |
+| a_tvol | 평균거래량 | string | Y | 14 | |
+| rank | 순위 | string | Y | 6 | |
+| ename | 영문종목명 | string | Y | 48 | |
+| e_ordyn | 매매가능 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/234_v1_해외주식-006_해외주식-잔고.md b/docs/broker/kis/rest/해외주식/주문/계좌/234_v1_해외주식-006_해외주식-잔고.md
new file mode 100644
index 0000000..1e40c5b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/234_v1_해외주식-006_해외주식-잔고.md
@@ -0,0 +1,187 @@
+# 해외주식 잔고
+
+- 원본 시트명: 해외주식 잔고
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-006
+- HTTP Method: GET
+- 실전 TR_ID: TTTS3012R
+- 모의 TR_ID: VTTS3012R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-balance
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 잔고를 조회하는 API 입니다.
+한국투자 HTS(eFriend Plus) > [7600] 해외주식 종합주문 화면의 좌측 하단 '실시간잔고' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+다만 미국주간거래 가능종목에 대해서는 frcr_evlu_pfls_amt(외화평가손익금액), evlu_pfls_rt(평가손익율), ovrs_stck_evlu_amt(해외주식평가금액), now_pric2(현재가격2) 값이 HTS와는 상이하게 표출될 수 있습니다.
+(주간시간 시간대에 HTS는 주간시세로 노출, API로는 야간시세로 노출)
+
+실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 미니스탁 잔고는 해당 API로 확인이 불가합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTS3012R
[모의투자]
VTTS3012R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | [모의]
NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
[실전]
NASD : 미국전체
NAS : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
[모의/실전 공통]
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| TR_CRCY_CD | 거래통화코드 | string | Y | 3 | USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | N | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | N | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output1 | 응답상세1 | array | Y | | |
+| cano | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | 계좌상품코드 |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| ovrs_pdno | 해외상품번호 | string | Y | 12 | |
+| ovrs_item_name | 해외종목명 | string | Y | 60 | |
+| frcr_evlu_pfls_amt | 외화평가손익금액 | string | Y | 30 | 해당 종목의 매입금액과 평가금액의 외회기준 비교 손익 |
+| evlu_pfls_rt | 평가손익율 | string | Y | 10 | 해당 종목의 평가손익을 기준으로 한 수익률 |
+| pchs_avg_pric | 매입평균가격 | string | Y | 23 | 해당 종목의 매수 평균 단가 |
+| ovrs_cblc_qty | 해외잔고수량 | string | Y | 19 | |
+| ord_psbl_qty | 주문가능수량 | string | Y | 10 | 매도 가능한 주문 수량 |
+| frcr_pchs_amt1 | 외화매입금액1 | string | Y | 23 | 해당 종목의 외화 기준 매입금액 |
+| ovrs_stck_evlu_amt | 해외주식평가금액 | string | Y | 32 | 해당 종목의 외화 기준 평가금액 |
+| now_pric2 | 현재가격2 | string | Y | 25 | 해당 종목의 현재가 |
+| tr_crcy_cd | 거래통화코드 | string | Y | 3 | USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동 |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 하노이거래소
VNSE : 호치민거래소 |
+| loan_type_cd | 대출유형코드 | string | Y | 2 | 00 : 해당사항없음
01 : 자기융자일반형
03 : 자기융자투자형
05 : 유통융자일반형
06 : 유통융자투자형
07 : 자기대주
09 : 유통대주
10 : 현금
11 : 주식담보대출
12 : 수익증권담보대출
13 : ELS담보대출
14 : 채권담보대출
15 : 해외주식담보대출
16 : 기업신용공여
31 : 소액자동담보대출
41 : 매도담보대출
42 : 환매자금대출
43 : 매입환매자금대출
44 : 대여매도담보대출
81 : 대차거래
82 : 법인CMA론
91 : 공모주청약자금대출
92 : 매입자금
93 : 미수론서비스
94 : 대여 |
+| loan_dt | 대출일자 | string | Y | 8 | 대출 실행일자 |
+| expd_dt | 만기일자 | string | Y | 8 | 대출 만기일자 |
+| output2 | 응답상세2 | object | Y | | |
+| frcr_pchs_amt1 | 외화매입금액1 | string | Y | 24 | |
+| ovrs_rlzt_pfls_amt | 해외실현손익금액 | string | Y | 20 | |
+| ovrs_tot_pfls | 해외총손익 | string | Y | 24 | |
+| rlzt_erng_rt | 실현수익율 | string | Y | 32 | |
+| tot_evlu_pfls_amt | 총평가손익금액 | string | Y | 32 | |
+| tot_pftrt | 총수익률 | string | Y | 32 | |
+| frcr_buy_amt_smtl1 | 외화매수금액합계1 | string | Y | 25 | |
+| ovrs_rlzt_pfls_amt2 | 해외실현손익금액2 | string | Y | 24 | |
+| frcr_buy_amt_smtl2 | 외화매수금액합계2 | string | Y | 25 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD":"01",
+"OVRS_EXCG_CD": "NASD",
+"TR_CRCY_CD": "USD",
+"CTX_AREA_FK200": "",
+"CTX_AREA_NK200": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": " ",
+ "ctx_area_nk200": " ",
+ "output1": [
+ {
+ "cano": "810XXXXX",
+ "acnt_prdt_cd": "01",
+ "prdt_type_cd": "512",
+ "ovrs_pdno": "TSLA",
+ "ovrs_item_name": "테슬라",
+ "frcr_evlu_pfls_amt": "-3547254.185235",
+ "evlu_pfls_rt": "-81.75",
+ "pchs_avg_pric": "5832.2148",
+ "ovrs_cblc_qty": "744",
+ "ord_psbl_qty": "744",
+ "frcr_pchs_amt1": "4339167.78523",
+ "ovrs_stck_evlu_amt": "791913.60000000",
+ "now_pric2": "1064.400000",
+ "tr_crcy_cd": "USD",
+ "ovrs_excg_cd": "NASD",
+ "loan_type_cd": "10",
+ "loan_dt": "",
+ "expd_dt": ""
+ },
+ {
+ "cano": "",
+ "acnt_prdt_cd": "",
+ "prdt_type_cd": "",
+ "ovrs_pdno": "",
+ "ovrs_item_name": "",
+ "frcr_evlu_pfls_amt": "0.000000",
+ "evlu_pfls_rt": "0.00",
+ "pchs_avg_pric": "0.0000",
+ "ovrs_cblc_qty": "0",
+ "ord_psbl_qty": "0",
+ "frcr_pchs_amt1": "0.00000",
+ "ovrs_stck_evlu_amt": "0.00000000",
+ "now_pric2": "0.000000",
+ "tr_crcy_cd": "",
+ "ovrs_excg_cd": "",
+ "loan_type_cd": "",
+ "loan_dt": "",
+ "expd_dt": ""
+ }
+ ],
+ "output2": {
+ "frcr_pchs_amt1": "4339167.78523",
+ "ovrs_rlzt_pfls_amt": "-4836.71476",
+ "ovrs_tot_pfls": "-3547254.18524",
+ "rlzt_erng_rt": "-82.93101266",
+ "tot_evlu_pfls_amt": "791913.60000000",
+ "tot_pftrt": "-81.74964327",
+ "frcr_buy_amt_smtl1": "5832.214765",
+ "ovrs_rlzt_pfls_amt2": "-5780841.48713",
+ "frcr_buy_amt_smtl2": "6970663.087128"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/235_v1_해외주식-008_해외주식-체결기준현재잔고.md b/docs/broker/kis/rest/해외주식/주문/계좌/235_v1_해외주식-008_해외주식-체결기준현재잔고.md
new file mode 100644
index 0000000..3332d6b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/235_v1_해외주식-008_해외주식-체결기준현재잔고.md
@@ -0,0 +1,367 @@
+# 해외주식 체결기준현재잔고
+
+- 원본 시트명: 해외주식 체결기준현재잔고
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-008
+- HTTP Method: GET
+- 실전 TR_ID: CTRP6504R
+- 모의 TR_ID: VTRP6504R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443 (output3만 이용 가능)
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-present-balance
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 잔고를 체결 기준으로 확인하는 API 입니다.
+
+HTS(eFriend Plus) [0839] 해외 체결기준잔고 화면을 API로 구현한 사항으로 화면을 함께 보시면 기능 이해가 쉽습니다.
+
+(※모의계좌의 경우 output3(외화평가총액 등 확인 가능)만 정상 출력됩니다.
+잔고 확인을 원하실 경우에는 해외주식 잔고[v1_해외주식-006] API 사용을 부탁드립니다.)
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+해외주식 체결기준현재잔고 유의사항
+1. 해외증권 체결기준 잔고현황을 조회하는 화면입니다.
+2. 온라인국가는 수수료(국내/해외)가 반영된 최종 정산금액으로 잔고가 변동되며, 결제작업 지연등으로 인해 조회시간은 차이가 발생할 수 있습니다.
+ - 아시아 온라인국가 : 매매일 익일 08:40 ~ 08:45분 경
+ - 미국 온라인국가 : 당일 장 종료후 08:40 ~ 08:45분 경
+ ※ 단, 애프터연장 참여 신청계좌는 10:30 ~ 10:35분 경(Summer Time : 09:30 ~ 09:35분 경)에 최종 정산금액으로 변동됩니다.
+3. 미국 현재가 항목은 주간시세 및 애프터시세는 반영하지 않으며, 정규장 마감 후에는 종가로 조회됩니다.
+4. 온라인국가를 제외한 국가의 현재가는 실시간 시세가 아니므로 주문화면의 잔고 평가금액 등과 차이가 발생할 수 있습니다.
+5. 해외주식 담보대출 매도상환 체결내역은 해당 잔고화면에 반영되지 않습니다.
+ 결제가 완료된 이후 외화잔고에 포함되어 반영되오니 참고하여 주시기 바랍니다.
+6. 외화평가금액은 당일 최초고시환율이 적용된 금액으로 실제 환전금액과는 차이가 있습니다.
+7. 미국은 메인 시스템이 아닌 별도 시스템을 통해 거래되므로, 18시 10~15분 이후 발생하는 미국 매매내역은 해당 화면에 실시간으로 반영되지 않으니 하단 내용을 참고하여 안내하여 주시기 바랍니다.
+ [외화잔고 및 해외 유가증권 현황 조회]
+ - 일반/통합증거금 계좌 : 미국장 종료 + 30분 후 부터 조회 가능
+ 단, 통합증거금 계좌에 한해 주문금액은 외화잔고 항목에 실시간 반영되며, 해외 유가증권 현황은 반영되지
+ 않아 해외 유가증권 평가금액이 과다 또는 과소 평가될 수 있습니다.
+ - 애프터연장 신청계좌 : 실시간 반영
+ 단, 시스템정산작업시간(23:40~00:10) 및 거래량이 많은 경우 메인시스템에 반영되는 시간으로 인해 차이가
+ 발생할 수 있습니다.
+ ※ 배치작업시간에 따라 시간은 변동될 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
CTRP6504R
[모의투자]
VTRP6504R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| WCRC_FRCR_DVSN_CD | 원화외화구분코드 | string | Y | 2 | 01 : 원화
02 : 외화 |
+| NATN_CD | 국가코드 | string | Y | 3 | 000 전체
840 미국
344 홍콩
156 중국
392 일본
704 베트남 |
+| TR_MKET_CD | 거래시장코드 | string | Y | 2 | [Request body NATN_CD 000 설정]
00 : 전체
[Request body NATN_CD 840 설정]
00 : 전체
01 : 나스닥(NASD)
02 : 뉴욕거래소(NYSE)
03 : 미국(PINK SHEETS)
04 : 미국(OTCBB)
05 : 아멕스(AMEX)
[Request body NATN_CD 156 설정]
00 : 전체
01 : 상해B
02 : 심천B
03 : 상해A
04 : 심천A
[Request body NATN_CD 392 설정]
01 : 일본
[Request body NATN_CD 704 설정]
01 : 하노이거래
02 : 호치민거래소
[Request body NATN_CD 344 설정]
01 : 홍콩
02 : 홍콩CNY
03 : 홍콩USD |
+| INQR_DVSN_CD | 조회구분코드 | string | Y | 2 | 00 : 전체
01 : 일반해외주식
02 : 미니스탁 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output1 | 응답상세1 (체결기준 잔고) | array | Y | | 체결기준현재잔고 없으면 빈값으로 출력 |
+| prdt_name | 상품명 | string | Y | 60 | 종목명 |
+| cblc_qty13 | 잔고수량13 | string | Y | 32 | 결제보유수량 |
+| thdt_buy_ccld_qty1 | 당일매수체결수량1 | string | Y | 32 | 당일 매수 체결 완료 수량 |
+| thdt_sll_ccld_qty1 | 당일매도체결수량1 | string | Y | 32 | 당일 매도 체결 완료 수량 |
+| ccld_qty_smtl1 | 체결수량합계1 | string | Y | 32 | 체결기준 현재 보유수량 |
+| ord_psbl_qty1 | 주문가능수량1 | string | Y | 32 | 주문 가능한 주문 수량 |
+| frcr_pchs_amt | 외화매입금액 | string | Y | 29 | 해당 종목의 외화 기준 매입금액 |
+| frcr_evlu_amt2 | 외화평가금액2 | string | Y | 30 | 해당 종목의 외화 기준 평가금액 |
+| evlu_pfls_amt2 | 평가손익금액2 | string | Y | 31 | 해당 종목의 매입금액과 평가금액의 외회기준 비교 손익 |
+| evlu_pfls_rt1 | 평가손익율1 | string | Y | 32 | 해당 종목의 평가손익을 기준으로 한 수익률 |
+| pdno | 상품번호 | string | Y | 12 | 종목코드 |
+| bass_exrt | 기준환율 | string | Y | 31 | 원화 평가 시 적용 환율 |
+| buy_crcy_cd | 매수통화코드 | string | Y | 3 | USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동 |
+| ovrs_now_pric1 | 해외현재가격1 | string | Y | 29 | 해당 종목의 현재가 |
+| avg_unpr3 | 평균단가3 | string | Y | 29 | 해당 종목의 매수 평균 단가 |
+| tr_mket_name | 거래시장명 | string | Y | 60 | 해당 종목의 거래시장명 |
+| natn_kor_name | 국가한글명 | string | Y | 60 | 거래 국가명 |
+| pchs_rmnd_wcrc_amt | 매입잔액원화금액 | string | Y | 19 | |
+| thdt_buy_ccld_frcr_amt | 당일매수체결외화금액 | object | Y | 30 | 당일 매수 외화금액
(Type: Object X String O) |
+| thdt_sll_ccld_frcr_amt | 당일매도체결외화금액 | string | Y | 30 | 당일 매도 외화금액 |
+| unit_amt | 단위금액 | string | Y | 19 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| scts_dvsn_name | 유가증권구분명 | string | Y | 60 | |
+| loan_rmnd | 대출잔액 | string | Y | 19 | 대출 미상환 금액 |
+| loan_dt | 대출일자 | string | Y | 8 | 대출 실행일자 |
+| loan_expd_dt | 대출만기일자 | string | Y | 8 | 대출 만기일자 |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 하노이거래소
VNSE : 호치민거래소 |
+| item_lnkg_excg_cd | 종목연동거래소코드 | string | Y | 4 | prdt_dvsn(상품구분) : 직원용 데이터(Type: String, Length:2) |
+| output2 | 응답상세2 | array | Y | | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| crcy_cd_name | 통화코드명 | string | Y | 60 | |
+| frcr_buy_amt_smtl | 외화매수금액합계 | string | Y | 29 | 해당 통화로 매수한 종목 전체의 매수금액 |
+| frcr_sll_amt_smtl | 외화매도금액합계 | string | Y | 29 | 해당 통화로 매도한 종목 전체의 매수금액 |
+| frcr_dncl_amt_2 | 외화예수금액2 | string | Y | 29 | 외화로 표시된 외화사용가능금액 |
+| frst_bltn_exrt | 최초고시환율 | string | Y | 31 | |
+| frcr_buy_mgn_amt | 외화매수증거금액 | string | Y | 31 | 매수증거금으로 사용된 외화금액 |
+| frcr_etc_mgna | 외화기타증거금 | string | Y | 31 | |
+| frcr_drwg_psbl_amt_1 | 외화출금가능금액1 | string | Y | 29 | 출금가능한 외화금액 |
+| frcr_evlu_amt2 | 출금가능원화금액 | string | Y | 29 | 출금가능한 원화금액 |
+| acpl_cstd_crcy_yn | 현지보관통화여부 | string | Y | 1 | |
+| nxdy_frcr_drwg_psbl_amt | 익일외화출금가능금액 | string | Y | 31 | |
+| output3 | 응답상세3 | object | Y | | |
+| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | 해외유가증권 매수금액의 원화 환산 금액 |
+| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | 해외유가증권 평가금액의 원화 환산 금액 |
+| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | 해외유가증권 평가손익의 원화 환산 금액 |
+| dncl_amt | 예수금액 | string | Y | 19 | |
+| cma_evlu_amt | CMA평가금액 | string | Y | 19 | |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
+| etc_mgna | 기타증거금 | string | Y | 19 | |
+| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
+| frcr_evlu_tota | 외화평가총액 | string | Y | 19 | |
+| evlu_erng_rt1 | 평가수익율1 | string | Y | 31 | |
+| pchs_amt_smtl_amt | 매입금액합계금액 | string | Y | 19 | |
+| evlu_amt_smtl_amt | 평가금액합계금액 | string | Y | 19 | |
+| tot_evlu_pfls_amt | 총평가손익금액 | string | Y | 31 | |
+| tot_asst_amt | 총자산금액 | string | Y | 19 | |
+| buy_mgn_amt | 매수증거금액 | string | Y | 19 | |
+| mgna_tota | 증거금총액 | string | Y | 19 | |
+| frcr_use_psbl_amt | 외화사용가능금액 | string | Y | 20 | |
+| ustl_sll_amt_smtl | 미결제매도금액합계 | string | Y | 19 | |
+| ustl_buy_amt_smtl | 미결제매수금액합계 | string | Y | 19 | |
+| tot_frcr_cblc_smtl | 총외화잔고합계 | string | Y | 29 | |
+| tot_loan_amt | 총대출금액 | string | Y | 19 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD":"01",
+"WCRC_FRCR_DVSN_CD": "01",
+"TR_MKET_CD": "00",
+"NATN_CD": "000",
+"INQR_DVSN_CD": "00"
+}
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "prdt_name": "애플",
+ "cblc_qty13": "40.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "40.00000000",
+ "ord_psbl_qty1": "40.00000000",
+ "frcr_pchs_amt": "6411629.00000",
+ "frcr_evlu_amt2": "8491110.000000",
+ "evlu_pfls_amt2": "2079481.00000",
+ "evlu_pfls_rt1": "32.43000000",
+ "pdno": "AAPL",
+ "bass_exrt": "1212.60000000",
+ "buy_crcy_cd": "USD",
+ "ovrs_now_pric1": "212277.75600",
+ "avg_unpr3": "160290.7250",
+ "tr_mket_name": "나스닥",
+ "natn_kor_name": "미국",
+ "pchs_rmnd_wcrc_amt": "5986768",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "1",
+ "std_pdno": "US0378331005",
+ "prdt_type_cd": "512",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "NASD",
+ "item_lnkg_excg_cd": "NAS"
+ },
+ {
+ "prdt_name": "테슬라",
+ "cblc_qty13": "5.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "5.00000000",
+ "ord_psbl_qty1": "5.00000000",
+ "frcr_pchs_amt": "4665399.00000",
+ "frcr_evlu_amt2": "6616309.000000",
+ "evlu_pfls_amt2": "1950910.00000",
+ "evlu_pfls_rt1": "41.81000000",
+ "pdno": "TSLA",
+ "bass_exrt": "1212.60000000",
+ "buy_crcy_cd": "USD",
+ "ovrs_now_pric1": "1323261.87600",
+ "avg_unpr3": "933079.8000",
+ "tr_mket_name": "나스닥",
+ "natn_kor_name": "미국",
+ "pchs_rmnd_wcrc_amt": "4560861",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "1",
+ "std_pdno": "US88160R1014",
+ "prdt_type_cd": "512",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "NASD",
+ "item_lnkg_excg_cd": "NAS"
+ },
+ {
+ "prdt_name": "월트디즈니",
+ "cblc_qty13": "24.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "24.00000000",
+ "ord_psbl_qty1": "24.00000000",
+ "frcr_pchs_amt": "5039237.00000",
+ "frcr_evlu_amt2": "3946867.000000",
+ "evlu_pfls_amt2": "-1092370.00000",
+ "evlu_pfls_rt1": "-21.67000000",
+ "pdno": "DIS",
+ "bass_exrt": "1212.60000000",
+ "buy_crcy_cd": "USD",
+ "ovrs_now_pric1": "164452.81200",
+ "avg_unpr3": "209968.2080",
+ "tr_mket_name": "뉴욕거래소",
+ "natn_kor_name": "미국",
+ "pchs_rmnd_wcrc_amt": "4766780",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "1",
+ "std_pdno": "US2546871060",
+ "prdt_type_cd": "513",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "NYSE",
+ "item_lnkg_excg_cd": "NYS"
+ },
+ {
+ "prdt_name": "[4689]Z홀딩스",
+ "cblc_qty13": "1300.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "1300.00000000",
+ "ord_psbl_qty1": "1300.00000000",
+ "frcr_pchs_amt": "8556162.00000",
+ "frcr_evlu_amt2": "6618273.000000",
+ "evlu_pfls_amt2": "-1937889.00000",
+ "evlu_pfls_rt1": "-22.64000000",
+ "pdno": "4689",
+ "bass_exrt": "981.11000000",
+ "buy_crcy_cd": "JPY",
+ "ovrs_now_pric1": "5090.97900",
+ "avg_unpr3": "6581.6630",
+ "tr_mket_name": "일본",
+ "natn_kor_name": "일본",
+ "pchs_rmnd_wcrc_amt": "9196585",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "100",
+ "std_pdno": "JP3933800009",
+ "prdt_type_cd": "515",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "TKSE",
+ "item_lnkg_excg_cd": "TSE"
+ },
+ {
+ "prdt_name": "ARK GENOMIC REVOLUTION ETF",
+ "cblc_qty13": "36.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "36.00000000",
+ "ord_psbl_qty1": "36.00000000",
+ "frcr_pchs_amt": "3746679.00000",
+ "frcr_evlu_amt2": "2022471.000000",
+ "evlu_pfls_amt2": "-1724208.00000",
+ "evlu_pfls_rt1": "-46.01000000",
+ "pdno": "ARKG",
+ "bass_exrt": "1212.60000000",
+ "buy_crcy_cd": "USD",
+ "ovrs_now_pric1": "56179.75800",
+ "avg_unpr3": "104074.4160",
+ "tr_mket_name": "아멕스",
+ "natn_kor_name": "미국",
+ "pchs_rmnd_wcrc_amt": "3533904",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "1",
+ "std_pdno": "US00214Q3020",
+ "prdt_type_cd": "529",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "AMEX",
+ "item_lnkg_excg_cd": "AMS"
+ },
+ {
+ "prdt_name": "[002747]애사돈자동화",
+ "cblc_qty13": "400.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "ccld_qty_smtl1": "400.00000000",
+ "ord_psbl_qty1": "400.00000000",
+ "frcr_pchs_amt": "2327369.00000",
+ "frcr_evlu_amt2": "1525444.000000",
+ "evlu_pfls_amt2": "-801925.00000",
+ "evlu_pfls_rt1": "-34.45000000",
+ "pdno": "002747",
+ "bass_exrt": "190.30000000",
+ "buy_crcy_cd": "CNY",
+ "ovrs_now_pric1": "3813.61200",
+ "avg_unpr3": "5818.4220",
+ "tr_mket_name": "심천A",
+ "natn_kor_name": "중화인민공화국",
+ "pchs_rmnd_wcrc_amt": "2121990",
+ "thdt_buy_ccld_frcr_amt": "0.000000",
+ "thdt_sll_ccld_frcr_amt": "0.000000",
+ "unit_amt": "1",
+ "std_pdno": "CNE100001X35",
+ "prdt_type_cd": "552",
+ "scts_dvsn_name": "현금",
+ "loan_rmnd": "0",
+ "loan_dt": "",
+ "loan_expd_dt": "",
+ "ovrs_excg_cd": "SZAA",
+ "item_lnkg_excg_c
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/236_해외주식-070_해외주식-지정가체결내역조회.md b/docs/broker/kis/rest/해외주식/주문/계좌/236_해외주식-070_해외주식-지정가체결내역조회.md
new file mode 100644
index 0000000..27a040e
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/236_해외주식-070_해외주식-지정가체결내역조회.md
@@ -0,0 +1,132 @@
+# 해외주식 지정가체결내역조회
+
+- 원본 시트명: 해외주식 지정가체결내역조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: 해외주식-070
+- HTTP Method: GET
+- 실전 TR_ID: TTTS6059R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-algo-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 TWAP, VWAP 주문에 대한 체결내역 조회 API로 지정가 주문번호조회 API를 수행 후 조회해야합니다
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTS6059R |
+| tr_cont | 연속거래여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | Y | 1 | P : 개인 / B : 법인 |
+| seq_no | 일련번호 | string | N | 3 | 법인 필수 : 001 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | IP주소 | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 계좌번호 | string | Y | 8 | 종합계좌번호 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 상품코드 2자리 (주식계좌 : 01) |
+| ORD_DT | 주문일자 | string | Y | 8 | 주문일자 (YYYYMMDD) |
+| ORD_GNO_BRNO | 주문채번지점번호 | string | N | 5 | TTS6058R 조회 시 해당 주문번호(odno)의 ord_gno_brno 입력 |
+| ODNO | 주문번호 | string | Y | 10 | 지정가주문번호 (TTTS6058R)에서 조회된 주문번호 입력 |
+| TTLZ_ICLD_YN | 집계포함여부 | string | N | 1 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | N | 200 | 연속조회 시 사용 |
+| CTX_AREA_FK200 | 연속조회조건200 | string | N | 200 | 연속조회 시 사용 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 거래ID |
+| tr_cont | 연속거래여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메시지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | |
+| CCLD_SEQ | 체결순번 | string | Y | 4 | |
+| CCLD_BTWN | 체결시간 | string | Y | 6 | HHMMSS |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ITEM_NAME | 종목명 | string | Y | 60 | |
+| FT_CCLD_QTY | FT체결수량 | string | N | 4 | |
+| FT_CCLD_UNPR3 | FT체결단가 | string | Y | 8 | |
+| FT_CCLD_AMT3 | FT체결금액 | string | N | 8 | |
+| output3 | 응답상세3 | object array | Y | | |
+| ODNO | 주문번호 | string | Y | 10 | |
+| TRAD_DVSN_NAME | 매매구분명 | string | Y | 60 | |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ITEM_NAME | 종목명 | string | Y | 60 | |
+| FT_ORD_QTY | FT주문수량 | string | Y | 4 | |
+| FT_ORD_UNPR3 | FT주문단가 | string | Y | 8 | |
+| ORD_TMD | 주문시각 | string | Y | 6 | |
+| SPLT_BUY_ATTR_NAME | 분할매수속성명 | string | Y | 60 | |
+| FT_CCLD_QTY | FT체결수량 | string | Y | 4 | |
+| TR_CRCY | 거래통화 | string | Y | 3 | |
+| FT_CCLD_UNPR3 | FT체결단가 | string | Y | 8 | |
+| FT_CCLD_AMT3 | FT체결금액 | string | Y | 8 | |
+| CCLD_CNT | 체결건수 | string | Y | 4 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+ORD_DT:20250523
+ORD_GNO_BRNO:
+ODNO:0031112345
+TTLZ_ICLD_YN:
+CTX_AREA_NK200:
+CTX_AREA_FK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk200": " ",
+ "ctx_area_fk200": "20250523^^0031112345^ ",
+ "output1": [],
+ "output2": {
+ "odno": "0031112345",
+ "trad_dvsn_name": "TWAP지정가매수",
+ "pdno": "AAPL",
+ "item_name": "애플",
+ "ft_ord_qty": "10",
+ "ft_ord_unpr3": "10.00000000",
+ "ord_tmd": "173904",
+ "splt_buy_attr_name": "00:00~04:00",
+ "ft_ccld_qty": "0",
+ "tr_crcy": "",
+ "ft_ccld_unpr3": "0.00000000",
+ "ft_ccld_amt3": "0.00000",
+ "ccld_cnt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0560",
+ "msg1": "조회할 내용이 없습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/237_v1_해외주식-032_해외주식-기간손익.md b/docs/broker/kis/rest/해외주식/주문/계좌/237_v1_해외주식-032_해외주식-기간손익.md
new file mode 100644
index 0000000..7435657
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/237_v1_해외주식-032_해외주식-기간손익.md
@@ -0,0 +1,112 @@
+# 해외주식 기간손익
+
+- 원본 시트명: 해외주식 기간손익
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-032
+- HTTP Method: GET
+- 실전 TR_ID: TTTS3039R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-period-profit
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 기간손익 API입니다.
+한국투자 HTS(eFriend Plus) > [7717] 해외 기간손익 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+[해외 기간손익 유의 사항]
+■ 단순 매체결내역을 기초로 만든 화면으로 매도체결시점의 체결기준 매입단가와 비교하여 손익이 계산됩니다.
+ 결제일의 환율과 금액을 기준으로 산출하는 해외주식 양도소득세 계산방식과는 상이하오니, 참고용으로만 활용하여 주시기 바랍니다.
+■ 기간손익은 매매일 익일부터 조회가능합니다.
+■ 매입금액/매도금액 원화 환산 시 매도일의 환율이 적용되어있습니다.
+■ 손익금액의 비용은 "매도비용" 만 포함되어있습니다. 단, 동일 종목의 매수/매도가 동시에 있는 경우에는 해당일 발생한 매수비용도 함께 계산됩니다.
+■ 담보상환내역은 기간손익화면에 표시되지 많으니 참고하여 주시기 바랍니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTS3039R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 2 | 공란 : 전체,
NASD : 미국, SEHK : 홍콩,
SHAA : 중국, TKSE : 일본, HASE : 베트남 |
+| NATN_CD | 국가코드 | string | Y | 2 | 공란(Default) |
+| CRCY_CD | 통화코드 | string | Y | 2 | 공란 : 전체
USD : 미국달러, HKD : 홍콩달러,
CNY : 중국위안화, JPY : 일본엔화, VND : 베트남동 |
+| PDNO | 상품번호 | string | Y | 2 | 공란 : 전체 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 2 | YYYYMMDD |
+| INQR_END_DT | 조회종료일자 | string | Y | 2 | YYYYMMDD |
+| WCRC_FRCR_DVSN_CD | 원화외화구분코드 | string | Y | 2 | 01 : 외화, 02 : 원화 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 2 | |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 2 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| Output1 | 응답상세 | object array | Y | | array |
+| trad_day | 매매일 | string | Y | 8 | |
+| ovrs_pdno | 해외상품번호 | string | Y | 12 | |
+| ovrs_item_name | 해외종목명 | string | Y | 60 | |
+| slcl_qty | 매도청산수량 | string | Y | 10 | |
+| pchs_avg_pric | 매입평균가격 | string | Y | 184 | |
+| frcr_pchs_amt1 | 외화매입금액1 | string | Y | 185 | |
+| avg_sll_unpr | 평균매도단가 | string | Y | 238 | |
+| frcr_sll_amt_smtl1 | 외화매도금액합계1 | string | Y | 186 | |
+| stck_sll_tlex | 주식매도제비용 | string | Y | 184 | |
+| ovrs_rlzt_pfls_amt | 해외실현손익금액 | string | Y | 145 | |
+| pftrt | 수익률 | string | Y | 238 | |
+| exrt | 환율 | string | Y | 201 | |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | |
+| frst_bltn_exrt | 최초고시환율 | string | Y | 238 | |
+| Output2 | 응답상세2 | object | Y | | |
+| stck_sll_amt_smtl | 주식매도금액합계 | string | Y | 184 | WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시 |
+| stck_buy_amt_smtl | 주식매수금액합계 | string | Y | 184 | WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시 |
+| smtl_fee1 | 합계수수료1 | string | Y | 138 | WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시 |
+| excc_dfrm_amt | 정산지급금액 | string | Y | 205 | WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시 |
+| ovrs_rlzt_pfls_tot_amt | 해외실현손익총금액 | string | Y | 145 | WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시 |
+| tot_pftrt | 총수익률 | string | Y | 238 | |
+| bass_dt | 기준일자 | string | Y | 8 | |
+| exrt | 환율 | string | Y | 201 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/238_v1_해외주식-014_해외주식-매수가능금액조회.md b/docs/broker/kis/rest/해외주식/주문/계좌/238_v1_해외주식-014_해외주식-매수가능금액조회.md
new file mode 100644
index 0000000..d96a440
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/238_v1_해외주식-014_해외주식-매수가능금액조회.md
@@ -0,0 +1,112 @@
+# 해외주식 매수가능금액조회
+
+- 원본 시트명: 해외주식 매수가능금액조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-014
+- HTTP Method: GET
+- 실전 TR_ID: TTTS3007R
+- 모의 TR_ID: VTTS3007R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-psamount
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 매수가능금액조회 API입니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTS3007R
[모의투자]
VTTS3007R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | N | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / 개인: ""(Default) |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD : 나스닥 / NYSE : 뉴욕 / AMEX : 아멕스
SEHK : 홍콩 / SHAA : 중국상해 / SZAA : 중국심천
TKSE : 일본 / HASE : 하노이거래소 / VNSE : 호치민거래소 |
+| OVRS_ORD_UNPR | 해외주문단가 | string | Y | 27 | 해외주문단가 (23.8) 정수부분 23자리, 소수부분 8자리 |
+| ITEM_CD | 종목코드 | string | Y | 12 | 종목코드 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세1 | object | N | | |
+| tr_crcy_cd | 거래통화코드 | string | N | 3 | 18.2 |
+| ord_psbl_frcr_amt | 주문가능외화금액 | string | N | 21 | 18.2 |
+| sll_ruse_psbl_amt | 매도재사용가능금액 | string | N | 21 | 가능금액 산정 시 사용 |
+| ovrs_ord_psbl_amt | 해외주문가능금액 | string | N | 21 | - 한국투자 앱 해외주식 주문화면내 "외화" 인경우 주문가능금액 |
+| max_ord_psbl_qty | 최대주문가능수량 | string | N | 19 | - 한국투자 앱 해외주식 주문화면내 "외화" 인경우 주문가능수량
- 매수 시 수량단위 절사해서 사용
예 : (100주단위) 545 주 -> 500 주 / (10주단위) 545 주 -> 540 주 |
+| echm_af_ord_psbl_amt | 환전이후주문가능금액 | string | N | 21 | 사용되지 않는 사항(0으로 출력) |
+| echm_af_ord_psbl_qty | 환전이후주문가능수량 | string | N | 19 | 사용되지 않는 사항(0으로 출력) |
+| ord_psbl_qty | 주문가능수량 | string | N | 10 | 22(20.1) |
+| exrt | 환율 | string | N | 22 | 25(18.6) |
+| frcr_ord_psbl_amt1 | 외화주문가능금액1 | string | N | 25 | - 한국투자 앱 해외주식 주문화면내 "통합" 인경우 주문가능금액 |
+| ovrs_max_ord_psbl_qty | 해외최대주문가능수량 | string | N | 19 | - 한국투자 앱 해외주식 주문화면내 "통합" 인경우 주문가능수량
- 매수 시 수량단위 절사해서 사용
예 : (100주단위) 545 주 -> 500 주 / (10주단위) 545 주 -> 540 주 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "ACNT_PRDT_CD": "01",
+ "CANO": "81019777",
+ "ITEM_CD": "00011",
+ "OVRS_EXCG_CD": "SEHK",
+ "OVRS_ORD_UNPR": "133.200"
+ }
+```
+
+### Response Example
+
+```text
+"output": {
+ "echm_af_ord_psbl_amt": "0.00",
+ "echm_af_ord_psbl_qty": "0",
+ "exrt": "165.5400000000",
+ "frcr_ord_psbl_amt1": "955**.12",
+ "max_ord_psbl_qty": "744**",
+ "ord_psbl_frcr_amt": "999**.52",
+ "ord_psbl_qty": "744**",
+ "ovrs_max_ord_psbl_qty": "717**",
+ "ovrs_ord_psbl_amt": "992**.35",
+ "sll_ruse_psbl_amt": "0.00",
+ "tr_crcy_cd": "HKD"
+ }
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/239_v1_해외주식-003_해외주식-정정취소주문.md b/docs/broker/kis/rest/해외주식/주문/계좌/239_v1_해외주식-003_해외주식-정정취소주문.md
new file mode 100644
index 0000000..731427b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/239_v1_해외주식-003_해외주식-정정취소주문.md
@@ -0,0 +1,121 @@
+# 해외주식 정정취소주문
+
+- 원본 시트명: 해외주식 정정취소주문
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-003
+- HTTP Method: POST
+- 실전 TR_ID: (미국 정정·취소) TTTT1004U (아시아 국가 하단 규격서 참고)
+- 모의 TR_ID: (미국 정정·취소) VTTT1004U (아시아 국가 하단 규격서 참고)
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/order-rvsecncl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+접수된 해외주식 주문을 정정하거나 취소하기 위한 API입니다.
+(해외주식주문 시 Return 받은 ODNO를 참고하여 API를 호출하세요.)
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 해외 거래소 운영시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요.
+* 해외 거래소 운영시간(한국시간 기준)
+1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
+ * 프리마켓(18:00 ~ 23:30, Summer Time : 17:00 ~ 22:30), 애프터마켓(06:00 ~ 07:00, Summer Time : 05:00 ~ 07:00) 시간대에도 주문 가능
+2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
+3) 상해 : 10:30 ~ 16:00
+4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTT1004U : 미국 정정 취소 주문
TTTS1003U : 홍콩 정정 취소 주문
TTTS0309U : 일본 정정 취소 주문
TTTS0302U : 상해 취소 주문
TTTS0306U : 심천 취소 주문
TTTS0312U : 베트남 취소 주문
[모의투자]
VTTT1004U : 미국 정정 취소 주문
VTTS1003U : 홍콩 정정 취소 주문
VTTS0309U : 일본 정정 취소 주문
VTTS0302U : 상해 취소 주문
VTTS0306U : 심천 취소 주문
VTTS0312U : 베트남 취소 주문 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| PDNO | 상품번호 | string | Y | 12 | |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | 정정 또는 취소할 원주문번호
(해외주식_주문 API ouput ODNO
or 해외주식 미체결내역 API output ODNO 참고) |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 01 : 정정
02 : 취소 |
+| ORD_QTY | 주문수량 | string | Y | 10 | |
+| OVRS_ORD_UNPR | 해외주문단가 | string | Y | 32 | 취소주문 시, "0" 입력 |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | N | 12 | |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | N | 1 | "0"(Default) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | |
+| KRX_FWDG_ORD_ORGNO | 한국거래소전송주문조직번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| ODNO | 주문번호 | string | Y | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문시각(시분초HHMMSS) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD": "01",
+"OVRS_EXCG_CD": "NYSE",
+"PDNO": "BA",
+"ORGN_ODNO": "30135009",
+"RVSE_CNCL_DVSN_CD": "01",
+"ORD_QTY": "1",
+"OVRS_ORD_UNPR": "226.00",
+"CTAC_TLNO": "",
+"MGCO_APTM_ODNO": "",
+"ORD_SVR_DVSN_CD": "0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000004338",
+ "ORD_TMD": "160710"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/240_v1_해외주식-002_해외주식-예약주문접수.md b/docs/broker/kis/rest/해외주식/주문/계좌/240_v1_해외주식-002_해외주식-예약주문접수.md
new file mode 100644
index 0000000..7536776
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/240_v1_해외주식-002_해외주식-예약주문접수.md
@@ -0,0 +1,144 @@
+# 해외주식 예약주문접수
+
+- 원본 시트명: 해외주식 예약주문접수
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-002
+- HTTP Method: POST
+- 실전 TR_ID: (미국예약매수) TTTT3014U (미국예약매도) TTTT3016U (중국/홍콩/일본/베트남 예약주문) TTTS3013U
+- 모의 TR_ID: (미국예약매수) VTTT3014U (미국예약매도) VTTT3016U (중국/홍콩/일본/베트남 예약주문) VTTS3013U
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/order-resv
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+미국거래소 운영시간 외 미국주식을 예약 매매하기 위한 API입니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+* 아래 각 국가의 시장별 예약주문 접수 가능 시간을 확인하시길 바랍니다.
+
+미국 예약주문 접수시간
+1) 10:00 ~ 23:20 / 10:00 ~ 22:20 (서머타임 시)
+2) 주문제한 : 16:30 ~ 16:45 경까지 (사유 : 시스템 정산작업시간)
+3) 23:30 정규장으로 주문 전송 (서머타임 시 22:30 정규장 주문 전송)
+4) 미국 거래소 운영시간(한국시간 기준) : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
+
+홍콩 예약주문 접수시간
+1) 09:00 ~ 10:20 접수, 10:30 주문전송
+2) 10:40 ~ 13:50 접수, 14:00 주문전송
+
+중국 예약주문 접수시간
+1) 09:00 ~ 10:20 접수, 10:30 주문전송
+2) 10:40 ~ 13:50 접수, 14:00 주문전송
+
+일본 예약주문 접수시간
+1) 09:10 ~ 12:20 까지 접수, 12:30 주문전송
+
+베트남 예약주문 접수시간
+1) 09:00 ~ 11:00 까지 접수, 11:15 주문전송
+2) 11:20 ~ 14:50 까지 접수, 15:00 주문전송
+
+* 예약주문 유의사항
+1) 예약주문 유효기간 : 당일
+ - 미국장 마감 후, 미체결주문은 자동취소
+ - 미국휴장 시, 익 영업일로 이전
+ (미국예약주문화면에서 취소 가능)
+2) 증거금 및 잔고보유 : 체크 안함
+3) 주문전송 불가사유
+ - 매수증거금 부족: 수수료 포함 매수금액부족, 환전, 시세이용료 출금, 인출에 의한 증거금 부족
+ - 기타 매수증거금 부족, 매도가능수량 부족, 주권변경 등 권리발생으로 인한 주문불가사유 발생
+4) 지정가주문만 가능
+* 단 미국 예약매도주문(TTTT3016U)의 경우, MOO(장개시시장가)로 주문 접수 가능
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTT3016U : 미국 매도 예약 주문
TTTT3014U : 미국 매수 예약 주문
TTTS3013U : 중국/홍콩/일본/베트남 예약 매수/매도/취소 주문
[모의투자]
VTTT3016U : 미국 매도 예약 주문
VTTT3014U : 미국 매수 예약 주문
VTTS3013U : 중국/홍콩/일본/베트남 예약 매수/매도/취소 주문 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | N | 2 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
01 : 매도
02 : 매수 |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
00 : "매도/매수 주문"시 필수 항목
02 : 취소 |
+| PDNO | 상품번호 | string | Y | 12 | |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
515 : 일본
501 : 홍콩 / 543 : 홍콩CNY / 558 : 홍콩USD
507 : 베트남 하노이거래소 / 508 : 베트남 호치민거래소
551 : 중국 상해A / 552 : 중국 심천A |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| FT_ORD_QTY | FT주문수량 | string | Y | 10 | |
+| FT_ORD_UNPR3 | FT주문단가3 | string | Y | 27 | |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | N | 1 | "0"(Default) |
+| RSVN_ORD_RCIT_DT | 예약주문접수일자 | string | N | 8 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용 |
+| ORD_DVSN | 주문구분 | string | N | 20 | tr_id가 TTTT3014U(미국 예약 매수 주문)인 경우만 사용
00 : 지정가
35 : TWAP
36 : VWAP
tr_id가 TTTT3016U(미국 예약 매도 주문)인 경우만 사용
00 : 지정가
31 : MOO(장개시시장가)
35 : TWAP
36 : VWAP |
+| OVRS_RSVN_ODNO | 해외예약주문번호 | string | N | 10 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용 |
+| ALGO_ORD_TMD_DVSN_CD | 알고리즘주문시간구분코드 | string | N | 2 | ※ TWAP, VWAP 주문에서만 사용. 예약주문은 시간입력 불가하여 02로 값 고정
※ 정규장 종료 10분전까지 가능 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | |
+| ODNO | 한국거래소전송주문조직번호 | string | Y | 10 | tr_id가 TTTT3016U(미국 예약 매도 주문) / TTTT3014U(미국 예약 매수 주문)인 경우만 출력 |
+| RSVN_ORD_RCIT_DT | 예약주문접수일자 | string | Y | 8 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 출력 |
+| OVRS_RSVN_ODNO | 해외예약주문번호 | string | Y | 10 | tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 출력 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD":"AAPL",
+"PDNO": "AAPL",
+"OVRS_EXCG_CD": "NASD",
+"FT_ORD_QTY": "1",
+"FT_ORD_UNPR3": "148.00"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "ODNO": "0030138295"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/241_v1_해외주식-005_해외주식-미체결내역.md b/docs/broker/kis/rest/해외주식/주문/계좌/241_v1_해외주식-005_해외주식-미체결내역.md
new file mode 100644
index 0000000..de06596
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/241_v1_해외주식-005_해외주식-미체결내역.md
@@ -0,0 +1,201 @@
+# 해외주식 미체결내역
+
+- 원본 시트명: 해외주식 미체결내역
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-005
+- HTTP Method: GET
+- 실전 TR_ID: TTTS3018R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-nccs
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+접수된 해외주식 주문 중 체결되지 않은 미체결 내역을 조회하는 API입니다.
+실전계좌의 경우, 한 번의 호출에 최대 40건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+※ 해외주식 미체결내역 API 모의투자에서는 사용이 불가합니다.
+ 모의투자로 해외주식 미체결내역 확인시에는 해외주식 주문체결내역[v1_해외주식-007] API 조회하셔서 nccs_qty(미체결수량)으로 해외주식 미체결수량을 조회하실 수 있습니다.
+
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 해외 거래소 운영시간(한국시간 기준)
+1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
+ * 프리마켓(18:00 ~ 23:30, Summer Time : 17:00 ~ 22:30), 애프터마켓(06:00 ~ 07:00, Summer Time : 05:00 ~ 07:00)
+2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
+3) 상해 : 10:30 ~ 16:00
+4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTS3018R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
* NASD 인 경우만 미국전체로 조회되며 나머지 거래소 코드는 해당 거래소만 조회됨
* 공백 입력 시 다음조회가 불가능하므로, 반드시 거래소코드 입력해야 함 |
+| SORT_SQN | 정렬순서 | string | Y | 2 | DS : 정순
그외 : 역순
[header tr_id: TTTS3018R]
""(공란) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output | 응답상세 | array | Y | | |
+| ord_dt | 주문일자 | string | Y | 8 | 주문접수 일자 |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
+| odno | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호 |
+| orgn_odno | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
+| pdno | 상품번호 | string | Y | 12 | 종목코드 |
+| prdt_name | 상품명 | string | Y | 60 | 종목명 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| sll_buy_dvsn_cd_name | 매도매수구분코드명 | string | Y | 60 | 매수매도구분명 |
+| rvse_cncl_dvsn_cd | 정정취소구분코드 | string | Y | 2 | 01 : 정정
02 : 취소 |
+| rvse_cncl_dvsn_cd_name | 정정취소구분코드명 | string | Y | 60 | 정정취소구분명 |
+| rjct_rson | 거부사유 | string | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유 |
+| rjct_rson_name | 거부사유명 | string | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유명 |
+| ord_tmd | 주문시각 | string | Y | 6 | 주문 접수 시간 |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| tr_crcy_cd | 거래통화코드 | string | Y | 3 | USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동 |
+| natn_cd | 국가코드 | string | Y | 3 | |
+| natn_kor_name | 국가한글명 | string | Y | 60 | |
+| ft_ord_qty | FT주문수량 | string | Y | 10 | 주문수량 |
+| ft_ccld_qty | FT체결수량 | string | Y | 10 | 체결된 수량 |
+| nccs_qty | 미체결수량 | string | Y | 10 | 미체결수량 |
+| ft_ord_unpr3 | FT주문단가3 | string | Y | 26 | 주문가격 |
+| ft_ccld_unpr3 | FT체결단가3 | string | Y | 26 | 체결된 가격 |
+| ft_ccld_amt3 | FT체결금액3 | string | Y | 23 | 체결된 금액 |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| prcs_stat_name | 처리상태명 | string | Y | 60 | "" |
+| loan_type_cd | 대출유형코드 | string | Y | 2 | 00 해당사항없음
01 자기융자일반형
03 자기융자투자형
05 유통융자일반형
06 유통융자투자형
07 자기대주
09 유통대주
10 현금
11 주식담보대출
12 수익증권담보대출
13 ELS담보대출
14 채권담보대출
15 해외주식담보대출
16 기업신용공여
31 소액자동담보대출
41 매도담보대출
42 환매자금대출
43 매입환매자금대출
44 대여매도담보대출
81 대차거래
82 법인CMA론
91 공모주청약자금대출
92 매입자금
93 미수론서비스
94 대여 |
+| loan_dt | 대출일자 | string | Y | 8 | 대출 실행일자 |
+| usa_amk_exts_rqst_yn | 미국애프터마켓연장신청여부 | string | Y | 1 | Y/N |
+| splt_buy_attr_name | 분할매수속성명 | string | Y | 60 | 정규장 종료 주문 시에는 '정규장 종료', 시간 입력 시에는 from ~ to 시간 표시됨 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD":"01",
+"OVRS_EXCG_CD": "NYSE",
+"SORT_SQN": "DS",
+"CTX_AREA_FK200": "",
+"CTX_AREA_NK200": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "81055689^01^NYSE^DS^ ",
+ "ctx_area_nk200": " ",
+ "output": [
+ {
+ "ord_dt": "20220112",
+ "ord_gno_brno": "01790",
+ "odno": "0030138112",
+ "orgn_odno": "",
+ "pdno": "BA",
+ "prdt_name": "보잉",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_cd_name": "매수",
+ "rvse_cncl_dvsn_cd": "00",
+ "rvse_cncl_dvsn_cd_name": "",
+ "rjct_rson": "",
+ "rjct_rson_name": "",
+ "ord_tmd": "163209",
+ "tr_mket_name": "뉴욕거래소",
+ "tr_crcy_cd": "USD",
+ "natn_cd": "840",
+ "natn_kor_name": "미국",
+ "ft_ord_qty": "1",
+ "ft_ccld_qty": "0",
+ "nccs_qty": "1",
+ "ft_ord_unpr3": "200.00000000",
+ "ft_ccld_unpr3": "0.00000000",
+ "ft_ccld_amt3": "0.00000",
+ "ovrs_excg_cd": "NYSE",
+ "prcs_stat_name": "",
+ "loan_type_cd": "10",
+ "loan_dt": ""
+ },
+ {
+ "ord_dt": "20220112",
+ "ord_gno_brno": "01790",
+ "odno": "0030138113",
+ "orgn_odno": "",
+ "pdno": "BA",
+ "prdt_name": "보잉",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_cd_name": "매수",
+ "rvse_cncl_dvsn_cd": "00",
+ "rvse_cncl_dvsn_cd_name": "",
+ "rjct_rson": "",
+ "rjct_rson_name": "",
+ "ord_tmd": "163211",
+ "tr_mket_name": "뉴욕거래소",
+ "tr_crcy_cd": "USD",
+ "natn_cd": "840",
+ "natn_kor_name": "미국",
+ "ft_ord_qty": "1",
+ "ft_ccld_qty": "0",
+ "nccs_qty": "1",
+ "ft_ord_unpr3": "200.00000000",
+ "ft_ccld_unpr3": "0.00000000",
+ "ft_ccld_amt3": "0.00000",
+ "ovrs_excg_cd": "NYSE",
+ "prcs_stat_name": "",
+ "loan_type_cd": "10",
+ "loan_dt": "",
+ "loan_dt": ""
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/242_v1_해외주식-027_해외주식-미국주간정정취소.md b/docs/broker/kis/rest/해외주식/주문/계좌/242_v1_해외주식-027_해외주식-미국주간정정취소.md
new file mode 100644
index 0000000..7f065a9
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/242_v1_해외주식-027_해외주식-미국주간정정취소.md
@@ -0,0 +1,129 @@
+# 해외주식 미국주간정정취소
+
+- 원본 시트명: 해외주식 미국주간정정취소
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-027
+- HTTP Method: POST
+- 실전 TR_ID: TTTS6038U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/daytime-order-rvsecncl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 미국주간정정취소 API입니다.
+
+* 미국주식 주간거래 시 아래 참고 부탁드립니다.
+. 포럼 > FAQ > 미국주식 주간거래 시 어떤 API를 사용해야 하나요?
+
+* 미국주간거래의 경우, 모든 미국 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 미국주간거래시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요.
+. 주간거래(장전거래)(한국시간 기준) : 10:00 ~ 18:00 (Summer Time 동일)
+
+* 한국투자증권 해외주식 시장별 매매안내(매매수수료, 거래시간 안내, 결제일 정보, 환전안내)
+ https://securities.koreainvestment.com/main/bond/research/_static/TF03ca050000.jsp
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
미국주간 정정취소 : TTTS6038U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD:나스닥 / NYSE:뉴욕 / AMEX:아멕스 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드 |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | '정정 또는 취소할 원주문번호(매매 TR의 주문번호)
- 해외주식 주문체결내역api (/uapi/overseas-stock/v1/trading/inquire-nccs)에서 odno(주문번호) 참조' |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | '01 : 정정
02 : 취소' |
+| ORD_QTY | 주문수량 | string | Y | 10 | |
+| OVRS_ORD_UNPR | 해외주문단가 | string | Y | 32 | 소수점 포함, 1주당 가격 |
+| CTAC_TLNO | 연락전화번호 | string | Y | 20 | " " |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | Y | 12 | " " |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | "0" |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | N | | |
+| KRX_FWDG_ORD_ORGNO | 한국거래소전송주문조직번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| ODNO | 주문번호 | string | Y | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문시각(시분초HHMMSS) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "12345678",
+ "ACNT_PRDT_CD": "01",
+ "OVRS_EXCG_CD": "NASD",
+ "PDNO": "AMZN",
+ "ORGN_ODNO": "0000034436",
+ "RVSE_CNCL_DVSN_CD": "01",
+ "ORD_QTY": "111",
+ "OVRS_ORD_UNPR": "1.9",
+ "CTAC_TLNO": "",
+ "MGCO_APTM_ODNO": "",
+ "ORD_SVR_DVSN_CD": "0"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000034437",
+ "ORD_TMD": "104202"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/243_v1_해외주식-007_해외주식-주문체결내역.md b/docs/broker/kis/rest/해외주식/주문/계좌/243_v1_해외주식-007_해외주식-주문체결내역.md
new file mode 100644
index 0000000..2b08932
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/243_v1_해외주식-007_해외주식-주문체결내역.md
@@ -0,0 +1,190 @@
+# 해외주식 주문체결내역
+
+- 원본 시트명: 해외주식 주문체결내역
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-007
+- HTTP Method: GET
+- 실전 TR_ID: TTTS3035R
+- 모의 TR_ID: VTTS3035R
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-ccnl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+일정 기간의 해외주식 주문 체결 내역을 확인하는 API입니다.
+실전계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+모의계좌의 경우, 한 번의 호출에 최대 15건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+
+* 해외 거래소 운영시간(한국시간 기준)
+1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
+ * 프리마켓(18:00 ~ 23:30, Summer Time : 17:00 ~ 22:30), 애프터마켓(06:00 ~ 07:00, Summer Time : 05:00 ~ 07:00)
+2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
+3) 상해 : 10:30 ~ 16:00
+4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTS3035R
[모의투자]
VTTS3035R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| PDNO | 상품번호 | string | Y | 12 | 전종목일 경우 "%" 입력
※ 모의투자계좌의 경우 ""(전체 조회)만 가능 |
+| ORD_STRT_DT | 주문시작일자 | string | Y | 8 | YYYYMMDD 형식 (현지시각 기준) |
+| ORD_END_DT | 주문종료일자 | string | Y | 8 | YYYYMMDD 형식 (현지시각 기준) |
+| SLL_BUY_DVSN | 매도매수구분 | string | Y | 2 | 00 : 전체
01 : 매도
02 : 매수
※ 모의투자계좌의 경우 "00"(전체 조회)만 가능 |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 00 : 전체
01 : 체결
02 : 미체결
※ 모의투자계좌의 경우 "00"(전체 조회)만 가능 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | 전종목일 경우 "%" 입력
NASD : 미국시장 전체(나스닥, 뉴욕, 아멕스)
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
※ 모의투자계좌의 경우 ""(전체 조회)만 가능 |
+| SORT_SQN | 정렬순서 | string | Y | 2 | DS : 정순
AS : 역순
※ 모의투자계좌의 경우 정렬순서 사용불가(Default : DS(정순)) |
+| ORD_DT | 주문일자 | string | Y | 8 | "" (Null 값 설정) |
+| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | "" (Null 값 설정) |
+| ODNO | 주문번호 | string | Y | 10 | "" (Null 값 설정)
※ 주문번호로 검색 불가능합니다. 반드시 ""(Null 값 설정) 바랍니다. |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output | 응답상세 | array | Y | | |
+| ord_dt | 주문일자 | string | Y | 8 | 주문접수 일자 (현지시각 기준) |
+| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
+| odno | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호
※ 정정취소주문 시, 해당 값 odno(주문번호) 넣어서 사용 |
+| orgn_odno | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| sll_buy_dvsn_cd_name | 매도매수구분코드명 | string | Y | 60 | |
+| rvse_cncl_dvsn | 정정취소구분 | string | Y | 2 | 01 : 정정
02 : 취소 |
+| rvse_cncl_dvsn_name | 정정취소구분명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| ft_ord_qty | FT주문수량 | string | Y | 10 | 주문수량 |
+| ft_ord_unpr3 | FT주문단가3 | string | Y | 26 | 주문가격 |
+| ft_ccld_qty | FT체결수량 | string | Y | 10 | 체결된 수량 |
+| ft_ccld_unpr3 | FT체결단가3 | string | Y | 26 | 체결된 가격 |
+| ft_ccld_amt3 | FT체결금액3 | string | Y | 23 | 체결된 금액 |
+| nccs_qty | 미체결수량 | string | Y | 10 | 미체결수량 |
+| prcs_stat_name | 처리상태명 | string | Y | 60 | 완료, 거부, 전송 |
+| rjct_rson | 거부사유 | string | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유 |
+| rjct_rson_name | 거부사유명 | string | Y | 60 | |
+| ord_tmd | 주문시각 | string | Y | 6 | 주문 접수 시간 |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| tr_natn | 거래국가 | string | Y | 3 | |
+| tr_natn_name | 거래국가명 | string | Y | 3 | |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| tr_crcy_cd | 거래통화코드 | string | Y | 60 | |
+| dmst_ord_dt | 국내주문일자 | string | Y | 8 | |
+| thco_ord_tmd | 당사주문시각 | string | Y | 6 | |
+| loan_type_cd | 대출유형코드 | string | Y | 2 | 00 : 해당사항없음
01 : 자기융자일반형
03 : 자기융자투자형
05 : 유통융자일반형
06 : 유통융자투자형
07 : 자기대주
09 : 유통대주
10 : 현금
11 : 주식담보대출
12 : 수익증권담보대출
13 : ELS담보대출
14 : 채권담보대출
15 : 해외주식담보대출
16 : 기업신용공여
31 : 소액자동담보대출
41 : 매도담보대출
42 : 환매자금대출
43 : 매입환매자금대출
44 : 대여매도담보대출
81 : 대차거래
82 : 법인CMA론
91 : 공모주청약자금대출
92 : 매입자금
93 : 미수론서비스
94 : 대여 |
+| loan_dt | 대출일자 | string | Y | 8 | |
+| mdia_dvsn_name | 매체구분명 | string | Y | 60 | ex) OpenAPI, 모바일 |
+| usa_amk_exts_rqst_yn | 미국애프터마켓연장신청여부 | string | Y | 1 | Y/N |
+| splt_buy_attr_name | 분할매수/매도속성명 | string | Y | 60 | 정규장 종료 주문 시에는 '정규장 종료', 시간 입력 시에는 from ~ to 시간 표시 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "CANO": "810XXXXX",
+ "ACNT_PRDT_CD":"01",
+ "PDNO": ""%,
+ "ORD_STRT_DT": "20211027",
+ "ORD_END_DT": "20211027",
+ "SLL_BUY_DVSN": "00",
+ "CCLD_NCCS_DVSN": "00",
+ "OVRS_EXCG_CD": "%",
+ "SORT_SQN": "DS",
+ "ORD_DT": "",
+ "ORD_GNO_BRNO":"02111",
+ "ODNO": "",
+ "CTX_AREA_NK200": "",
+ "CTX_AREA_FK200": ""
+}
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk200": " ",
+ "ctx_area_fk200": "12345678^01^^20211027^20211027^00^00^NASD^^ ",
+ "output": {
+ "ord_dt": "",
+ "ord_gno_brno": "",
+ "odno": "",
+ "orgn_odno": "",
+ "sll_buy_dvsn_cd": "",
+ "sll_buy_dvsn_cd_name": "",
+ "rvse_cncl_dvsn": "",
+ "rvse_cncl_dvsn_name": "",
+ "pdno": "",
+ "prdt_name": "",
+ "ft_ord_qty": "0",
+ "ft_ord_unpr3": "0.00000000",
+ "ft_ccld_qty": "0",
+ "ft_ccld_unpr3": "0.00000000",
+ "ft_ccld_amt3": "0.00000",
+ "nccs_qty": "0",
+ "prcs_stat_name": "",
+ "rjct_rson": "",
+ "rjct_rson_name": "",
+ "ord_tmd": "",
+ "tr_mket_name": "",
+ "tr_natn": "",
+ "tr_natn_name": "",
+ "ovrs_excg_cd": "",
+ "tr_crcy_cd": "",
+ "dmst_ord_dt": "",
+ "thco_ord_tmd": "",
+ "loan_type_cd": "",
+ "loan_dt": "",
+ "mdia_dvsn_name": "OpenAPI",
+ "usa_amk_exts_rqst_yn": "N",
+ "splt_buy_attr_name": "00:00~04:00" },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0560",
+ "msg1": "조회할 내용이 없습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/244_해외주식-064_해외주식-결제기준잔고.md b/docs/broker/kis/rest/해외주식/주문/계좌/244_해외주식-064_해외주식-결제기준잔고.md
new file mode 100644
index 0000000..000826f
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/244_해외주식-064_해외주식-결제기준잔고.md
@@ -0,0 +1,294 @@
+# 해외주식 결제기준잔고
+
+- 원본 시트명: 해외주식 결제기준잔고
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: 해외주식-064
+- HTTP Method: GET
+- 실전 TR_ID: CTRP6010R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-paymt-stdr-balance
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 결제기준잔고 API입니다.
+한국투자 HTS(eFriend Plus) > [0829] 해외 결제기준잔고 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 적용환율은 당일 매매기준이며, 현재가의 경우 지연된 시세로 평가되므로 실제매도금액과 상이할 수 있습니다.
+※ 주문가능수량 : 보유수량 - 미결제 매도수량
+※ 매입금액 계산 시 결제일의 최초고시환율을 적용하므로, 금일 최초고시환율을 적용하는 체결기준 잔고와는 상이합니다.
+※ 해외증권 투자 및 업무문의 안내: 한국투자증권 해외투자지원부 02)3276-5300
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTRP6010R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| BASS_DT | 기준일자 | string | Y | 8 | |
+| WCRC_FRCR_DVSN_CD | 원화외화구분코드 | string | Y | 2 | 01(원화기준),02(외화기준) |
+| INQR_DVSN_CD | 조회구분코드 | string | Y | 2 | 00(전체), 01(일반), 02(미니스탁) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object array | Y | | array |
+| pdno | 상품번호 | string | Y | 12 | |
+| prdt_name | 상품명 | string | Y | 60 | |
+| cblc_qty13 | 잔고수량13 | string | Y | 238 | |
+| ord_psbl_qty1 | 주문가능수량1 | string | Y | 238 | |
+| avg_unpr3 | 평균단가3 | string | Y | 244 | |
+| ovrs_now_pric1 | 해외현재가격1 | string | Y | 235 | |
+| frcr_pchs_amt | 외화매입금액 | string | Y | 235 | |
+| frcr_evlu_amt2 | 외화평가금액2 | string | Y | 236 | |
+| evlu_pfls_amt2 | 평가손익금액2 | string | Y | 255 | |
+| bass_exrt | 기준환율 | string | Y | 238 | |
+| oprt_dtl_dtime | 조작상세일시 | string | Y | 17 | |
+| buy_crcy_cd | 매수통화코드 | string | Y | 3 | |
+| thdt_sll_ccld_qty1 | 당일매도체결수량1 | string | Y | 238 | |
+| thdt_buy_ccld_qty1 | 당일매수체결수량1 | string | Y | 238 | |
+| evlu_pfls_rt1 | 평가손익율1 | string | Y | 238 | |
+| tr_mket_name | 거래시장명 | string | Y | 60 | |
+| natn_kor_name | 국가한글명 | string | Y | 60 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| mgge_qty | 담보수량 | string | Y | 19 | |
+| loan_rmnd | 대출잔액 | string | Y | 19 | |
+| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
+| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | |
+| scts_dvsn_name | 유가증권구분명 | string | Y | 60 | |
+| ldng_cblc_qty | 대여잔고수량 | string | Y | 19 | |
+| output2 | 응답상세 | object array | Y | | array |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| crcy_cd_name | 통화코드명 | string | Y | 60 | |
+| frcr_dncl_amt_2 | 외화예수금액2 | string | Y | 236 | |
+| frst_bltn_exrt | 최초고시환율 | string | Y | 238 | |
+| frcr_evlu_amt2 | 외화평가금액2 | string | Y | 236 | |
+| output3 | 응답상세 | object | Y | | |
+| pchs_amt_smtl_amt | 매입금액합계금액 | string | Y | 19 | |
+| tot_evlu_pfls_amt | 총평가손익금액 | string | Y | 238 | |
+| evlu_erng_rt1 | 평가수익율1 | string | Y | 201 | |
+| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
+| wcrc_evlu_amt_smtl | 원화평가금액합계 | string | Y | 236 | |
+| tot_asst_amt2 | 총자산금액2 | string | Y | 236 | |
+| frcr_cblc_wcrc_evlu_amt_smtl | 외화잔고원화평가금액합계 | string | Y | 236 | |
+| tot_loan_amt | 총대출금액 | string | Y | 19 | |
+| tot_ldng_evlu_amt | 총대여평가금액 | string | Y | 9 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+BASS_DT:20240524
+WCRC_FRCR_DVSN_CD:01
+INQR_DVSN_CD:00
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "pdno": "ACVA",
+ "prdt_name": "ACV 옥션스",
+ "cblc_qty13": "5.00000000",
+ "ord_psbl_qty1": "5.00000000",
+ "avg_unpr3": "11137.2000",
+ "ovrs_now_pric1": "26065.48600",
+ "frcr_pchs_amt": "55686.00000",
+ "frcr_evlu_amt2": "130327.000000",
+ "evlu_pfls_amt2": "74641.00000",
+ "bass_exrt": "1365.40000000",
+ "oprt_dtl_dtime": "20240525104030326",
+ "buy_crcy_cd": "USD",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "evlu_pfls_rt1": "134.03000000",
+ "tr_mket_name": "나스닥",
+ "natn_kor_name": "미국",
+ "std_pdno": "US00091G1040",
+ "mgge_qty": "0",
+ "loan_rmnd": "0",
+ "prdt_type_cd": "512",
+ "ovrs_excg_cd": "NASD",
+ "scts_dvsn_name": "현금"
+ },
+ {
+ "pdno": "DLPN",
+ "prdt_name": "돌핀 엔터테인먼트",
+ "cblc_qty13": "1.00000000",
+ "ord_psbl_qty1": "1.00000000",
+ "avg_unpr3": "2279.0000",
+ "ovrs_now_pric1": "1529.24800",
+ "frcr_pchs_amt": "2279.00000",
+ "frcr_evlu_amt2": "1529.000000",
+ "evlu_pfls_amt2": "-750.00000",
+ "bass_exrt": "1365.40000000",
+ "oprt_dtl_dtime": "20240525104052328",
+ "buy_crcy_cd": "USD",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "evlu_pfls_rt1": "-32.90000000",
+ "tr_mket_name": "나스닥",
+ "natn_kor_name": "미국",
+ "std_pdno": "US25686H2094",
+ "mgge_qty": "0",
+ "loan_rmnd": "0",
+ "prdt_type_cd": "512",
+ "ovrs_excg_cd": "NASD",
+ "scts_dvsn_name": "현금"
+ },
+ {
+ "pdno": "NIO",
+ "prdt_name": "니오(ADR)",
+ "cblc_qty13": "1.00000000",
+ "ord_psbl_qty1": "1.00000000",
+ "avg_unpr3": "14316.0000",
+ "ovrs_now_pric1": "6854.30800",
+ "frcr_pchs_amt": "14316.00000",
+ "frcr_evlu_amt2": "6854.000000",
+ "evlu_pfls_amt2": "-7462.00000",
+ "bass_exrt": "1365.40000000",
+ "oprt_dtl_dtime": "20240528185338061",
+ "buy_crcy_cd": "USD",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "evlu_pfls_rt1": "-52.12000000",
+ "tr_mket_name": "뉴욕거래소",
+ "natn_kor_name": "미국",
+ "std_pdno": "US62914V1061",
+ "mgge_qty": "0",
+ "loan_rmnd": "0",
+ "prdt_type_cd": "513",
+ "ovrs_excg_cd": "NYSE",
+ "scts_dvsn_name": "현금"
+ },
+ {
+ "pdno": "6731",
+ "prdt_name": "[6731]픽셀라",
+ "cblc_qty13": "4.00000000",
+ "ord_psbl_qty1": "4.00000000",
+ "avg_unpr3": "8851.7500",
+ "ovrs_now_pric1": "922.30600",
+ "frcr_pchs_amt": "35407.00000",
+ "frcr_evlu_amt2": "3689.000000",
+ "evlu_pfls_amt2": "-31718.00000",
+ "bass_exrt": "870.10000000",
+ "oprt_dtl_dtime": "20240528170115625",
+ "buy_crcy_cd": "JPY",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "evlu_pfls_rt1": "-89.58000000",
+ "tr_mket_name": "일본",
+ "natn_kor_name": "일본",
+ "std_pdno": "JP3801620000",
+ "mgge_qty": "0",
+ "loan_rmnd": "0",
+ "prdt_type_cd": "515",
+ "ovrs_excg_cd": "TKSE",
+ "scts_dvsn_name": "현금"
+ },
+ {
+ "pdno": "CEI",
+ "prdt_name": "캠버 에너지",
+ "cblc_qty13": "1.00000000",
+ "ord_psbl_qty1": "1.00000000",
+ "avg_unpr3": "2255.0000",
+ "ovrs_now_pric1": "238.94500",
+ "frcr_pchs_amt": "2255.00000",
+ "frcr_evlu_amt2": "238.000000",
+ "evlu_pfls_amt2": "-2017.00000",
+ "bass_exrt": "1365.40000000",
+ "oprt_dtl_dtime": "20240528185356653",
+ "buy_crcy_cd": "USD",
+ "thdt_sll_ccld_qty1": "0.00000000",
+ "thdt_buy_ccld_qty1": "0.00000000",
+ "evlu_pfls_rt1": "-89.44000000",
+ "tr_mket_name": "아멕스",
+ "natn_kor_name": "미국",
+ "std_pdno": "US13200M6075",
+ "mgge_qty": "0",
+ "loan_rmnd": "0",
+ "prdt_type_cd": "529",
+ "ovrs_excg_cd": "AMEX",
+ "scts_dvsn_name": "현금"
+ }
+ ],
+ "output2": [
+ {
+ "crcy_cd": "CNY",
+ "crcy_cd_name": "중국위안",
+ "frcr_dncl_amt_2": "1459.110000",
+ "frst_bltn_exrt": "188.15000000",
+ "frcr_evlu_amt2": "274531.000000"
+ },
+ {
+ "crcy_cd": "USD",
+ "crcy_cd_name": "미국달러",
+ "frcr_dncl_amt_2": "698.190000",
+ "frst_bltn_exrt": "1365.40000000",
+ "frcr_evlu_amt2": "953308.000000"
+ },
+ {
+ "crcy_cd": "VND",
+ "crcy_cd_name": "베트남 동",
+ "frcr_dncl_amt_2": "377568.000000",
+ "frst_bltn_exrt": "5.36000000",
+ "frcr_evlu_amt2": "20237.000000"
+ }
+ ],
+ "output3": {
+ "pchs_amt_smtl_amt": "109943",
+ "tot_evlu_pfls_amt": "32694.00000000",
+ "evlu_erng_rt1": "29.7300000000",
+ "tot_dncl_amt": "296967",
+ "wcrc_evlu_amt_smtl": "142637.000000",
+ "tot_asst_amt2": "1687680.000000",
+ "frcr_cblc_wcrc_evlu_amt_smtl": "1248076.000000",
+ "tot_loan_amt": "0"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0530",
+ "msg1": "조회되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/245_해외주식-063_해외주식-일별거래내역.md b/docs/broker/kis/rest/해외주식/주문/계좌/245_해외주식-063_해외주식-일별거래내역.md
new file mode 100644
index 0000000..1490e41
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/245_해외주식-063_해외주식-일별거래내역.md
@@ -0,0 +1,267 @@
+# 해외주식 일별거래내역
+
+- 원본 시트명: 해외주식 일별거래내역
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: 해외주식-063
+- HTTP Method: GET
+- 실전 TR_ID: CTOS4001R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/inquire-period-trans
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 일별거래내역 API입니다.
+한국투자 HTS(eFriend Plus) > [0828] 해외증권 일별거래내역 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+※ 체결가격, 매매금액, 정산금액, 수수료 원화금액은 국내 결제일까지는 예상환율로 적용되고, 국내 결제일 익일부터 확정환율로 적용됨으로 금액이 변경될 수 있습니다.
+※ 해외증권 투자 및 업무문의 안내: 한국투자증권 해외투자지원부 02)3276-5300
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | CTOS4001R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+| ERLM_STRT_DT | 등록시작일자 | string | Y | 8 | 입력날짜 ~ (ex) 20240420) |
+| ERLM_END_DT | 등록종료일자 | string | Y | 8 | ~입력날짜 (ex) 20240520) |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | 공백 |
+| PDNO | 상품번호 | string | Y | 12 | 공백 (전체조회), 개별종목 조회는 상품번호입력 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 00(전체), 01(매도), 02(매수) |
+| LOAN_DVSN_CD | 대출구분코드 | string | Y | 2 | 공백 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공백 |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 공백 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| ctx_area_fk100 | 연속조회검색조건100 | string | Y | 100 | |
+| ctx_area_nk100 | 연속조회키100 | string | Y | 100 | |
+| output1 | 응답상세 | object array | Y | | array |
+| trad_dt | 매매일자 | string | Y | 8 | |
+| sttl_dt | 결제일자 | string | Y | 8 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
+| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| ovrs_item_name | 해외종목명 | string | Y | 60 | |
+| ccld_qty | 체결수량 | string | Y | 10 | |
+| amt_unit_ccld_qty | 금액단위체결수량 | string | Y | 188 | |
+| ft_ccld_unpr2 | FT체결단가2 | string | Y | 238 | |
+| ovrs_stck_ccld_unpr | 해외주식체결단가 | string | Y | 238 | |
+| tr_frcr_amt2 | 거래외화금액2 | string | Y | 236 | |
+| tr_amt | 거래금액 | string | Y | 19 | |
+| frcr_excc_amt_1 | 외화정산금액1 | string | Y | 236 | |
+| wcrc_excc_amt | 원화정산금액 | string | Y | 19 | |
+| dmst_frcr_fee1 | 국내외화수수료1 | string | Y | 235 | |
+| frcr_fee1 | 외화수수료1 | string | Y | 236 | |
+| dmst_wcrc_fee | 국내원화수수료 | string | Y | 19 | |
+| ovrs_wcrc_fee | 해외원화수수료 | string | Y | 19 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| std_pdno | 표준상품번호 | string | Y | 12 | |
+| erlm_exrt | 등록환율 | string | Y | 238 | |
+| loan_dvsn_cd | 대출구분코드 | string | Y | 2 | |
+| loan_dvsn_name | 대출구분명 | string | Y | 60 | |
+| output2 | 응답상세 | object | Y | | |
+| frcr_buy_amt_smtl | 외화매수금액합계 | string | Y | 236 | |
+| frcr_sll_amt_smtl | 외화매도금액합계 | string | Y | 236 | |
+| dmst_fee_smtl | 국내수수료합계 | string | Y | 256 | |
+| ovrs_fee_smtl | 해외수수료합계 | string | Y | 236 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+ERLM_STRT_DT:20240101
+ERLM_END_DT:20240528
+OVRS_EXCG_CD:
+PDNO:
+SLL_BUY_DVSN_CD:00
+LOAN_DVSN_CD:
+CTX_AREA_FK100:
+CTX_AREA_NK100:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk100": "12345678!^01!^20240101!^20240528!^!^ ",
+ "ctx_area_nk100": " ",
+ "output1": [
+ {
+ "trad_dt": "20240116",
+ "sttl_dt": "20240118",
+ "sll_buy_dvsn_cd": "01",
+ "sll_buy_dvsn_name": "매도",
+ "pdno": "AAPL",
+ "ovrs_item_name": "애플",
+ "ccld_qty": "1",
+ "amt_unit_ccld_qty": "1.00000000",
+ "ft_ccld_unpr2": "2.94000000",
+ "ovrs_stck_ccld_unpr": "0.00000000",
+ "tr_frcr_amt2": "2.940000",
+ "tr_amt": "0",
+ "frcr_excc_amt_1": "2.940000",
+ "wcrc_excc_amt": "0",
+ "dmst_frcr_fee1": "0.00000",
+ "frcr_fee1": "0.000000",
+ "dmst_wcrc_fee": "0",
+ "ovrs_wcrc_fee": "0",
+ "crcy_cd": "USD",
+ "std_pdno": "US0378331005",
+ "erlm_exrt": "0.00000000",
+ "loan_dvsn_cd": "01",
+ "loan_dvsn_name": "현금"
+ },
+ {
+ "trad_dt": "20240116",
+ "sttl_dt": "20240118",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_name": "매수",
+ "pdno": "USAS",
+ "ovrs_item_name": "아메리카스 골드 앤드 실버",
+ "ccld_qty": "1",
+ "amt_unit_ccld_qty": "1.00000000",
+ "ft_ccld_unpr2": "0.62000000",
+ "ovrs_stck_ccld_unpr": "0.00000000",
+ "tr_frcr_amt2": "0.620000",
+ "tr_amt": "0",
+ "frcr_excc_amt_1": "0.620000",
+ "wcrc_excc_amt": "0",
+ "dmst_frcr_fee1": "0.00000",
+ "frcr_fee1": "0.000000",
+ "dmst_wcrc_fee": "0",
+ "ovrs_wcrc_fee": "0",
+ "crcy_cd": "USD",
+ "std_pdno": "CA03062D1006",
+ "erlm_exrt": "0.00000000",
+ "loan_dvsn_cd": "01",
+ "loan_dvsn_name": "현금"
+ },
+ {
+ "trad_dt": "20240118",
+ "sttl_dt": "20240122",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_name": "매수",
+ "pdno": "TSLA",
+ "ovrs_item_name": "테슬라",
+ "ccld_qty": "1",
+ "amt_unit_ccld_qty": "1.00000000",
+ "ft_ccld_unpr2": "12.20000000",
+ "ovrs_stck_ccld_unpr": "16283.34000000",
+ "tr_frcr_amt2": "12.200000",
+ "tr_amt": "16283",
+ "frcr_excc_amt_1": "12.200000",
+ "wcrc_excc_amt": "16283",
+ "dmst_frcr_fee1": "0.00000",
+ "frcr_fee1": "0.000000",
+ "dmst_wcrc_fee": "0",
+ "ovrs_wcrc_fee": "0",
+ "crcy_cd": "USD",
+ "std_pdno": "US88160R1014",
+ "erlm_exrt": "1334.70000000",
+ "loan_dvsn_cd": "01",
+ "loan_dvsn_name": "현금"
+ },
+ {
+ "trad_dt": "20240118",
+ "sttl_dt": "20240122",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_name": "매수",
+ "pdno": "PG",
+ "ovrs_item_name": "프록터 앤드 갬블",
+ "ccld_qty": "5",
+ "amt_unit_ccld_qty": "5.00000000",
+ "ft_ccld_unpr2": "149.20000000",
+ "ovrs_stck_ccld_unpr": "199137.24000000",
+ "tr_frcr_amt2": "746.000000",
+ "tr_amt": "995686",
+ "frcr_excc_amt_1": "746.000000",
+ "wcrc_excc_amt": "995686",
+ "dmst_frcr_fee1": "0.00000",
+ "frcr_fee1": "0.000000",
+ "dmst_wcrc_fee": "0",
+ "ovrs_wcrc_fee": "0",
+ "crcy_cd": "USD",
+ "std_pdno": "US7427181091",
+ "erlm_exrt": "1334.70000000",
+ "loan_dvsn_cd": "01",
+ "loan_dvsn_name": "현금"
+ },
+ {
+ "trad_dt": "20240118",
+ "sttl_dt": "20240122",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_name": "매수",
+ "pdno": "6758",
+ "ovrs_item_name": "[6758]소니",
+ "ccld_qty": "99",
+ "amt_unit_ccld_qty": "99.00000000",
+ "ft_ccld_unpr2": "14260.50000000",
+ "ovrs_stck_ccld_unpr": "129281.41480000",
+ "tr_frcr_amt2": "1411789.000000",
+ "tr_amt": "12798855",
+ "frcr_excc_amt_1": "1415742.000000",
+ "wcrc_excc_amt": "12834691",
+ "dmst_frcr_fee1": "2824.00000",
+ "frcr_fee1": "1129.000000",
+ "dmst_wcrc_fee": "25601",
+ "ovrs_wcrc_fee": "10235",
+ "crcy_cd": "JPY",
+ "std_pdno": "JP3435000009",
+ "erlm_exrt": "9.06570000",
+ "loan_dvsn_cd": "01",
+ "loan_dvsn_name": "현금"
+ }
+ ],
+ "output2": {
+ "frcr_buy_amt_smtl": "13810824.000000",
+ "frcr_sll_amt_smtl": "0.000000",
+ "dmst_fee_smtl": "25601.000000",
+ "ovrs_fee_smtl": "10235.000000"
+ },
+ "rt_cd": "0",
+ "msg_cd": "KIOK0460",
+ "msg1": "조회 되었습니다. (마지막 자료) "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/246_v1_해외주식-026_해외주식-미국주간주문.md b/docs/broker/kis/rest/해외주식/주문/계좌/246_v1_해외주식-026_해외주식-미국주간주문.md
new file mode 100644
index 0000000..688acc7
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/246_v1_해외주식-026_해외주식-미국주간주문.md
@@ -0,0 +1,96 @@
+# 해외주식 미국주간주문
+
+- 원본 시트명: 해외주식 미국주간주문
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-026
+- HTTP Method: POST
+- 실전 TR_ID: (주간매수) TTTS6036U (주간매도) TTTS6037U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/daytime-order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 미국주간주문 API입니다.
+
+* 미국주식 주간거래 시 아래 참고 부탁드립니다.
+. 포럼 > FAQ > 미국주식 주간거래 시 어떤 API를 사용해야 하나요?
+
+* 미국주간거래의 경우, 모든 미국 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 미국주간거래시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요.
+. 주간거래(장전거래)(한국시간 기준) : 10:00 ~ 18:00 (Summer Time 동일)
+
+* 한국투자증권 해외주식 시장별 매매안내(매매수수료, 거래시간 안내, 결제일 정보, 환전안내)
+ https://securities.koreainvestment.com/main/bond/research/_static/TF03ca050000.jsp
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
미국주간매수 : TTTS6036U
미국주간매도 : TTTS6037U |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD:나스닥 / NYSE:뉴욕 / AMEX:아멕스 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드 |
+| ORD_QTY | 주문수량 | string | Y | 10 | 해외거래소 별 최소 주문수량 및 주문단위 확인 필요 |
+| OVRS_ORD_UNPR | 해외주문단가 | string | Y | 32 | 소수점 포함, 1주당 가격
* 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 |
+| CTAC_TLNO | 연락전화번호 | string | N | 20 | " " |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | N | 12 | " " |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | "0" |
+| ORD_DVSN | 주문구분 | string | Y | 2 | [미국 매수/매도 주문]
00 : 지정가
* 주간거래는 지정가만 가능 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object | N | | |
+| KRX_FWDG_ORD_ORGNO | 한국거래소전송주문조직번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| ODNO | 주문번호 | string | Y | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문시각(시분초HHMMSS) |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/247_v1_해외주식-013_해외주식-예약주문조회.md b/docs/broker/kis/rest/해외주식/주문/계좌/247_v1_해외주식-013_해외주식-예약주문조회.md
new file mode 100644
index 0000000..202beb8
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/247_v1_해외주식-013_해외주식-예약주문조회.md
@@ -0,0 +1,158 @@
+# 해외주식 예약주문조회
+
+- 원본 시트명: 해외주식 예약주문조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-013
+- HTTP Method: GET
+- 실전 TR_ID: (미국) TTTT3039R (일본/중국/홍콩/베트남) TTTS3014R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/order-resv-list
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 예약주문 조회 API입니다.
+※ 모의투자는 사용 불가합니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
미국 : TTTT3039R
일본, 중국, 홍콩, 베트남 : TTTS3014R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | N | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / 개인: ""(Default) |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| INQR_STRT_DT | 조회시작일자 | string | Y | 8 | 조회시작일자(YYYYMMDD) |
+| INQR_END_DT | 조회종료일자 | string | Y | 8 | 조회종료일자(YYYYMMDD) |
+| INQR_DVSN_CD | 조회구분코드 | string | Y | 2 | 00 : 전체
01 : 일반해외주식
02 : 미니스탁 |
+| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | [tr_id=TTTT3039R인 경우]
공백 입력 시 미국주식 전체조회
[tr_id=TTTS3014R인 경우]
공백 입력 시 아시아주식 전체조회
512 : 미국 나스닥 / 513 : 미국 뉴욕거래소 / 529 : 미국 아멕스
515 : 일본
501 : 홍콩 / 543 : 홍콩CNY / 558 : 홍콩USD
507 : 베트남 하노이거래소 / 508 : 베트남 호치민거래소
551 : 중국 상해A / 552 : 중국 심천A |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | [tr_id=TTTT3039R인 경우]
공백 입력 시 미국주식 전체조회
[tr_id=TTTS3014R인 경우]
공백 입력 시 아시아주식 전체조회
NASD : 나스닥 / NYSE : 뉴욕 / AMEX : 아멕스
SEHK : 홍콩 / SHAA : 중국상해 / SZAA : 중국심천
TKSE : 일본 / HASE : 하노이거래소 / VNSE : 호치민거래소 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+| output | 응답상세1 | object | N | | |
+| cncl_yn | 취소여부 | string | N | 1 | |
+| rsvn_ord_rcit_dt | 예약주문접수일자 | string | N | 8 | |
+| ovrs_rsvn_odno | 해외예약주문번호 | string | N | 10 | |
+| ord_dt | 주문일자 | string | N | 8 | |
+| ord_gno_brno | 주문채번지점번호 | string | N | 5 | |
+| odno | 주문번호 | string | N | 10 | |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | |
+| sll_buy_dvsn_cd_name | 매도매수구분명 | string | N | 60 | |
+| ovrs_rsvn_ord_stat_cd | 해외예약주문상태코드 | string | N | 2 | |
+| ovrs_rsvn_ord_stat_cd_name | 해외예약주문상태코드명 | string | N | 60 | |
+| pdno | 상품번호 | string | N | 12 | |
+| prdt_type_cd | 상품유형코드 | string | N | 3 | |
+| prdt_name | 상품명 | string | N | 60 | |
+| ord_rcit_tmd | 주문접수시각 | string | N | 6 | |
+| ord_fwdg_tmd | 주문전송시각 | string | N | 6 | |
+| tr_dvsn_name | 거래구분명 | string | N | 60 | |
+| ovrs_excg_cd | 해외거래소코드 | string | N | 4 | |
+| tr_mket_name | 거래시장명 | string | N | 60 | |
+| ord_stfno | 주문직원번호 | string | N | 6 | |
+| ft_ord_qty | FT주문수량 | string | N | 10 | |
+| ft_ord_unpr3 | FT주문단가3 | string | N | 27 | |
+| ft_ccld_qty | FT체결수량 | string | N | 10 | |
+| nprc_rson_text | 미처리사유내용 | string | N | 500 | |
+| splt_buy_attr_name | 분할매수속성명 | string | N | 60 | 정규장 종료 주문 시에는 '정규장 종료', 시간 입력 시에는 from ~ to 시간 표시 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+"input": {
+ "ACNT_PRDT_CD": "01",
+ "CANO": "12345678",
+ "CTX_AREA_FK200": "",
+ "CTX_AREA_NK200": "",
+ "INQR_DVSN_CD": "00",
+ "INQR_END_DT": "20220709",
+ "INQR_STRT_DT": "20220705",
+ "OVRS_EXCG_CD": "SEHK",
+ "PRDT_TYPE_CD": "501"
+ }
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_fk200": "12345678^01^20220809^20220830^00^ ",
+ "ctx_area_nk200": " ",
+ "output": [
+ {
+ "cncl_yn": "N",
+ "rsvn_ord_rcit_dt": "20250523",
+ "ovrs_rsvn_odno": "0031111234",
+ "ord_dt": "",
+ "ord_gno_brno": "",
+ "odno": "",
+ "sll_buy_dvsn_cd": "02",
+ "sll_buy_dvsn_cd_name": "TWAP지정가매수",
+ "ovrs_rsvn_ord_stat_cd": "01",
+ "ovrs_rsvn_ord_stat_cd_name": "접수",
+ "pdno": "AAPL",
+ "prdt_name": "애플",
+ "ord_rcit_tmd": "161928",
+ "ord_fwdg_tmd": "",
+ "tr_dvsn_name": "접수",
+ "ovrs_excg_cd": "NASD",
+ "tr_mket_name": "NASDAQ",
+ "ord_stfno": "999999",
+ "ft_ord_qty": "100",
+ "ft_ord_unpr3": "150.00000000",
+ "ft_ccld_qty": "0",
+ "ft_ccld_unpr3": "0.00000000",
+ "nprc_rson_text": "",
+ "splt_buy_attr_name": "00:00~04:00"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/248_v1_해외주식-001_해외주식-주문.md b/docs/broker/kis/rest/해외주식/주문/계좌/248_v1_해외주식-001_해외주식-주문.md
new file mode 100644
index 0000000..81b794a
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/248_v1_해외주식-001_해외주식-주문.md
@@ -0,0 +1,131 @@
+# 해외주식 주문
+
+- 원본 시트명: 해외주식 주문
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-001
+- HTTP Method: POST
+- 실전 TR_ID: (미국매수) TTTT1002U (미국매도) TTTT1006U (아시아 국가 하단 규격서 참고)
+- 모의 TR_ID: (미국매수) VTTT1002U (미국매도) VTTT1001U (아시아 국가 하단 규격서 참고)
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/order
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 주문 API입니다.
+
+* 모의투자의 경우, 모든 해외 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+* 해외 거래소 운영시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요. (미국주식 주간주문은 "해외주식 미국주간주문"을 이용)
+* 해외 거래소 운영시간(한국시간 기준)
+1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
+ * 프리마켓(18:00 ~ 23:30, Summer Time : 17:00 ~ 22:30), 애프터마켓(06:00 ~ 07:00, Summer Time : 05:00 ~ 07:00) 시간대에도 주문 가능
+2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
+3) 상해 : 10:30 ~ 16:00
+4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00
+
+* 기존에는 내부통제 요건에 따라 상장주식수의 1%를 초과하는 주문은 접수할 수 없었으나, 2025.08.14 시행 이후부터는 접수가 가능합니다. 단, 타 매체(HTS 등)는 안내 팝업 확인 후 주문이 가능하지만, Open API는 별도의 안내 화면 없이 주문이 바로 접수되므로 유의하시기 바랍니다.
+
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+ https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTT1002U : 미국 매수 주문
TTTT1006U : 미국 매도 주문
TTTS0308U : 일본 매수 주문
TTTS0307U : 일본 매도 주문
TTTS0202U : 상해 매수 주문
TTTS1005U : 상해 매도 주문
TTTS1002U : 홍콩 매수 주문
TTTS1001U : 홍콩 매도 주문
TTTS0305U : 심천 매수 주문
TTTS0304U : 심천 매도 주문
TTTS0311U : 베트남 매수 주문
TTTS0310U : 베트남 매도 주문
[모의투자]
VTTT1002U : 미국 매수 주문
VTTT1001U : 미국 매도 주문
VTTS0308U : 일본 매수 주문
VTTS0307U : 일본 매도 주문
VTTS0202U : 상해 매수 주문
VTTS1005U : 상해 매도 주문
VTTS1002U : 홍콩 매수 주문
VTTS1001U : 홍콩 매도 주문
VTTS0305U : 심천 매수 주문
VTTS0304U : 심천 매도 주문
VTTS0311U : 베트남 매수 주문
VTTS0310U : 베트남 매도 주문 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_EXCG_CD | 해외거래소코드 | string | Y | 4 | NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민 |
+| PDNO | 상품번호 | string | Y | 12 | 종목코드 |
+| ORD_QTY | 주문수량 | string | Y | 10 | 주문수량 (해외거래소 별 최소 주문수량 및 주문단위 확인 필요) |
+| OVRS_ORD_UNPR | 해외주문단가 | string | Y | 31 | 1주당 가격
* 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 |
+| CTAC_TLNO | 연락전화번호 | string | N | 20 | |
+| MGCO_APTM_ODNO | 운용사지정주문번호 | string | N | 12 | |
+| SLL_TYPE | 판매유형 | string | N | 2 | 제거 : 매수
00 : 매도 |
+| ORD_SVR_DVSN_CD | 주문서버구분코드 | string | Y | 1 | "0"(Default) |
+| ORD_DVSN | 주문구분 | string | Y | 2 | [Header tr_id TTTT1002U(미국 매수 주문)]
00 : 지정가
32 : LOO(장개시지정가)
34 : LOC(장마감지정가)
35 : TWAP (시간가중평균)
36 : VWAP (거래량가중평균)
* 모의투자 VTTT1002U(미국 매수 주문)로는 00:지정가만 가능
* TWAP, VWAP 주문은 분할시간 주문 입력 필수
[Header tr_id TTTT1006U(미국 매도 주문)]
00 : 지정가
31 : MOO(장개시시장가)
32 : LOO(장개시지정가)
33 : MOC(장마감시장가)
34 : LOC(장마감지정가)
35 : TWAP (시간가중평균)
36 : VWAP (거래량가중평균)
* 모의투자 VTTT1006U(미국 매도 주문)로는 00:지정가만 가능
* TWAP, VWAP 주문은 분할시간 주문 입력 필수
[Header tr_id TTTS1001U(홍콩 매도 주문)]
00 : 지정가
50 : 단주지정가
* 모의투자 VTTS1001U(홍콩 매도 주문)로는 00:지정가만 가능
[그외 tr_id]
제거
※ TWAP, VWAP 주문은 정정 불가 |
+| START_TIME | 시작시간 | string | N | 6 | ※ TWAP, VWAP 주문유형이고 알고리즘주문시간구분코드가 00일때 사용
※ YYMMDD 형태로 입력
※ 시간 입력 시 정규장 종료 5분전까지 입력 가능 |
+| END_TIME | 종료시간 | string | N | 6 | ※ TWAP, VWAP 주문유형이고 알고리즘주문시간구분코드가 00일때 사용
※ YYMMDD 형태로 입력
※ 시간 입력 시 정규장 종료 5분전까지 입력 가능 |
+| ALGO_ORD_TMD_DVSN_CD | 알고리즘주문시간구분코드 | string | N | 2 | 00 : 분할주문 시간 직접입력 , 02 : 정규장 종료시까지 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | |
+| KRX_FWDG_ORD_ORGNO | 한국거래소전송주문조직번호 | string | Y | 5 | 주문시 한국투자증권 시스템에서 지정된 영업점코드 |
+| ODNO | 주문번호 | string | Y | 10 | 주문시 한국투자증권 시스템에서 채번된 주문번호 |
+| ORD_TMD | 주문시각 | string | Y | 6 | 주문시각(시분초HHMMSS) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD": "01",
+"OVRS_EXCG_CD": "NASD",
+"PDNO": "AAPL",
+"ORD_QTY": "1",
+"OVRS_ORD_UNPR": "145.00",
+"CTAC_TLNO": "",
+"MGCO_APTM_ODNO": "",
+"ORD_SVR_DVSN_CD": "0",
+"ORD_DVSN": "00"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK0013",
+ "msg1": "주문 전송 완료 되었습니다.",
+ "output": {
+ "KRX_FWDG_ORD_ORGNO": "01790",
+ "ODNO": "0000004336",
+ "ORD_TMD": "160524"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/249_v1_해외주식-004_해외주식-예약주문접수취소.md b/docs/broker/kis/rest/해외주식/주문/계좌/249_v1_해외주식-004_해외주식-예약주문접수취소.md
new file mode 100644
index 0000000..0a27a0c
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/249_v1_해외주식-004_해외주식-예약주문접수취소.md
@@ -0,0 +1,99 @@
+# 해외주식 예약주문접수취소
+
+- 원본 시트명: 해외주식 예약주문접수취소
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: v1_해외주식-004
+- HTTP Method: POST
+- 실전 TR_ID: (미국 예약주문 취소접수) TTTT3017U (아시아국가 미제공)
+- 모의 TR_ID: (미국 예약주문 취소접수) VTTT3017U (아시아국가 미제공)
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /uapi/overseas-stock/v1/trading/order-resv-ccnl
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+접수된 미국주식 예약주문을 취소하기 위한 API입니다.
+(해외주식 예약주문접수 시 Return 받은 ODNO를 참고하여 API를 호출하세요.)
+
+* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
+https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
+
+※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+ (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]
TTTT3017U : 미국예약주문접수 취소
[모의투자]
VTTT3017U : 미국예약주문접수 취소
(일본, 홍콩 등 타국가 개발 진행 예정) |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객타입 | string | N | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| RSYN_ORD_RCIT_DT | 해외주문접수일자 | string | Y | 8 | |
+| OVRS_RSVN_ODNO | 해외예약주문번호 | string | Y | 10 | 해외주식_예약주문접수 API Output ODNO(주문번호) 참고 |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
+| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
+| output | 응답상세 | object | Y | | |
+| OVRS_RSVN_ODNO | 해외예약주문번호 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+"CANO": "810XXXXX",
+"ACNT_PRDT_CD": "01",
+"RSVN_ORD_RCIT_DT": "20211124",
+"OVRS_RSVN_ODNO": "30135682"
+}
+```
+
+### Response Example
+
+```text
+{
+ "rt_cd": "0",
+ "msg_cd": "APBK1711",
+ "msg1": "취소주문이 접수되었습니다.",
+ "output": {
+ "OVRS_RSVN_ODNO": "0030138295"
+ }
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/250_해외주식-071_해외주식-지정가주문번호조회.md b/docs/broker/kis/rest/해외주식/주문/계좌/250_해외주식-071_해외주식-지정가주문번호조회.md
new file mode 100644
index 0000000..2a64260
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/250_해외주식-071_해외주식-지정가주문번호조회.md
@@ -0,0 +1,101 @@
+# 해외주식 지정가주문번호조회
+
+- 원본 시트명: 해외주식 지정가주문번호조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: 해외주식-071
+- HTTP Method: GET
+- 실전 TR_ID: TTTS6058R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/algo-ordno
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+TWAP, VWAP 주문에 대한 주문번호를 조회하는 API
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | Y | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTS6058R |
+| tr_cont | 연속거래여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 3 | [법인 필수] 001 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | IP주소 | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| TRAD_DT | 거래일자 | string | Y | 8 | YYYYMMDD |
+| CANO | 계좌번호 | string | Y | 8 | 종합계좌번호 (8자리) |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌상품코드 (2자리) : 주식계좌는 01 |
+| CTX_AREA_NK200 | 연속조회키200 | string | N | 200 | |
+| CTX_AREA_FK200 | 연속조회조건200 | string | N | 200 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | |
+| tr_cont | 연속거래여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| output | 응답상세 | object array | Y | | |
+| odno | 주문번호 | string | Y | 10 | |
+| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
+| pdno | 상품번호 | string | Y | 12 | |
+| item_name | 종목명 | string | Y | 60 | |
+| ft_ord_qty | FT주문수량 | string | Y | 4 | |
+| ft_ord_unpr3 | FT주문단가 | string | Y | 8 | |
+| splt_buy_attr_name | 분할매수속성명 | string | Y | 60 | |
+| ft_ccld_qty | FT체결수량 | string | Y | 4 | |
+| ord_gno_brno | 주문채번지점번호 | string | N | 5 | |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
+| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+TRAD_DT:20250523
+CTX_AREA_NK200:
+CTX_AREA_FK200:
+```
+
+### Response Example
+
+```text
+{
+ "ctx_area_nk200": " ",
+ "ctx_area_fk200": "20250523^12345678^01^ ",
+ "output": [],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0560",
+ "msg1": "조회할 내용이 없습니다 "
+}
+```
diff --git a/docs/broker/kis/rest/해외주식/주문/계좌/251_해외주식-035_해외증거금-통화별조회.md b/docs/broker/kis/rest/해외주식/주문/계좌/251_해외주식-035_해외증거금-통화별조회.md
new file mode 100644
index 0000000..575c32b
--- /dev/null
+++ b/docs/broker/kis/rest/해외주식/주문/계좌/251_해외주식-035_해외증거금-통화별조회.md
@@ -0,0 +1,746 @@
+# 해외증거금 통화별조회
+
+- 원본 시트명: 해외증거금 통화별조회
+- API 통신방식: REST
+- 메뉴 위치: [해외주식] 주문/계좌
+- API ID: 해외주식-035
+- HTTP Method: GET
+- 실전 TR_ID: TTTC2101R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-stock/v1/trading/foreign-margin
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외증거금 통화별조회 API입니다.
+한국투자 HTS(eFriend Plus) > [7718] 해외주식 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | TTTC2101R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output | 응답상세 | object array | Y | | array |
+| natn_name | 국가명 | string | Y | 60 | |
+| crcy_cd | 통화코드 | string | Y | 3 | |
+| frcr_dncl_amt1 | 외화예수금액 | string | Y | 186 | |
+| ustl_buy_amt | 미결제매수금액 | string | Y | 182 | |
+| ustl_sll_amt | 미결제매도금액 | string | Y | 182 | |
+| frcr_rcvb_amt | 외화미수금액 | string | Y | 182 | |
+| frcr_mgn_amt | 외화증거금액 | string | Y | 186 | |
+| frcr_gnrl_ord_psbl_amt | 외화일반주문가능금액 | string | Y | 182 | |
+| frcr_ord_psbl_amt1 | 외화주문가능금액 | string | Y | 186 | 원화주문가능환산금액 |
+| itgr_ord_psbl_amt | 통합주문가능금액 | string | Y | 182 | |
+| bass_exrt | 기준환율 | string | Y | 238 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:01
+```
+
+### Response Example
+
+```text
+{
+ "output": [
+ {
+ "natn_name": "미국",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "694.37",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "홍콩",
+ "crcy_cd": "HKD",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "8247.35",
+ "bass_exrt": "172.97000000"
+ },
+ {
+ "natn_name": "홍콩",
+ "crcy_cd": "CNY",
+ "frcr_dncl_amt1": "1459.110000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "7705.45",
+ "bass_exrt": "186.89000000"
+ },
+ {
+ "natn_name": "중화인민공화국",
+ "crcy_cd": "CNY",
+ "frcr_dncl_amt1": "1459.110000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "1448.97",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "7713.10",
+ "bass_exrt": "186.89000000"
+ },
+ {
+ "natn_name": "일본",
+ "crcy_cd": "JPY",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "164359.92",
+ "bass_exrt": "8.68370000"
+ },
+ {
+ "natn_name": "베트남",
+ "crcy_cd": "VND",
+ "frcr_dncl_amt1": "377568.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "네덜란드",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "프랑스",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "영국",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "스위스",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "싱가포르",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "독일",
+ "crcy_cd": "USD",
+ "frcr_dncl_amt1": "698.190000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "1094.52",
+ "bass_exrt": "1349.40000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ },
+ {
+ "natn_name": "",
+ "crcy_cd": "",
+ "frcr_dncl_amt1": "0.000000",
+ "ustl_buy_amt": "0.00",
+ "ustl_sll_amt": "0.00",
+ "frcr_rcvb_amt": "0.00",
+ "frcr_mgn_amt": "0.000000",
+ "frcr_gnrl_ord_psbl_amt": "0.00",
+ "frcr_ord_psbl_amt1": "0.000000",
+ "itgr_ord_psbl_amt": "0.00",
+ "bass_exrt": "0.00000000"
+ }
+ ],
+ "rt_cd": "0",
+ "msg_cd": "KIOK0510",
+ "msg1": "조회가 완료되었습니다 "
+}
+```
diff --git a/docs/broker/kis/websocket/oauth/001_실시간-000_실시간-웹소켓-접속키-발급.md b/docs/broker/kis/websocket/oauth/001_실시간-000_실시간-웹소켓-접속키-발급.md
new file mode 100644
index 0000000..d8ab816
--- /dev/null
+++ b/docs/broker/kis/websocket/oauth/001_실시간-000_실시간-웹소켓-접속키-발급.md
@@ -0,0 +1,67 @@
+# 실시간 (웹소켓) 접속키 발급
+
+- 원본 시트명: 실시간 (웹소켓) 접속키 발급
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: OAuth인증
+- API ID: 실시간-000
+- HTTP Method: POST
+- 실전 TR_ID: 없음
+- 모의 TR_ID: 없음
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: https://openapivts.koreainvestment.com:29443
+- URL 명: /oauth2/Approval
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+실시간 (웹소켓) 접속키 발급받으실 수 있는 API 입니다.
+웹소켓 이용 시 해당 키를 appkey와 appsecret 대신 헤더에 넣어 API를 호출합니다.
+
+접속키의 유효기간은 24시간이지만, 접속키는 세션 연결 시 초기 1회만 사용하기 때문에 접속키 인증 후에는 세션종료되지 않는 이상 접속키 신규 발급받지 않으셔도 365일 내내 웹소켓 데이터 수신하실 수 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | N | 20 | application/json; utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| grant_type | 권한부여타입 | string | Y | 18 | "client_credentials" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| secretkey | 시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
* 주의 : appsecret와 secretkey는 동일하오니 착오없으시기 바랍니다. (용어가 다른점 양해 부탁드립니다.) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 웹소켓 이용 시 발급받은 웹소켓 접속키를 appkey와 appsecret 대신 헤더에 넣어 API 호출합니다. |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "grant_type": "client_credentials",
+ "appkey": "PSg5dctL9dKPo727J13Ur405OSXXXXXXXXXX",
+ "secretkey": "yo2t8zS68zpdjGuWvFyM9VikjXE0i0CbgPEamnqPA00G0bIfrdfQb2RUD1xP7SqatQXr1cD1fGUNsb78MMXoq6o4lAYt9YTtHAjbMoFy+c72kbq5owQY1Pvp39/x6ejpJlXCj7gE3yVOB/h25Hvl+URmYeBTfrQeOqIAOYc/OIXXXXXXXXXX"
+}
+```
+
+### Response Example
+
+```text
+{
+ "approval_key": "a2585daf-8c09-4587-9fce-8ab893XXXXX"
+}
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/214_실시간-045_주식옵션-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/214_실시간-045_주식옵션-실시간호가.md
new file mode 100644
index 0000000..e5a8c08
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/214_실시간-045_주식옵션-실시간호가.md
@@ -0,0 +1,161 @@
+# 주식옵션 실시간호가
+
+- 원본 시트명: 주식옵션 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-045
+- HTTP Method: POST
+- 실전 TR_ID: H0ZOASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZOASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0ZOASP0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| OPTN_ASKP1 | 옵션매도호가1 | string | Y | 8 | |
+| OPTN_ASKP2 | 옵션매도호가2 | string | Y | 8 | |
+| OPTN_ASKP3 | 옵션매도호가3 | string | Y | 8 | |
+| OPTN_ASKP4 | 옵션매도호가4 | string | Y | 8 | |
+| OPTN_ASKP5 | 옵션매도호가5 | string | Y | 8 | |
+| OPTN_BIDP1 | 옵션매수호가1 | string | Y | 8 | |
+| OPTN_BIDP2 | 옵션매수호가2 | string | Y | 8 | |
+| OPTN_BIDP3 | 옵션매수호가3 | string | Y | 8 | |
+| OPTN_BIDP4 | 옵션매수호가4 | string | Y | 8 | |
+| OPTN_BIDP5 | 옵션매수호가5 | string | Y | 8 | |
+| ASKP_CSNU1 | 매도호가건수1 | string | Y | 4 | |
+| ASKP_CSNU2 | 매도호가건수2 | string | Y | 4 | |
+| ASKP_CSNU3 | 매도호가건수3 | string | Y | 4 | |
+| ASKP_CSNU4 | 매도호가건수4 | string | Y | 4 | |
+| ASKP_CSNU5 | 매도호가건수5 | string | Y | 4 | |
+| BIDP_CSNU1 | 매수호가건수1 | string | Y | 4 | |
+| BIDP_CSNU2 | 매수호가건수2 | string | Y | 4 | |
+| BIDP_CSNU3 | 매수호가건수3 | string | Y | 4 | |
+| BIDP_CSNU4 | 매수호가건수4 | string | Y | 4 | |
+| BIDP_CSNU5 | 매수호가건수5 | string | Y | 4 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가잔량5 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_CSNU | 총매도호가건수 | string | Y | 4 | |
+| TOTAL_BIDP_CSNU | 총매수호가건수 | string | Y | 4 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총매도호가잔량증감 | string | Y | 4 | |
+| TOTAL_BIDP_RSQN_ICDC | 총매수호가잔량증감 | string | Y | 4 | |
+| OPTN_ASKP6 | 옵션매도호가6 | string | Y | 8 | |
+| OPTN_ASKP7 | 옵션매도호가7 | string | Y | 8 | |
+| OPTN_ASKP8 | 옵션매도호가8 | string | Y | 8 | |
+| OPTN_ASKP9 | 옵션매도호가9 | string | Y | 8 | |
+| OPTN_ASKP10 | 옵션매도호가10 | string | Y | 8 | |
+| OPTN_BIDP6 | 옵션매수호가6 | string | Y | 8 | |
+| OPTN_BIDP7 | 옵션매수호가7 | string | Y | 8 | |
+| OPTN_BIDP8 | 옵션매수호가8 | string | Y | 8 | |
+| OPTN_BIDP9 | 옵션매수호가9 | string | Y | 8 | |
+| OPTN_BIDP10 | 옵션매수호가10 | string | Y | 8 | |
+| ASKP_CSNU6 | 매도호가건수6 | string | Y | 4 | |
+| ASKP_CSNU7 | 매도호가건수7 | string | Y | 4 | |
+| ASKP_CSNU8 | 매도호가건수8 | string | Y | 4 | |
+| ASKP_CSNU9 | 매도호가건수9 | string | Y | 4 | |
+| ASKP_CSNU10 | 매도호가건수10 | string | Y | 4 | |
+| BIDP_CSNU6 | 매수호가건수6 | string | Y | 4 | |
+| BIDP_CSNU7 | 매수호가건수7 | string | Y | 4 | |
+| BIDP_CSNU8 | 매수호가건수8 | string | Y | 4 | |
+| BIDP_CSNU9 | 매수호가건수9 | string | Y | 4 | |
+| BIDP_CSNU10 | 매수호가건수10 | string | Y | 4 | |
+| ASKP_RSQN6 | 매도호가잔량6 | string | Y | 8 | |
+| ASKP_RSQN7 | 매도호가잔량7 | string | Y | 8 | |
+| ASKP_RSQN8 | 매도호가잔량8 | string | Y | 8 | |
+| ASKP_RSQN9 | 매도호가잔량9 | string | Y | 8 | |
+| ASKP_RSQN10 | 매도호가잔량10 | string | Y | 8 | |
+| BIDP_RSQN6 | 매수호가잔량6 | string | Y | 8 | |
+| BIDP_RSQN7 | 매수호가잔량7 | string | Y | 8 | |
+| BIDP_RSQN8 | 매수호가잔량8 | string | Y | 8 | |
+| BIDP_RSQN9 | 매수호가잔량9 | string | Y | 8 | |
+| BIDP_RSQN10 | 매수호가잔량10 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0ZOASP0",
+ "tr_key": "211V05059"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0ZOASP0",
+ "tr_key": "211V05059",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0ZOASP0|001|211V05059^091509^1140.00^1160.00^1200.00^1300.00^1400.00^1120
+.00^1080.00^620.00^580.00^530.00^2^1^1^1^1^1^2^1^1^1^187^12^10^10^10^12^187^3^3^3^9^6^241^208^
+0^0^1500.00^1520.00^1700.00^0.00^0.00^0.00^0.00^0.00^0.00^0.00^1^1^1^0^0^0^0^0^0^0^10^1^1^0^0^
+0^0^0^0^0
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/215_실시간-012_선물옵션-실시간체결통보.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/215_실시간-012_선물옵션-실시간체결통보.md
new file mode 100644
index 0000000..4dbcaac
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/215_실시간-012_선물옵션-실시간체결통보.md
@@ -0,0 +1,146 @@
+# 선물옵션 실시간체결통보
+
+- 원본 시트명: 선물옵션 실시간체결통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-012
+- HTTP Method: POST
+- 실전 TR_ID: H0IFCNI0
+- 모의 TR_ID: H0IFCNI9
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: ws://ops.koreainvestment.com:31000
+- URL 명: /tryitout/H0IFCNI0
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | [실전투자]
H0IFCNI0 : 실시간 선물옵션 체결통보
[모의투자]
H0IFCNI9 : 실시간 선물옵션 체결통보 |
+| tr_key | 코드 | string | Y | 6 | 예:101S12 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CUST_ID | 고객 ID | array | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| ACNT_NO | 계좌번호 | string | Y | 16 | |
+| ODER_NO | 주문번호 | string | Y | 1 | |
+| OODER_NO | 원주문번호 | string | Y | 8 | |
+| SELN_BYOV_CLS | 매도매수구분 | string | Y | 8 | 01:매도, 02매수 |
+| RCTF_CLS | 정정구분 | string | Y | 8 | |
+| ODER_KIND2 | 주문종류2 | string | Y | 8 | L: 주문접수통보, 0: 체결통보 |
+| STCK_SHRN_ISCD | 주식 단축 종목코드 | string | Y | 8 | |
+| CNTG_QTY | 체결 수량 | string | Y | 8 | |
+| CNTG_UNPR | 체결단가 | string | Y | 8 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 8 | |
+| RFUS_YN | 거부여부 | string | Y | 8 | |
+| CNTG_YN | 체결여부 | string | Y | 8 | 1: 주문,정정,취소,거부 통보, 2 체결 |
+| ACPT_YN | 접수여부 | string | Y | 8 | 1:주문접수, 2:확인, 3, 취소 |
+| BRNC_NO | 지점번호 | string | Y | 8 | |
+| ODER_QTY | 주문수량 | string | Y | 8 | |
+| ACNT_NAME | 계좌명 | string | Y | 8 | |
+| CNTG_ISNM | 체결종목명 | string | Y | 8 | |
+| ODER_COND | 주문조건 | string | Y | 8 | |
+| ORD_GRP | 주문그룹ID | string | Y | 8 | |
+| ORD_GRPSEQ | 주문그룹SEQ | string | Y | 8 | |
+| ORDER_PRC | 주문가격 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0IFCNI0",
+ "tr_key":"HTS ID"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# output - 등록 성공 시
+{
+ "header": {
+ "tr_id": "H0IFCNI0",
+ "tr_key": "HTS ID",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output (복호화 전)
+1|H0IFCNI0|001|vebQjGIHMgFhxfNfvebQjGIHMgFhxfNfvebQjGIHMgFhxfNfvebQj...hxfNf
+
+# output (복호화 후)
+#### 지수선물옵션 체결 통보 ####
+고객ID [abcd1234]
+계좌번호 [1234567803]
+주문번호 [0000001666]
+원주문번호 []
+매도매수구분 [02]
+정정구분 [0]
+주문종류 [0]
+단축종목코드 [111V06]
+체결수량 [0000000002]
+체결단가 [007840000]
+체결시간 [095835]
+거부여부 [0]
+체결여부 [2]
+접수여부 [2]
+지점번호 [00950]
+주문수량 [000000000]
+계좌명 [김한국]
+체결종목명 [삼성전자 F 2]
+주문조건 []
+주문그룹ID []
+주문그룹SEQ []
+주문가격 [000000000]
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/216_실시간-064_KRX야간선물-실시간종목체결.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/216_실시간-064_KRX야간선물-실시간종목체결.md
new file mode 100644
index 0000000..bcc180b
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/216_실시간-064_KRX야간선물-실시간종목체결.md
@@ -0,0 +1,150 @@
+# KRX야간선물 실시간종목체결
+
+- 원본 시트명: KRX야간선물 실시간종목체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-064
+- HTTP Method: POST
+- 실전 TR_ID: H0MFCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0MFCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0MFCNT0 |
+| tr_key | 구분값 | string | Y | 12 | 야간선물 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| FUTS_PRDY_VRSS | 선물 전일 대비 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 1 | |
+| FUTS_PRDY_CTRT | 선물 전일 대비율 | string | Y | 1 | |
+| FUTS_PRPR | 선물 현재가 | string | Y | 1 | |
+| FUTS_OPRC | 선물 시가2 | string | Y | 1 | |
+| FUTS_HGPR | 선물 최고가 | string | Y | 1 | |
+| FUTS_LWPR | 선물 최저가 | string | Y | 1 | |
+| LAST_CNQN | 최종 거래량 | string | Y | 1 | |
+| ACML_VOL | 누적 거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 1 | |
+| HTS_THPR | HTS 이론가 | string | Y | 1 | |
+| MRKT_BASIS | 시장 베이시스 | string | Y | 1 | |
+| DPRT | 괴리율 | string | Y | 1 | |
+| NMSC_FCTN_STPL_PRC | 근월물 약정가 | string | Y | 1 | |
+| FMSC_FCTN_STPL_PRC | 원월물 약정가 | string | Y | 1 | |
+| SPEAD_PRC | 스프레드1 | string | Y | 1 | |
+| HTS_OTST_STPL_QTY | HTS 미결제 약정 수량 | string | Y | 1 | |
+| OTST_STPL_QTY_ICDC | 미결제 약정 수량 증감 | string | Y | 1 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2 대비 현재가 부호 | string | Y | 1 | |
+| OPRC_VRSS_NMIX_PRPR | 시가 대비 지수 현재가 | string | Y | 1 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가 대비 현재가 부호 | string | Y | 1 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가 대비 지수 현재가 | string | Y | 1 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가 대비 현재가 부호 | string | Y | 1 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가 대비 지수 현재가 | string | Y | 1 | |
+| SHNU_RATE | 매수2 비율 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| ESDG | 괴리도 | string | Y | 1 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제 약정 직전 수량 증감 | string | Y | 1 | |
+| THPR_BASIS | 이론 베이시스 | string | Y | 1 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 1 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 1 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 8 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 8 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0MFCNT0",
+ "tr_key": "101V06"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0MFCNT0",
+ "tr_key": "101V06",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0MFCNT0|001|101V06^190215^0.75^2^0.20^367.30^367.10^367.60^367.05^2^1596^1465526
+87^366.08^1.22^0.33^0.00^0.00^0.00^268223^0^000000^2^0.20^000000^5^-0.30^000000^2^0.25^0.49^96.31^1.2
+2^0^0.00^367.35^367.30^0^0^345^358^13^813^783^0^0^0.00
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/217_실시간-065_KRX야간선물-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/217_실시간-065_KRX야간선물-실시간호가.md
new file mode 100644
index 0000000..cf9e3a0
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/217_실시간-065_KRX야간선물-실시간호가.md
@@ -0,0 +1,141 @@
+# KRX야간선물 실시간호가
+
+- 원본 시트명: KRX야간선물 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-065
+- HTTP Method: POST
+- 실전 TR_ID: H0MFASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0MFASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 선물옵션 호가 데이터는 0.2초 필터링 옵션이 있습니다.
+ 필터링 사유는 순간적으로 데이터가 폭증할 경우 서버 뿐만아니라 클라이언트 환경에도 부하를 줄 수 있어 적용된 사항인 점 양해 부탁드립니다.
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0MFASP0 |
+| tr_key | 구분값 | string | Y | 12 | 야간선물 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 8 | |
+| FUTS_ASKP2 | 선물 매도호가2 | string | Y | 8 | |
+| FUTS_ASKP3 | 선물 매도호가3 | string | Y | 8 | |
+| FUTS_ASKP4 | 선물 매도호가4 | string | Y | 8 | |
+| FUTS_ASKP5 | 선물 매도호가5 | string | Y | 8 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 8 | |
+| FUTS_BIDP2 | 선물 매수호가2 | string | Y | 8 | |
+| FUTS_BIDP3 | 선물 매수호가3 | string | Y | 8 | |
+| FUTS_BIDP4 | 선물 매수호가4 | string | Y | 8 | |
+| FUTS_BIDP5 | 선물 매수호가5 | string | Y | 8 | |
+| ASKP_CSNU1 | 매도호가 건수1 | string | Y | 4 | |
+| ASKP_CSNU2 | 매도호가 건수2 | string | Y | 4 | |
+| ASKP_CSNU3 | 매도호가 건수3 | string | Y | 4 | |
+| ASKP_CSNU4 | 매도호가 건수4 | string | Y | 4 | |
+| ASKP_CSNU5 | 매도호가 건수5 | string | Y | 4 | |
+| BIDP_CSNU1 | 매수호가 건수1 | string | Y | 4 | |
+| BIDP_CSNU2 | 매수호가 건수2 | string | Y | 4 | |
+| BIDP_CSNU3 | 매수호가 건수3 | string | Y | 4 | |
+| BIDP_CSNU4 | 매수호가 건수4 | string | Y | 4 | |
+| BIDP_CSNU5 | 매수호가 건수5 | string | Y | 4 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_CSNU | 총 매도호가 건수 | string | Y | 4 | |
+| TOTAL_BIDP_CSNU | 총 매수호가 건수 | string | Y | 4 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 4 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 4 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0MFASP0",
+ "tr_key": "101V06"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0MFASP0",
+ "tr_key": "101V06",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0MFASP0|001|101V06^190215^367.35^367.40^367.45^0.00^0.00^367.30^367.25^367.20^0.
+00^0.00^0^0^0^0^0^0^0^0^0^0^24^21^21^0^0^2^28^20^0^0^0^0^0^0^^0^0^0^0^0^^000000^2^
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/218_실시간-032_KRX야간옵션-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/218_실시간-032_KRX야간옵션-실시간체결가.md
new file mode 100644
index 0000000..06ea638
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/218_실시간-032_KRX야간옵션-실시간체결가.md
@@ -0,0 +1,215 @@
+# KRX야간옵션 실시간체결가
+
+- 원본 시트명: KRX야간옵션 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-032
+- HTTP Method: POST
+- 실전 TR_ID: H0EUCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EUCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EUCNT0 |
+| tr_key | 구분값 | string | Y | 12 | 야간옵션 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| OPTN_PRPR | 옵션현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| OPTN_PRDY_VRSS | 옵션전일대비 | string | Y | 1 | |
+| PRDY_CTRT | 전일대비율 | string | Y | 1 | |
+| OPTN_OPRC | 옵션시가2 | string | Y | 1 | |
+| OPTN_HGPR | 옵션최고가 | string | Y | 1 | |
+| OPTN_LWPR | 옵션최저가 | string | Y | 1 | |
+| LAST_CNQN | 최종거래량 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 1 | |
+| HTS_THPR | HTS이론가 | string | Y | 1 | |
+| HTS_OTST_STPL_QTY | HTS미결제약정수량 | string | Y | 1 | |
+| OTST_STPL_QTY_ICDC | 미결제약정수량증감 | string | Y | 1 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2대비현재가부호 | string | Y | 1 | |
+| OPRC_VRSS_NMIX_PRPR | 시가대비지수현재가 | string | Y | 1 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가대비현재가부호 | string | Y | 1 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가대비지수현재가 | string | Y | 1 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가대비현재가부호 | string | Y | 1 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가대비지수현재가 | string | Y | 1 | |
+| SHNU_RATE | 매수2비율 | string | Y | 1 | |
+| PRMM_VAL | 프리미엄값 | string | Y | 1 | |
+| INVL_VAL | 내재가치값 | string | Y | 1 | |
+| TMVL_VAL | 시간가치값 | string | Y | 1 | |
+| DELTA | 델타 | string | Y | 1 | |
+| GAMA | 감마 | string | Y | 1 | |
+| VEGA | 베가 | string | Y | 1 | |
+| THETA | 세타 | string | Y | 1 | |
+| RHO | 로우 | string | Y | 1 | |
+| HTS_INTS_VLTL | HTS내재변동성 | string | Y | 1 | |
+| ESDG | 괴리도 | string | Y | 1 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제약정직전수량증감 | string | Y | 1 | |
+| THPR_BASIS | 이론베이시스 | string | Y | 1 | |
+| UNAS_HIST_VLTL | 역사적변동성 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| DPRT | 괴리율 | string | Y | 1 | |
+| MRKT_BASIS | 시장베이시스 | string | Y | 1 | |
+| OPTN_ASKP1 | 옵션매도호가1 | string | Y | 1 | |
+| OPTN_BIDP1 | 옵션매수호가1 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 1 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 8 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 1 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0EUCNT0",
+ "tr_key": "301V06362"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EUCNT0",
+ "tr_key": "301V06362",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0EUCNT0|001|301V06362^190612^2.98^5^-0.35^-10.51^3.06^3.09^2.98^1^106^0^-nan^0^0
+^000000^5^-0.08^000000^5^-0.11^000000^3^0.00^0.25^0.00^0.00^2.98^-nan^-nan^-nan^nan^-nan^84.55^-nan^0
+^-nan^nan^32.50^-nan^-363.10^3.00^2.98^15^1^33^18^-15^80^26^37^27^0.00
+
+# output - 복호화 후
+#### 야간옵션(EUREX) 체결 ####
+============================================
+### [1 / 1]
+옵션단축종목코드 [301V06362]
+영업시간 [190612]
+옵션현재가 [2.98]
+전일대비부호 [5]
+옵션전일대비 [-0.35]
+전일대비율 [-10.51]
+옵션시가2 [3.06]
+옵션최고가 [3.09]
+옵션최저가 [2.98]
+최종거래량 [1]
+누적거래량 [106]
+누적거래대금 [0]
+HTS이론가 [-nan]
+HTS미결제약정수량 [0]
+미결제약정수량증감 [0]
+시가시간 [000000]
+시가2대비현재가부호 [5]
+시가대비지수현재가 [-0.08]
+최고가시간 [000000]
+최고가대비현재가부호 [5]
+최고가대비지수현재가 [-0.11]
+최저가시간 [000000]
+최저가대비현재가부호 [3]
+최저가대비지수현재가 [0.00]
+매수2비율 [0.25]
+프리미엄값 [0.00]
+내재가치값 [0.00]
+시간가치값 [2.98]
+델타 [-nan]
+감마 [-nan]
+베가 [-nan]
+세타 [nan]
+로우 [-nan]
+HTS내재변동성 [84.55]
+괴리도 [-nan]
+미결제약정직전수량증감 [0]
+이론베이시스 [-nan]
+역사적변동성 [nan]
+체결강도 [32.50]
+괴리율 [-nan]
+시장베이시스 [-363.10]
+옵션매도호가1 [3.00]
+옵션매수호가1 [2.98]
+매도호가잔량1 [15]
+매수호가잔량1 [1]
+매도체결건수 [33]
+매수체결건수 [18]
+순매수체결건수 [-15]
+총매도수량 [80]
+총매수수량 [26]
+총매도호가잔량 [37]
+총매수호가잔량 [27]
+전일거래량대비등락율 [0.00]
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/219_실시간-034_KRX야간옵션실시간예상체결.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/219_실시간-034_KRX야간옵션실시간예상체결.md
new file mode 100644
index 0000000..f45c845
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/219_실시간-034_KRX야간옵션실시간예상체결.md
@@ -0,0 +1,106 @@
+# KRX야간옵션실시간예상체결
+
+- 원본 시트명: KRX야간옵션실시간예상체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-034
+- HTTP Method: POST
+- 실전 TR_ID: H0EUANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EUANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EUANC0 |
+| tr_key | 구분값 | string | Y | 12 | 야간옵션 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| ANTC_CNPR | 예상체결가 | string | Y | 8 | |
+| ANTC_CNTG_VRSS | 예상체결대비 | string | Y | 8 | |
+| ANTC_CNTG_VRSS_SIGN | 예상체결대비부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상체결전일대비율 | string | Y | 8 | |
+| ANTC_MKOP_CLS_CODE | 예상장운영구분코드 | string | Y | 3 | |
+| ANTC_CNQN | 예상체결수량 | number | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0EUANC0",
+ "tr_key": "301V06362"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EUANC0",
+ "tr_key": "301V06362",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/220_실시간-010_지수선물-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/220_실시간-010_지수선물-실시간체결가.md
new file mode 100644
index 0000000..1d23b4b
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/220_실시간-010_지수선물-실시간체결가.md
@@ -0,0 +1,109 @@
+# 지수선물 실시간체결가
+
+- 원본 시트명: 지수선물 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-010
+- HTTP Method: POST
+- 실전 TR_ID: H0IFCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0IFCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0IFCNT0 |
+| tr_key | 코드 | string | Y | 6 | 예:101S12 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 16 | |
+| FUTS_PRDY_VRSS | 선물 전일 대비 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 8 | |
+| FUTS_PRDY_CTRT | 선물 전일 대비율 | string | Y | 8 | |
+| FUTS_PRPR | 선물 현재가 | string | Y | 8 | |
+| FUTS_OPRC | 선물 시가2 | string | Y | 8 | |
+| FUTS_HGPR | 선물 최고가 | string | Y | 8 | |
+| FUTS_LWPR | 선물 최저가 | string | Y | 8 | |
+| LAST_CNQN | 최종 거래량 | string | Y | 8 | 체결량 |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 8 | |
+| HTS_THPR | HTS 이론가 | string | Y | 8 | |
+| MRKT_BASIS | 시장 베이시스 | string | Y | 8 | |
+| DPRT | 괴리율 | string | Y | 8 | |
+| NMSC_FCTN_STPL_PRC | 근월물 약정가 | string | Y | 8 | |
+| FMSC_FCTN_STPL_PRC | 원월물 약정가 | string | Y | 8 | |
+| SPEAD_PRC | 스프레드1 | string | Y | 8 | |
+| HTS_OTST_STPL_QTY | HTS 미결제 약정 수량 | string | Y | 8 | |
+| OTST_STPL_QTY_ICDC | 미결제 약정 수량 증감 | string | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 8 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2 대비 현재가 부호 | string | Y | 8 | |
+| OPRC_VRSS_NMIX_PRPR | 시가 대비 지수 현재가 | string | Y | 8 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 8 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가 대비 현재가 부호 | string | Y | 8 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가 대비 지수 현재가 | string | Y | 8 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 8 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가 대비 현재가 부호 | string | Y | 8 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가 대비 지수 현재가 | string | Y | 8 | |
+| SHNU_RATE | 매수2 비율 | string | Y | 8 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| ESDG | 괴리도 | string | Y | 8 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제 약정 직전 수량 증감 | string | Y | 8 | |
+| THPR_BASIS | 이론 베이시스 | string | Y | 8 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 8 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 6 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 6 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 6 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 6 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 6 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 6 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 6 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 6 | |
+| DSCS_BLTR_ACML_QTY | 협의 대량 거래량 | string | Y | 6 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 8 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 6 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 10 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/221_실시간-031_주식선물-실시간예상체결.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/221_실시간-031_주식선물-실시간예상체결.md
new file mode 100644
index 0000000..bfade62
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/221_실시간-031_주식선물-실시간예상체결.md
@@ -0,0 +1,64 @@
+# 주식선물 실시간예상체결
+
+- 원본 시트명: 주식선물 실시간예상체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-031
+- HTTP Method: POST
+- 실전 TR_ID: H0ZFANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZFANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0ZFANC0 |
+| tr_key | 구분값 | string | Y | 12 | 주식선물 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| ANTC_CNPR | 예상체결가 | string | Y | 8 | |
+| ANTC_CNTG_VRSS | 예상체결대비 | string | Y | 8 | |
+| ANTC_CNTG_VRSS_SIGN | 예상체결대비부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상체결전일대비율 | string | Y | 8 | |
+| ANTC_MKOP_CLS_CODE | 예상장운영구분코드 | string | Y | 3 | |
+| ANTC_CNQN | 예상체결수량 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/222_실시간-067_KRX야간옵션실시간체결통보.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/222_실시간-067_KRX야간옵션실시간체결통보.md
new file mode 100644
index 0000000..bbd2ed1
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/222_실시간-067_KRX야간옵션실시간체결통보.md
@@ -0,0 +1,141 @@
+# KRX야간옵션실시간체결통보
+
+- 원본 시트명: KRX야간옵션실시간체결통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-067
+- HTTP Method: POST
+- 실전 TR_ID: H0MFCNI0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EUCNI0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0MFCNI0 |
+| tr_key | 구분값 | string | Y | 12 | HTS ID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CUST_ID | 고객 ID | string | Y | 8 | |
+| ACNT_NO | 계좌번호 | string | Y | 10 | |
+| ODER_NO | 주문번호 | string | Y | 10 | |
+| OODER_NO | 원주문번호 | string | Y | 10 | |
+| SELN_BYOV_CLS | 매도매수구분 | string | Y | 2 | |
+| RCTF_CLS | 정정구분 | string | Y | 1 | |
+| ODER_KIND2 | 주문종류2 | string | Y | 1 | |
+| STCK_SHRN_ISCD | 주식 단축 종목코드 | string | Y | 9 | |
+| CNTG_QTY | 체결 수량 | string | Y | 10 | |
+| CNTG_UNPR | 체결단가 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| RFUS_YN | 거부여부 | string | Y | 1 | |
+| CNTG_YN | 체결여부 | string | Y | 1 | |
+| ACPT_YN | 접수여부 | string | Y | 1 | |
+| BRNC_NO | 지점번호 | string | Y | 5 | |
+| ODER_QTY | 주문수량 | string | Y | 9 | |
+| ACNT_NAME | 계좌명 | string | Y | 12 | |
+| CNTG_ISNM | 체결종목명 | string | Y | 14 | |
+| ODER_COND | 주문조건 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0EUCNI0",
+ "tr_key": "HTS_ID"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EUCNI0",
+ "tr_key": "HTS_ID",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+1|H0EUCNI0|001|qWVvLmhf0Iax57SI6HYSTc30qiWTnUjWAT+BxQD4RaljIiBLp3XqzoA0eeEFa7yn8afB
+Ufvo32b/Ivf9rxtl1VZU+oouQlH9rwuNjUnC40gkB+2lm2Q8sTkc4wMYKJuOn8SnLrfGjilAIzueLOLCndSy5xkv4qmPAXk+NKC6x
+nimfxBoVTVtcrpzOaHPvwvD
+
+# output - 복호화 후
+#### 국내선물옵션 주문 접수 통보 ####
+고객ID [HTS_ID]
+계좌번호 [1234567803]
+주문번호 [0000000021]
+원주문번호 [0000000021]
+매도매수구분 [02]
+정정구분 [0]
+주문종류 [L]
+단축종목코드 [175V06]
+주문수량 [0000000001]
+체결단가 [000135900]
+체결시간 [100422]
+거부여부 [0]
+체결여부 [1]
+접수여부 [1]
+지점번호 [00000]
+체결수량 [000000001]
+계좌명 [******]
+체결종목명 [미국달러F2406]
+주문조건 [0]
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/223_실시간-066_KRX야간선물-실시간체결통보.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/223_실시간-066_KRX야간선물-실시간체결통보.md
new file mode 100644
index 0000000..f0928cd
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/223_실시간-066_KRX야간선물-실시간체결통보.md
@@ -0,0 +1,78 @@
+# KRX야간선물 실시간체결통보
+
+- 원본 시트명: KRX야간선물 실시간체결통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-066
+- HTTP Method: POST
+- 실전 TR_ID: H0MFCNI0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0MFCNI0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0MFCNI0 |
+| tr_key | 구분값 | string | Y | 12 | HTS ID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CUST_ID | 고객 ID | string | Y | 8 | |
+| ACNT_NO | 계좌번호 | string | Y | 10 | |
+| ODER_NO | 주문번호 | string | Y | 10 | |
+| OODER_NO | 원주문번호 | string | Y | 10 | |
+| SELN_BYOV_CLS | 매도매수구분 | string | Y | 2 | |
+| RCTF_CLS | 정정구분 | string | Y | 1 | |
+| ODER_KIND2 | 주문종류2 | string | Y | 1 | |
+| STCK_SHRN_ISCD | 주식 단축 종목코드 | string | Y | 9 | |
+| CNTG_QTY | 체결 수량 | string | Y | 10 | |
+| CNTG_UNPR | 체결단가 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| RFUS_YN | 거부여부 | string | Y | 1 | |
+| CNTG_YN | 체결여부 | string | Y | 1 | |
+| ACPT_YN | 접수여부 | string | Y | 1 | |
+| BRNC_NO | 지점번호 | string | Y | 5 | |
+| ODER_QTY | 주문수량 | string | Y | 9 | |
+| ACNT_NAME | 계좌명 | string | Y | 12 | |
+| CNTG_ISNM | 체결종목명 | string | Y | 14 | |
+| ODER_COND | 주문조건 | string | Y | 1 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/224_실시간-022_상품선물-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/224_실시간-022_상품선물-실시간체결가.md
new file mode 100644
index 0000000..c3254a6
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/224_실시간-022_상품선물-실시간체결가.md
@@ -0,0 +1,100 @@
+# 상품선물 실시간체결가
+
+- 원본 시트명: 상품선물 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-022
+- HTTP Method: POST
+- 실전 TR_ID: H0CFCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0CFCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0CFCNT0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | object | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 9 | |
+| FUTS_PRDY_VRSS | 선물 전일 대비 | string | Y | 6 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 8 | |
+| FUTS_PRDY_CTRT | 선물 전일 대비율 | string | Y | 1 | |
+| FUTS_PRPR | 선물 현재가 | string | Y | 8 | |
+| FUTS_OPRC | 선물 시가2 | string | Y | 8 | |
+| FUTS_HGPR | 선물 최고가 | string | Y | 8 | |
+| FUTS_LWPR | 선물 최저가 | string | Y | 8 | |
+| LAST_CNQN | 최종 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 8 | |
+| HTS_THPR | HTS 이론가 | string | Y | 8 | |
+| MRKT_BASIS | 시장 베이시스 | string | Y | 8 | |
+| DPRT | 괴리율 | string | Y | 8 | |
+| NMSC_FCTN_STPL_PRC | 근월물 약정가 | string | Y | 8 | |
+| FMSC_FCTN_STPL_PRC | 원월물 약정가 | string | Y | 8 | |
+| SPEAD_PRC | 스프레드1 | string | Y | 8 | |
+| HTS_OTST_STPL_QTY | HTS 미결제 약정 수량 | string | Y | 8 | |
+| OTST_STPL_QTY_ICDC | 미결제 약정 수량 증감 | string | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 4 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2 대비 현재가 부호 | string | Y | 6 | |
+| OPRC_VRSS_NMIX_PRPR | 시가 대비 지수 현재가 | string | Y | 1 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 8 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가 대비 현재가 부호 | string | Y | 6 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가 대비 지수 현재가 | string | Y | 1 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 8 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가 대비 현재가 부호 | string | Y | 6 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가 대비 지수 현재가 | string | Y | 1 | |
+| SHNU_RATE | 매수2 비율 | string | Y | 8 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| ESDG | 괴리도 | string | Y | 8 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제 약정 직전 수량 증감 | string | Y | 8 | |
+| THPR_BASIS | 이론 베이시스 | string | Y | 4 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 8 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 8 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 4 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 4 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 8 | |
+| DSCS_BLTR_ACML_QTY | 협의 대량 거래량 | string | Y | 8 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 8 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 8 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/225_실시간-011_지수선물-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/225_실시간-011_지수선물-실시간호가.md
new file mode 100644
index 0000000..27f0300
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/225_실시간-011_지수선물-실시간호가.md
@@ -0,0 +1,97 @@
+# 지수선물 실시간호가
+
+- 원본 시트명: 지수선물 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-011
+- HTTP Method: POST
+- 실전 TR_ID: H0IFASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0IFASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 선물옵션 호가 데이터는 0.2초 필터링 옵션이 있습니다.
+ 필터링 사유는 순간적으로 데이터가 폭증할 경우 서버 뿐만아니라 클라이언트 환경에도 부하를 줄 수 있어 적용된 사항인 점 양해 부탁드립니다.
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0IFASP0 |
+| tr_key | 코드 | string | Y | 6 | 예:101S12 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 16 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 1 | |
+| FUTS_ASKP2 | 선물 매도호가2 | string | Y | 8 | |
+| FUTS_ASKP3 | 선물 매도호가3 | string | Y | 8 | |
+| FUTS_ASKP4 | 선물 매도호가4 | string | Y | 8 | |
+| FUTS_ASKP5 | 선물 매도호가5 | string | Y | 8 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 8 | |
+| FUTS_BIDP2 | 선물 매수호가2 | string | Y | 8 | |
+| FUTS_BIDP3 | 선물 매수호가3 | string | Y | 8 | |
+| FUTS_BIDP4 | 선물 매수호가4 | string | Y | 8 | |
+| FUTS_BIDP5 | 선물 매수호가5 | string | Y | 8 | |
+| ASKP_CSNU1 | 매도호가 건수1 | string | Y | 8 | |
+| ASKP_CSNU2 | 매도호가 건수2 | string | Y | 8 | |
+| ASKP_CSNU3 | 매도호가 건수3 | string | Y | 8 | |
+| ASKP_CSNU4 | 매도호가 건수4 | string | Y | 8 | |
+| ASKP_CSNU5 | 매도호가 건수5 | string | Y | 8 | |
+| BIDP_CSNU1 | 매수호가 건수1 | string | Y | 8 | |
+| BIDP_CSNU2 | 매수호가 건수2 | string | Y | 8 | |
+| BIDP_CSNU3 | 매수호가 건수3 | string | Y | 8 | |
+| BIDP_CSNU4 | 매수호가 건수4 | string | Y | 8 | |
+| BIDP_CSNU5 | 매수호가 건수5 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_CSNU | 총 매도호가 건수 | string | Y | 8 | |
+| TOTAL_BIDP_CSNU | 총 매수호가 건수 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/226_실시간-014_지수옵션-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/226_실시간-014_지수옵션-실시간체결가.md
new file mode 100644
index 0000000..cea335d
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/226_실시간-014_지수옵션-실시간체결가.md
@@ -0,0 +1,114 @@
+# 지수옵션 실시간체결가
+
+- 원본 시트명: 지수옵션 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-014
+- HTTP Method: POST
+- 실전 TR_ID: H0IOCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0IOCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0IOCNT0 |
+| tr_key | 코드 | string | Y | 6 | 예:201S11305 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션 단축 종목코드 | object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 16 | |
+| OPTN_PRPR | 옵션 현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 8 | |
+| OPTN_PRDY_VRSS | 옵션 전일 대비 | string | Y | 8 | |
+| PRDY_CTRT | 전일 대비율 | string | Y | 8 | |
+| OPTN_OPRC | 옵션 시가2 | string | Y | 8 | |
+| OPTN_HGPR | 옵션 최고가 | string | Y | 8 | |
+| OPTN_LWPR | 옵션 최저가 | string | Y | 8 | |
+| LAST_CNQN | 최종 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 8 | |
+| HTS_THPR | HTS 이론가 | string | Y | 8 | |
+| HTS_OTST_STPL_QTY | HTS 미결제 약정 수량 | string | Y | 8 | |
+| OTST_STPL_QTY_ICDC | 미결제 약정 수량 증감 | string | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 8 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2 대비 현재가 부호 | string | Y | 8 | |
+| OPRC_VRSS_NMIX_PRPR | 시가 대비 지수 현재가 | string | Y | 8 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 8 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가 대비 현재가 부호 | string | Y | 8 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가 대비 지수 현재가 | string | Y | 8 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 8 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가 대비 현재가 부호 | string | Y | 8 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가 대비 지수 현재가 | string | Y | 8 | |
+| SHNU_RATE | 매수2 비율 | string | Y | 8 | |
+| PRMM_VAL | 프리미엄 값 | string | Y | 8 | |
+| INVL_VAL | 내재가치 값 | string | Y | 8 | |
+| TMVL_VAL | 시간가치 값 | string | Y | 8 | |
+| DELTA | 델타 | string | Y | 8 | |
+| GAMA | 감마 | string | Y | 8 | |
+| VEGA | 베가 | string | Y | 8 | |
+| THETA | 세타 | string | Y | 8 | |
+| RHO | 로우 | string | Y | 8 | |
+| HTS_INTS_VLTL | HTS 내재 변동성 | string | Y | 8 | |
+| ESDG | 괴리도 | string | Y | 8 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제 약정 직전 수량 증감 | string | Y | 8 | |
+| THPR_BASIS | 이론 베이시스 | string | Y | 8 | |
+| UNAS_HIST_VLTL | 역사적변동성 | string | Y | 8 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| DPRT | 괴리율 | string | Y | 8 | |
+| MRKT_BASIS | 시장 베이시스 | string | Y | 8 | |
+| OPTN_ASKP1 | 옵션 매도호가1 | string | Y | 8 | |
+| OPTN_BIDP1 | 옵션 매수호가1 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 8 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 8 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 6 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 6 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 6 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 6 | |
+| AVRG_VLTL | 평균 변동성 | string | Y | 6 | |
+| DSCS_LRQN_VOL | 협의대량누적 거래량 | string | Y | 6 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 6 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 6 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 6 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/227_실시간-033_KRX야간옵션-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/227_실시간-033_KRX야간옵션-실시간호가.md
new file mode 100644
index 0000000..0af8f56
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/227_실시간-033_KRX야간옵션-실시간호가.md
@@ -0,0 +1,157 @@
+# KRX야간옵션 실시간호가
+
+- 원본 시트명: KRX야간옵션 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-033
+- HTTP Method: POST
+- 실전 TR_ID: H0EUASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EUASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EUASP0 |
+| tr_key | 구분값 | string | Y | 12 | 야간옵션 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| OPTN_ASKP1 | 옵션매도호가1 | string | Y | 1 | |
+| OPTN_ASKP2 | 옵션매도호가2 | string | Y | 1 | |
+| OPTN_ASKP3 | 옵션매도호가3 | string | Y | 1 | |
+| OPTN_ASKP4 | 옵션매도호가4 | string | Y | 1 | |
+| OPTN_ASKP5 | 옵션매도호가5 | string | Y | 1 | |
+| OPTN_BIDP1 | 옵션매수호가1 | string | Y | 1 | |
+| OPTN_BIDP2 | 옵션매수호가2 | string | Y | 1 | |
+| OPTN_BIDP3 | 옵션매수호가3 | string | Y | 1 | |
+| OPTN_BIDP4 | 옵션매수호가4 | string | Y | 1 | |
+| OPTN_BIDP5 | 옵션매수호가5 | string | Y | 1 | |
+| ASKP_CSNU1 | 매도호가건수1 | string | Y | 1 | |
+| ASKP_CSNU2 | 매도호가건수2 | string | Y | 1 | |
+| ASKP_CSNU3 | 매도호가건수3 | string | Y | 1 | |
+| ASKP_CSNU4 | 매도호가건수4 | string | Y | 1 | |
+| ASKP_CSNU5 | 매도호가건수5 | string | Y | 1 | |
+| BIDP_CSNU1 | 매수호가건수1 | string | Y | 1 | |
+| BIDP_CSNU2 | 매수호가건수2 | string | Y | 1 | |
+| BIDP_CSNU3 | 매수호가건수3 | string | Y | 1 | |
+| BIDP_CSNU4 | 매수호가건수4 | string | Y | 1 | |
+| BIDP_CSNU5 | 매수호가건수5 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 1 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 1 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 1 | |
+| ASKP_RSQN5 | 매도호가잔량5 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 1 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 1 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 1 | |
+| BIDP_RSQN5 | 매수호가잔량5 | string | Y | 1 | |
+| TOTAL_ASKP_CSNU | 총매도호가건수 | string | Y | 1 | |
+| TOTAL_BIDP_CSNU | 총매수호가건수 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN_ICDC | 총매도호가잔량증감 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN_ICDC | 총매수호가잔량증감 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0EUASP0",
+ "tr_key": "301V06362"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EUASP0",
+ "tr_key": "301V06362",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0EUASP0|001|301V06362^190159^2.98^2.99^3.00^0.00^0.00^2.97^2.96^2.95^0.00^0.00^0
+^0^0^0^0^0^0^0^0^0^1^3^12^0^0^9^21^16^0^0^0^0^16^46^5^0
+
+# output - 복호화 후
+#### 야간옵션(EUREX) 호가 ####
+야간옵션(EUREX) [301V06362]
+영업시간 [190215]
+====================================
+옵션매도호가1 [2.98], 매도호가건수1 [0], 매도호가잔량1 [1]
+옵션매도호가2 [3.00], 매도호가건수2 [0], 매도호가잔량2 [6]
+옵션매도호가3 [3.01], 매도호가건수3 [0], 매도호가잔량3 [15]
+옵션매도호가4 [0.00], 매도호가건수4 [0], 매도호가잔량4 [0]
+옵션매도호가5 [0.00], 매도호가건수5 [0], 매도호가잔량5 [0]
+옵션매수호가1 [2.97], 매수호가건수1 [0], 매수호가잔량1 [10]
+옵션매수호가2 [2.96], 매수호가건수2 [0], 매수호가잔량2 [21]
+옵션매수호가3 [2.95], 매수호가건수3 [0], 매수호가잔량3 [16]
+옵션매수호가4 [0.00], 매수호가건수4 [0], 매수호가잔량4 [0]
+옵션매수호가5 [0.00], 매수호가건수5 [0], 매수호가잔량5 [0]
+====================================
+총매도호가건수 [0], 총매도호가잔량 [22], 총매도호가잔량증감 [-1]
+총매수호가건수 [0], 총매수호가잔량 [47], 총매수호가잔량증감 [1]
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/228_실시간-023_상품선물-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/228_실시간-023_상품선물-실시간호가.md
new file mode 100644
index 0000000..5e566e3
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/228_실시간-023_상품선물-실시간호가.md
@@ -0,0 +1,89 @@
+# 상품선물 실시간호가
+
+- 원본 시트명: 상품선물 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-023
+- HTTP Method: POST
+- 실전 TR_ID: H0CFASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0CFASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 선물옵션 호가 데이터는 0.2초 필터링 옵션이 있습니다.
+ 필터링 사유는 순간적으로 데이터가 폭증할 경우 서버 뿐만아니라 클라이언트 환경에도 부하를 줄 수 있어 적용된 사항인 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0CFASP0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물 단축 종목코드 | object | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 9 | |
+| FUTS_ASKP1 | 선물 매도호가1 | string | Y | 6 | |
+| FUTS_ASKP2 | 선물 매도호가2 | string | Y | 8 | |
+| FUTS_ASKP3 | 선물 매도호가3 | string | Y | 1 | |
+| FUTS_ASKP4 | 선물 매도호가4 | string | Y | 8 | |
+| FUTS_ASKP5 | 선물 매도호가5 | string | Y | 8 | |
+| FUTS_BIDP1 | 선물 매수호가1 | string | Y | 8 | |
+| FUTS_BIDP2 | 선물 매수호가2 | string | Y | 8 | |
+| FUTS_BIDP3 | 선물 매수호가3 | string | Y | 8 | |
+| FUTS_BIDP4 | 선물 매수호가4 | string | Y | 8 | |
+| FUTS_BIDP5 | 선물 매수호가5 | string | Y | 8 | |
+| ASKP_CSNU1 | 매도호가 건수1 | string | Y | 8 | |
+| ASKP_CSNU2 | 매도호가 건수2 | string | Y | 8 | |
+| ASKP_CSNU3 | 매도호가 건수3 | string | Y | 8 | |
+| ASKP_CSNU4 | 매도호가 건수4 | string | Y | 8 | |
+| ASKP_CSNU5 | 매도호가 건수5 | string | Y | 8 | |
+| BIDP_CSNU1 | 매수호가 건수1 | string | Y | 8 | |
+| BIDP_CSNU2 | 매수호가 건수2 | string | Y | 8 | |
+| BIDP_CSNU3 | 매수호가 건수3 | string | Y | 8 | |
+| BIDP_CSNU4 | 매수호가 건수4 | string | Y | 4 | |
+| BIDP_CSNU5 | 매수호가 건수5 | string | Y | 6 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 1 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 6 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 1 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 6 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 1 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_CSNU | 총 매도호가 건수 | string | Y | 8 | |
+| TOTAL_BIDP_CSNU | 총 매수호가 건수 | string | Y | 4 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/229_실시간-046_주식옵션-실시간예상체결.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/229_실시간-046_주식옵션-실시간예상체결.md
new file mode 100644
index 0000000..7ac9b89
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/229_실시간-046_주식옵션-실시간예상체결.md
@@ -0,0 +1,63 @@
+# 주식옵션 실시간예상체결
+
+- 원본 시트명: 주식옵션 실시간예상체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-046
+- HTTP Method: POST
+- 실전 TR_ID: H0ZOANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZOANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0ZOANC0 |
+| tr_key | 구분값 | string | Y | 12 | 주식옵션 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| ANTC_CNPR | 예상체결가 | string | Y | 8 | |
+| ANTC_CNTG_VRSS | 예상체결대비 | string | Y | 8 | |
+| ANTC_CNTG_VRSS_SIGN | 예상체결대비부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상체결전일대비율 | string | Y | 8 | |
+| ANTC_MKOP_CLS_CODE | 예상장운영구분코드 | string | Y | 3 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/230_실시간-030_주식선물-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/230_실시간-030_주식선물-실시간호가.md
new file mode 100644
index 0000000..c286028
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/230_실시간-030_주식선물-실시간호가.md
@@ -0,0 +1,162 @@
+# 주식선물 실시간호가
+
+- 원본 시트명: 주식선물 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-030
+- HTTP Method: POST
+- 실전 TR_ID: H0ZFASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZFASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ 선물옵션 호가 데이터는 0.2초 필터링 옵션이 있습니다.
+ 필터링 사유는 순간적으로 데이터가 폭증할 경우 서버 뿐만아니라 클라이언트 환경에도 부하를 줄 수 있어 적용된 사항인 점 양해 부탁드립니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0ZFASP0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| ASKP1 | 매도호가1 | string | Y | 1 | |
+| ASKP2 | 매도호가2 | string | Y | 1 | |
+| ASKP3 | 매도호가3 | string | Y | 1 | |
+| ASKP4 | 매도호가4 | string | Y | 1 | |
+| ASKP5 | 매도호가5 | string | Y | 1 | |
+| ASKP6 | 매도호가6 | string | Y | 1 | |
+| ASKP7 | 매도호가7 | string | Y | 1 | |
+| ASKP8 | 매도호가8 | string | Y | 1 | |
+| ASKP9 | 매도호가9 | string | Y | 1 | |
+| ASKP10 | 매도호가10 | string | Y | 1 | |
+| BIDP1 | 매수호가1 | string | Y | 1 | |
+| BIDP2 | 매수호가2 | string | Y | 1 | |
+| BIDP3 | 매수호가3 | string | Y | 1 | |
+| BIDP4 | 매수호가4 | string | Y | 1 | |
+| BIDP5 | 매수호가5 | string | Y | 1 | |
+| BIDP6 | 매수호가6 | string | Y | 1 | |
+| BIDP7 | 매수호가7 | string | Y | 1 | |
+| BIDP8 | 매수호가8 | string | Y | 1 | |
+| BIDP9 | 매수호가9 | string | Y | 1 | |
+| BIDP10 | 매수호가10 | string | Y | 1 | |
+| ASKP_CSNU1 | 매도호가건수1 | string | Y | 1 | |
+| ASKP_CSNU2 | 매도호가건수2 | string | Y | 1 | |
+| ASKP_CSNU3 | 매도호가건수3 | string | Y | 1 | |
+| ASKP_CSNU4 | 매도호가건수4 | string | Y | 1 | |
+| ASKP_CSNU5 | 매도호가건수5 | string | Y | 1 | |
+| ASKP_CSNU6 | 매도호가건수6 | string | Y | 1 | |
+| ASKP_CSNU7 | 매도호가건수7 | string | Y | 1 | |
+| ASKP_CSNU8 | 매도호가건수8 | string | Y | 1 | |
+| ASKP_CSNU9 | 매도호가건수9 | string | Y | 1 | |
+| ASKP_CSNU10 | 매도호가건수10 | string | Y | 1 | |
+| BIDP_CSNU1 | 매수호가건수1 | string | Y | 1 | |
+| BIDP_CSNU2 | 매수호가건수2 | string | Y | 1 | |
+| BIDP_CSNU3 | 매수호가건수3 | string | Y | 1 | |
+| BIDP_CSNU4 | 매수호가건수4 | string | Y | 1 | |
+| BIDP_CSNU5 | 매수호가건수5 | string | Y | 1 | |
+| BIDP_CSNU6 | 매수호가건수6 | string | Y | 1 | |
+| BIDP_CSNU7 | 매수호가건수7 | string | Y | 1 | |
+| BIDP_CSNU8 | 매수호가건수8 | string | Y | 1 | |
+| BIDP_CSNU9 | 매수호가건수9 | string | Y | 1 | |
+| BIDP_CSNU10 | 매수호가건수10 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 1 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 1 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 1 | |
+| ASKP_RSQN5 | 매도호가잔량5 | string | Y | 1 | |
+| ASKP_RSQN6 | 매도호가잔량6 | string | Y | 1 | |
+| ASKP_RSQN7 | 매도호가잔량7 | string | Y | 1 | |
+| ASKP_RSQN8 | 매도호가잔량8 | string | Y | 1 | |
+| ASKP_RSQN9 | 매도호가잔량9 | string | Y | 1 | |
+| ASKP_RSQN10 | 매도호가잔량10 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 1 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 1 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 1 | |
+| BIDP_RSQN5 | 매수호가잔량5 | string | Y | 1 | |
+| BIDP_RSQN6 | 매수호가잔량6 | string | Y | 1 | |
+| BIDP_RSQN7 | 매수호가잔량7 | string | Y | 1 | |
+| BIDP_RSQN8 | 매수호가잔량8 | string | Y | 1 | |
+| BIDP_RSQN9 | 매수호가잔량9 | string | Y | 1 | |
+| BIDP_RSQN10 | 매수호가잔량10 | string | Y | 1 | |
+| TOTAL_ASKP_CSNU | 총매도호가건수 | string | Y | 1 | |
+| TOTAL_BIDP_CSNU | 총매수호가건수 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN_ICDC | 총매도호가잔량증감 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN_ICDC | 총매수호가잔량증감 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0ZFASP0",
+ "tr_key": "111V06"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0ZFASP0",
+ "tr_key": "111V06",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0ZFASP0|001|111V06^092304^79700^79800^79900^80000^80200^80300^80500^81100^8490
+0^85900^79500^79400^79300^79200^79100^79000^78900^78800^78700^78600^1^18^6^2^2^1^3^1^1^1^8^6^4^8^4^
+8^7^11^11^3^950^4148^988^6^9^1^3^15^5^10^4404^2277^1321^3440^330^2237^1835^362^83^15^36^97^6135^165
+09^950^0
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/231_실시간-044_주식옵션-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/231_실시간-044_주식옵션-실시간체결가.md
new file mode 100644
index 0000000..82ce937
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/231_실시간-044_주식옵션-실시간체결가.md
@@ -0,0 +1,146 @@
+# 주식옵션 실시간체결가
+
+- 원본 시트명: 주식옵션 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-044
+- HTTP Method: POST
+- 실전 TR_ID: H0ZOCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZOCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0ZOCNT0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| OPTN_PRPR | 옵션현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| OPTN_PRDY_VRSS | 옵션전일대비 | string | Y | 1 | |
+| PRDY_CTRT | 전일대비율 | string | Y | 1 | |
+| OPTN_OPRC | 옵션시가2 | string | Y | 1 | |
+| OPTN_HGPR | 옵션최고가 | string | Y | 1 | |
+| OPTN_LWPR | 옵션최저가 | string | Y | 1 | |
+| LAST_CNQN | 최종거래량 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 1 | |
+| HTS_THPR | HTS이론가 | string | Y | 1 | |
+| HTS_OTST_STPL_QTY | HTS미결제약정수량 | string | Y | 1 | |
+| OTST_STPL_QTY_ICDC | 미결제약정수량증감 | string | Y | 1 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2대비현재가부호 | string | Y | 1 | |
+| OPRC_VRSS_NMIX_PRPR | 시가대비지수현재가 | string | Y | 1 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가대비현재가부호 | string | Y | 1 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가대비지수현재가 | string | Y | 1 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가대비현재가부호 | string | Y | 1 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가대비지수현재가 | string | Y | 1 | |
+| SHNU_RATE | 매수2비율 | string | Y | 1 | |
+| PRMM_VAL | 프리미엄값 | string | Y | 1 | |
+| INVL_VAL | 내재가치값 | string | Y | 1 | |
+| TMVL_VAL | 시간가치값 | string | Y | 1 | |
+| DELTA | 델타 | string | Y | 1 | |
+| GAMA | 감마 | string | Y | 1 | |
+| VEGA | 베가 | string | Y | 1 | |
+| THETA | 세타 | string | Y | 1 | |
+| RHO | 로우 | string | Y | 1 | |
+| HTS_INTS_VLTL | HTS내재변동성 | string | Y | 1 | |
+| ESDG | 괴리도 | string | Y | 1 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제약정직전수량증감 | string | Y | 1 | |
+| THPR_BASIS | 이론베이시스 | string | Y | 1 | |
+| UNAS_HIST_VLTL | 역사적변동성 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| DPRT | 괴리율 | string | Y | 1 | |
+| MRKT_BASIS | 시장베이시스 | string | Y | 1 | |
+| OPTN_ASKP1 | 옵션매도호가1 | string | Y | 1 | |
+| OPTN_BIDP1 | 옵션매수호가1 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0ZOCNT0",
+ "tr_key": "211V05059"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0ZOCNT0",
+ "tr_key": "211V05059",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0ZOCNT0|001|211V05059^091940^1060.00^5^-120.00^-10.17^970.00^1140.00^970
+.00^6^563^5933200^35464.07^1134^-2^000000^2^90.00^000000^5^-80.00^000000^2^90.00^0.43^0.00^0.
+00^1060.00^1.00^0.00^0.00^-4.06^20.58^0.31^-34404.07^0^-41735.93^0.26^74.84^-97.01^-76140.00^
+1100.00^1040.00^6^175^13^16^3^322^241^241^184^12.33
+```
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/232_실시간-015_지수옵션-실시간호가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/232_실시간-015_지수옵션-실시간호가.md
new file mode 100644
index 0000000..c1d4ca5
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/232_실시간-015_지수옵션-실시간호가.md
@@ -0,0 +1,94 @@
+# 지수옵션 실시간호가
+
+- 원본 시트명: 지수옵션 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-015
+- HTTP Method: POST
+- 실전 TR_ID: H0IOASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0IOASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0IOASP0 |
+| tr_key | 코드 | string | Y | 6 | 예:201S11305 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| OPTN_SHRN_ISCD | 옵션 단축 종목코드 | object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 16 | |
+| OPTN_ASKP1 | 옵션 매도호가1 | string | Y | 1 | |
+| OPTN_ASKP2 | 옵션 매도호가2 | string | Y | 8 | |
+| OPTN_ASKP3 | 옵션 매도호가3 | string | Y | 8 | |
+| OPTN_ASKP4 | 옵션 매도호가4 | string | Y | 8 | |
+| OPTN_ASKP5 | 옵션 매도호가5 | string | Y | 8 | |
+| OPTN_BIDP1 | 옵션 매수호가1 | string | Y | 8 | |
+| OPTN_BIDP2 | 옵션 매수호가2 | string | Y | 8 | |
+| OPTN_BIDP3 | 옵션 매수호가3 | string | Y | 8 | |
+| OPTN_BIDP4 | 옵션 매수호가4 | string | Y | 8 | |
+| OPTN_BIDP5 | 옵션 매수호가5 | string | Y | 8 | |
+| ASKP_CSNU1 | 매도호가 건수1 | string | Y | 8 | |
+| ASKP_CSNU2 | 매도호가 건수2 | string | Y | 8 | |
+| ASKP_CSNU3 | 매도호가 건수3 | string | Y | 8 | |
+| ASKP_CSNU4 | 매도호가 건수4 | string | Y | 8 | |
+| ASKP_CSNU5 | 매도호가 건수5 | string | Y | 8 | |
+| BIDP_CSNU1 | 매수호가 건수1 | string | Y | 8 | |
+| BIDP_CSNU2 | 매수호가 건수2 | string | Y | 8 | |
+| BIDP_CSNU3 | 매수호가 건수3 | string | Y | 8 | |
+| BIDP_CSNU4 | 매수호가 건수4 | string | Y | 8 | |
+| BIDP_CSNU5 | 매수호가 건수5 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_CSNU | 총 매도호가 건수 | string | Y | 8 | |
+| TOTAL_BIDP_CSNU | 총 매수호가 건수 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내선물옵션/실시간시세/233_실시간-029_주식선물-실시간체결가.md b/docs/broker/kis/websocket/국내선물옵션/실시간시세/233_실시간-029_주식선물-실시간체결가.md
new file mode 100644
index 0000000..52f7f5b
--- /dev/null
+++ b/docs/broker/kis/websocket/국내선물옵션/실시간시세/233_실시간-029_주식선물-실시간체결가.md
@@ -0,0 +1,141 @@
+# 주식선물 실시간체결가
+
+- 원본 시트명: 주식선물 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내선물옵션] 실시간시세
+- API ID: 실시간-029
+- HTTP Method: POST
+- 실전 TR_ID: H0ZFCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0ZFCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0ZFCNT0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FUTS_SHRN_ISCD | 선물단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 4 | |
+| FUTS_PRDY_CTRT | 선물전일대비율 | string | Y | 8 | |
+| STCK_OPRC | 주식시가2 | string | Y | 4 | |
+| STCK_HGPR | 주식최고가 | string | Y | 4 | |
+| STCK_LWPR | 주식최저가 | string | Y | 4 | |
+| LAST_CNQN | 최종거래량 | string | Y | 8 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 8 | |
+| HTS_THPR | HTS이론가 | string | Y | 8 | |
+| MRKT_BASIS | 시장베이시스 | string | Y | 8 | |
+| DPRT | 괴리율 | string | Y | 8 | |
+| NMSC_FCTN_STPL_PRC | 근월물약정가 | string | Y | 8 | |
+| FMSC_FCTN_STPL_PRC | 원월물약정가 | string | Y | 8 | |
+| SPEAD_PRC | 스프레드1 | string | Y | 8 | |
+| HTS_OTST_STPL_QTY | HTS미결제약정수량 | string | Y | 8 | |
+| OTST_STPL_QTY_ICDC | 미결제약정수량증감 | string | Y | 4 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2대비현재가부호 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가2대비현재가 | string | Y | 4 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가대비현재가부호 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 최고가대비현재가 | string | Y | 4 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가대비현재가부호 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 최저가대비현재가 | string | Y | 4 | |
+| SHNU_RATE | 매수2비율 | string | Y | 8 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| ESDG | 괴리도 | string | Y | 8 | |
+| OTST_STPL_RGBF_QTY_ICDC | 미결제약정직전수량증감 | string | Y | 4 | |
+| THPR_BASIS | 이론베이시스 | string | Y | 8 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 4 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 8 | |
+| DYNM_MXPR | 실시간상한가 | string | Y | 4 | |
+| DYNM_LLAM | 실시간하한가 | string | Y | 4 | |
+| DYNM_PRC_LIMT_YN | 실시간가격제한구분 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0ZFCNT0",
+ "tr_key": "111V06"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0ZFCNT0",
+ "tr_key": "111V06",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0ZFCNT0|001|111V06^091639^77900^5^-100^-0.13^77900^77900^77300^5^1724^13
+37128000^77899.50^400.00^0.00^0.00^0.00^-500.00^32053^219^000000^3^0^000000^3^0^000000^2^600^
+0.36^58.23^0.50^-1^399.50^77900^77800^0^0^105^36^-69^1075^626^0^0^6.23^0^0^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/시세분석/132_국내주식-163_회원사-실시간-매매동향틱.md b/docs/broker/kis/websocket/국내주식/시세분석/132_국내주식-163_회원사-실시간-매매동향틱.md
new file mode 100644
index 0000000..6d7c3a5
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/시세분석/132_국내주식-163_회원사-실시간-매매동향틱.md
@@ -0,0 +1,185 @@
+# 회원사 실시간 매매동향(틱)
+
+- 원본 시트명: 회원사 실시간 매매동향(틱)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 시세분석
+- API ID: 국내주식-163
+- HTTP Method: GET
+- 실전 TR_ID: FHPST04320000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/domestic-stock/v1/quotations/frgnmem-trade-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+회원사 실시간 매매동향(틱) API입니다.
+한국투자 HTS(eFriend Plus) > [0432] 회원사 실시간 매매동향 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+최근 100건까지 데이터 조회 가능합니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | FHPST04320000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
+| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
+| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
+| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Request Query Parameter
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J 고정 입력 |
+| FID_COND_SCR_DIV_CODE | 화면분류코드 | string | Y | 5 | 20432(primary key) |
+| FID_INPUT_ISCD | 종목코드 | string | Y | 12 | ex. 005930(삼성전자)
※ FID_INPUT_ISCD(종목코드) 혹은 FID_MRKT_CLS_CODE(시장구분코드) 둘 중 하나만 입력 |
+| FID_INPUT_ISCD_2 | 회원사코드 | string | Y | 10 | ex. 99999(전체)
※ 회원사코드 (kis developers 포탈 사이트 포럼-> FAQ -> 종목정보 다운로드(국내) 참조) |
+| FID_MRKT_CLS_CODE | 시장구분코드 | string | Y | 2 | A(전체),K(코스피), Q(코스닥), K2(코스피200), W(ELW)
※ FID_INPUT_ISCD(종목코드) 혹은 FID_MRKT_CLS_CODE(시장구분코드) 둘 중 하나만 입력 |
+| FID_VOL_CNT | 거래량 | string | Y | 12 | 거래량 ~ |
+
+### Response Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
+| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| rt_cd | 성공 실패 여부 | string | Y | 1 | |
+| msg_cd | 응답코드 | string | Y | 8 | |
+| msg1 | 응답메세지 | string | Y | 80 | |
+| output1 | 응답상세 | object | Y | | array |
+| total_seln_qty | 총매도수량 | string | Y | 18 | |
+| total_shnu_qty | 총매수2수량 | string | Y | 18 | |
+| output2 | 응답상세 | object array | Y | | array |
+| bsop_hour | 영업시간 | string | Y | 6 | |
+| mbcr_name | 회원사명 | string | Y | 50 | |
+| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
+| stck_prpr | 주식현재가 | string | Y | 10 | |
+| prdy_vrss | 전일대비 | string | Y | 10 | |
+| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
+| cntg_vol | 체결거래량 | string | Y | 18 | |
+| acml_ntby_qty | 누적순매수수량 | string | Y | 18 | |
+| glob_ntby_qty | 외국계순매수수량 | string | Y | 12 | |
+| frgn_ntby_qty_icdc | 외국인순매수수량증감 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FID_COND_SCR_DIV_CODE:20432
+FID_INPUT_ISCD:005930
+FID_INPUT_ISCD2:99999
+FID_MRKT_CLS_CODE:
+FID_VOL_CNT:
+```
+
+### Response Example
+
+```text
+{
+ "output1": [
+ {
+ "total_seln_qty": "3403046",
+ "total_shnu_qty": "1539165"
+ }
+ ],
+ "output2": [
+ {
+ "bsop_hour": "153025",
+ "mbcr_name": "JP모간",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75200",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "168484",
+ "acml_ntby_qty": "1473742",
+ "glob_ntby_qty": "-1863881",
+ "frgn_ntby_qty_icdc": "168484"
+ },
+ {
+ "bsop_hour": "153025",
+ "mbcr_name": "메릴린치",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75200",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "-188645",
+ "acml_ntby_qty": "-938293",
+ "glob_ntby_qty": "-2032365",
+ "frgn_ntby_qty_icdc": "-188645"
+ },
+ {
+ "bsop_hour": "153025",
+ "mbcr_name": "씨티그룹",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75200",
+ "prdy_vrss": "-500",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "-135506",
+ "acml_ntby_qty": "-2308688",
+ "glob_ntby_qty": "-1843720",
+ "frgn_ntby_qty_icdc": "-135506"
+ },
+ {
+ "bsop_hour": "152020",
+ "mbcr_name": "JP모간",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75500",
+ "prdy_vrss": "-200",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "139",
+ "acml_ntby_qty": "1305258",
+ "glob_ntby_qty": "-1708214",
+ "frgn_ntby_qty_icdc": "139"
+ },
+ {
+ "bsop_hour": "151904",
+ "mbcr_name": "JP모간",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75400",
+ "prdy_vrss": "-300",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "2271",
+ "acml_ntby_qty": "1305119",
+ "glob_ntby_qty": "-1708353",
+ "frgn_ntby_qty_icdc": "2271"
+ },
+ {
+ "bsop_hour": "151749",
+ "mbcr_name": "JP모간",
+ "hts_kor_isnm": "삼성전자",
+ "stck_prpr": "75300",
+ "prdy_vrss": "-400",
+ "prdy_vrss_sign": "5",
+ "cntg_vol": "23867",
+ "acml_ntby_qty": "1302848",
+ "glob_ntby_qty": "-1710624",
+ "frgn_ntby_qty_icdc": "23867"
+ },...
+ ],
+ "rt_cd": "0",
+ "msg_cd": "MCA00000",
+ "msg1": "정상처리 되었습니다."
+}
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/161_실시간-027_국내지수-실시간예상체결.md b/docs/broker/kis/websocket/국내주식/실시간시세/161_실시간-027_국내지수-실시간예상체결.md
new file mode 100644
index 0000000..bae975b
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/161_실시간-027_국내지수-실시간예상체결.md
@@ -0,0 +1,145 @@
+# 국내지수 실시간예상체결
+
+- 원본 시트명: 국내지수 실시간예상체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-027
+- HTTP Method: POST
+- 실전 TR_ID: H0UPANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UPANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0UPANC0 |
+| tr_key | 종목코드 | string | Y | 6 | 업종구분코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| BSTP_CLS_CODE | 업종 구분 코드 | object | Y | 4 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| PRPR_NMIX | 현재가 지수 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 1 | |
+| BSTP_NMIX_PRDY_VRSS | 업종 지수 전일 대비 | string | Y | 1 | |
+| ACML_VOL | 누적 거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 1 | |
+| PCAS_VOL | 건별 거래량 | string | Y | 1 | |
+| PCAS_TR_PBMN | 건별 거래 대금 | string | Y | 1 | |
+| PRDY_CTRT | 전일 대비율 | string | Y | 1 | |
+| OPRC_NMIX | 시가 지수 | string | Y | 1 | |
+| NMIX_HGPR | 지수 최고가 | string | Y | 1 | |
+| NMIX_LWPR | 지수 최저가 | string | Y | 1 | |
+| OPRC_VRSS_NMIX_PRPR | 시가 대비 지수 현재가 | string | Y | 1 | |
+| OPRC_VRSS_NMIX_SIGN | 시가 대비 지수 부호 | string | Y | 1 | |
+| HGPR_VRSS_NMIX_PRPR | 최고가 대비 지수 현재가 | string | Y | 1 | |
+| HGPR_VRSS_NMIX_SIGN | 최고가 대비 지수 부호 | string | Y | 1 | |
+| LWPR_VRSS_NMIX_PRPR | 최저가 대비 지수 현재가 | string | Y | 1 | |
+| LWPR_VRSS_NMIX_SIGN | 최저가 대비 지수 부호 | string | Y | 1 | |
+| PRDY_CLPR_VRSS_OPRC_RATE | 전일 종가 대비 시가2 비율 | string | Y | 1 | |
+| PRDY_CLPR_VRSS_HGPR_RATE | 전일 종가 대비 최고가 비율 | string | Y | 1 | |
+| PRDY_CLPR_VRSS_LWPR_RATE | 전일 종가 대비 최저가 비율 | string | Y | 1 | |
+| UPLM_ISSU_CNT | 상한 종목 수 | string | Y | 1 | |
+| ASCN_ISSU_CNT | 상승 종목 수 | string | Y | 1 | |
+| STNR_ISSU_CNT | 보합 종목 수 | string | Y | 1 | |
+| DOWN_ISSU_CNT | 하락 종목 수 | string | Y | 1 | |
+| LSLM_ISSU_CNT | 하한 종목 수 | string | Y | 1 | |
+| QTQT_ASCN_ISSU_CNT | 기세 상승 종목수 | string | Y | 1 | |
+| QTQT_DOWN_ISSU_CNT | 기세 하락 종목수 | string | Y | 1 | |
+| TICK_VRSS | TICK대비 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0UPANC0",
+ "tr_key": "0001"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0UPANC0",
+ "tr_key": "0001",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0UPANC0|001|0001^085910^2607.71^2^15.85^5424^192338^5424^192338^0.61^0^43
+9^201^251^201
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/163_국내주식-실시간회원사-NXT_국내주식-실시간회원사-NXT.md b/docs/broker/kis/websocket/국내주식/실시간시세/163_국내주식-실시간회원사-NXT_국내주식-실시간회원사-NXT.md
new file mode 100644
index 0000000..8ac235f
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/163_국내주식-실시간회원사-NXT_국내주식-실시간회원사-NXT.md
@@ -0,0 +1,128 @@
+# 국내주식 실시간회원사 (NXT)
+
+- 원본 시트명: 국내주식 실시간회원사 (NXT)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간회원사 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXMBC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXMBC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXMBC0 : 국내주식 주식종목회원사 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| SELN2_MBCR_NAME1 | 매도2 회원사명1 | string | Y | 16 | |
+| SELN2_MBCR_NAME2 | 매도2 회원사명2 | string | Y | 16 | |
+| SELN2_MBCR_NAME3 | 매도2 회원사명3 | string | Y | 16 | |
+| SELN2_MBCR_NAME4 | 매도2 회원사명4 | string | Y | 16 | |
+| SELN2_MBCR_NAME5 | 매도2 회원사명5 | string | Y | 16 | |
+| BYOV_MBCR_NAME1 | 매수 회원사명1 | string | Y | 16 | |
+| BYOV_MBCR_NAME2 | 매수 회원사명2 | string | Y | 16 | |
+| BYOV_MBCR_NAME3 | 매수 회원사명3 | string | Y | 16 | |
+| BYOV_MBCR_NAME4 | 매수 회원사명4 | string | Y | 16 | |
+| BYOV_MBCR_NAME5 | 매수 회원사명5 | string | Y | 16 | |
+| TOTAL_SELN_QTY1 | 총 매도 수량1 | string | Y | 8 | |
+| TOTAL_SELN_QTY2 | 총 매도 수량2 | string | Y | 8 | |
+| TOTAL_SELN_QTY3 | 총 매도 수량3 | string | Y | 8 | |
+| TOTAL_SELN_QTY4 | 총 매도 수량4 | string | Y | 8 | |
+| TOTAL_SELN_QTY5 | 총 매도 수량5 | string | Y | 8 | |
+| TOTAL_SHNU_QTY1 | 총 매수2 수량1 | string | Y | 8 | |
+| TOTAL_SHNU_QTY2 | 총 매수2 수량2 | string | Y | 8 | |
+| TOTAL_SHNU_QTY3 | 총 매수2 수량3 | string | Y | 8 | |
+| TOTAL_SHNU_QTY4 | 총 매수2 수량4 | string | Y | 8 | |
+| TOTAL_SHNU_QTY5 | 총 매수2 수량5 | string | Y | 8 | |
+| SELN_MBCR_GLOB_YN_1 | 매도거래원구분1 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_2 | 매도거래원구분2 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_3 | 매도거래원구분3 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_4 | 매도거래원구분4 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_5 | 매도거래원구분5 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_1 | 매수거래원구분1 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_2 | 매수거래원구분2 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_3 | 매수거래원구분3 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_4 | 매수거래원구분4 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_5 | 매수거래원구분5 | string | Y | 1 | |
+| SELN_MBCR_NO1 | 매도거래원코드1 | string | Y | 5 | |
+| SELN_MBCR_NO2 | 매도거래원코드2 | string | Y | 5 | |
+| SELN_MBCR_NO3 | 매도거래원코드3 | string | Y | 5 | |
+| SELN_MBCR_NO4 | 매도거래원코드4 | string | Y | 5 | |
+| SELN_MBCR_NO5 | 매도거래원코드5 | string | Y | 5 | |
+| SHNU_MBCR_NO1 | 매수거래원코드1 | string | Y | 5 | |
+| SHNU_MBCR_NO2 | 매수거래원코드2 | string | Y | 5 | |
+| SHNU_MBCR_NO3 | 매수거래원코드3 | string | Y | 5 | |
+| SHNU_MBCR_NO4 | 매수거래원코드4 | string | Y | 5 | |
+| SHNU_MBCR_NO5 | 매수거래원코드5 | string | Y | 5 | |
+| SELN_MBCR_RLIM1 | 매도 회원사 비중1 | string | Y | 8 | |
+| SELN_MBCR_RLIM2 | 매도 회원사 비중2 | string | Y | 8 | |
+| SELN_MBCR_RLIM3 | 매도 회원사 비중3 | string | Y | 8 | |
+| SELN_MBCR_RLIM4 | 매도 회원사 비중4 | string | Y | 8 | |
+| SELN_MBCR_RLIM5 | 매도 회원사 비중5 | string | Y | 8 | |
+| SHNU_MBCR_RLIM1 | 매수2 회원사 비중1 | string | Y | 8 | |
+| SHNU_MBCR_RLIM2 | 매수2 회원사 비중2 | string | Y | 8 | |
+| SHNU_MBCR_RLIM3 | 매수2 회원사 비중3 | string | Y | 8 | |
+| SHNU_MBCR_RLIM4 | 매수2 회원사 비중4 | string | Y | 8 | |
+| SHNU_MBCR_RLIM5 | 매수2 회원사 비중5 | string | Y | 8 | |
+| SELN_QTY_ICDC1 | 매도 수량 증감1 | string | Y | 4 | |
+| SELN_QTY_ICDC2 | 매도 수량 증감2 | string | Y | 4 | |
+| SELN_QTY_ICDC3 | 매도 수량 증감3 | string | Y | 4 | |
+| SELN_QTY_ICDC4 | 매도 수량 증감4 | string | Y | 4 | |
+| SELN_QTY_ICDC5 | 매도 수량 증감5 | string | Y | 4 | |
+| SHNU_QTY_ICDC1 | 매수2 수량 증감1 | string | Y | 4 | |
+| SHNU_QTY_ICDC2 | 매수2 수량 증감2 | string | Y | 4 | |
+| SHNU_QTY_ICDC3 | 매수2 수량 증감3 | string | Y | 4 | |
+| SHNU_QTY_ICDC4 | 매수2 수량 증감4 | string | Y | 4 | |
+| SHNU_QTY_ICDC5 | 매수2 수량 증감5 | string | Y | 4 | |
+| GLOB_TOTAL_SELN_QTY | 외국계 총 매도 수량 | string | Y | 8 | |
+| GLOB_TOTAL_SHNU_QTY | 외국계 총 매수2 수량 | string | Y | 8 | |
+| GLOB_TOTAL_SELN_QTY_ICDC | 외국계 총 매도 수량 증감 | string | Y | 4 | |
+| GLOB_TOTAL_SHNU_QTY_ICDC | 외국계 총 매수2 수량 증감 | string | Y | 4 | |
+| GLOB_NTBY_QTY | 외국계 순매수 수량 | string | Y | 8 | |
+| GLOB_SELN_RLIM | 외국계 매도 비중 | string | Y | 8 | |
+| GLOB_SHNU_RLIM | 외국계 매수2 비중 | string | Y | 8 | |
+| SELN2_MBCR_ENG_NAME1 | 매도2 영문회원사명1 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME2 | 매도2 영문회원사명2 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME3 | 매도2 영문회원사명3 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME4 | 매도2 영문회원사명4 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME5 | 매도2 영문회원사명5 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME1 | 매수 영문회원사명1 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME2 | 매수 영문회원사명2 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME3 | 매수 영문회원사명3 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME4 | 매수 영문회원사명4 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME5 | 매수 영문회원사명5 | string | Y | 20 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/164_실시간-005_국내주식-실시간체결통보.md b/docs/broker/kis/websocket/국내주식/실시간시세/164_실시간-005_국내주식-실시간체결통보.md
new file mode 100644
index 0000000..75a41c1
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/164_실시간-005_국내주식-실시간체결통보.md
@@ -0,0 +1,150 @@
+# 국내주식 실시간체결통보
+
+- 원본 시트명: 국내주식 실시간체결통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-005
+- HTTP Method: POST
+- 실전 TR_ID: H0STCNI0
+- 모의 TR_ID: H0STCNI9
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: ws://ops.koreainvestment.com:31000
+- URL 명: /tryitout/H0STCNI0
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 실시간 체결통보 수신 시에 (1) 주문·정정·취소·거부 접수 통보 와 (2) 체결 통보 가 모두 수신됩니다.
+(14번째 값(CNTG_YN;체결여부)가 2이면 체결통보, 1이면 주문·정정·취소·거부 접수 통보입니다.)
+
+※ 모의투자는 H0STCNI9 로 변경하여 사용합니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id
+- 데이터 건수 : (ex. 001 데이터 건수를 참조하여 활용)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+체결 통보 응답 결과는 암호화되어 출력됩니다. AES256 KEY IV를 활용해 복호화하여 활용하세요. 자세한 예제는 [도구>wikidocs]에 준비되어 있습니다.
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | N | 1 | 1: 등록 2 : 해제 |
+| content-type | 컨텐츠타입 | string | N | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | '[실전/모의투자]
H0STCNI0 : 국내주식 실시간체결통보
H0STCNI9 : 모의투자 실시간 체결통보 |
+| tr_key | 구분값 | string | Y | 12 | HTS ID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CUST_ID | 고객 ID | string | Y | 8 | |
+| ACNT_NO | 계좌번호 | string | Y | 10 | |
+| ODER_NO | 주문번호 | string | Y | 10 | |
+| OODER_NO | 원주문번호 | string | Y | 10 | |
+| SELN_BYOV_CLS | 매도매수구분 | string | Y | 2 | 01 : 매도
02 : 매수 |
+| RCTF_CLS | 정정구분 | string | Y | 1 | 0:정상
1:정정
2:취소 |
+| ODER_KIND | 주문종류 | string | Y | 2 | [KRX]
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[NXT]
00 : 지정가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
21 : 중간가
22 : 스톱지정가
23 : 중간가IOC
24 : 중간가FOK
[SOR]
00 : 지정가
01 : 시장가
03 : 최유리지정가
04 : 최우선지정가
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소) |
+| ODER_COND | 주문조건 | string | Y | 1 | 0:없음
1:IOC
2:FOK |
+| STCK_SHRN_ISCD | 주식 단축 종목코드 | string | Y | 9 | |
+| CNTG_QTY | 체결 수량 | string | Y | 10 | |
+| CNTG_UNPR | 체결단가 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| RFUS_YN | 거부여부 | string | Y | 1 | 0 : 승인
1 : 거부 |
+| CNTG_YN | 체결여부 | string | Y | 1 | 1 : 주문,정정,취소,거부
2 : 체결 |
+| ACPT_YN | 접수여부 | string | Y | 1 | 1 : 주문접수
2 : 확인
3 : 취소(FOK/IOC) |
+| BRNC_NO | 지점번호 | string | Y | 5 | |
+| ODER_QTY | 주문수량 | string | Y | 9 | |
+| ACNT_NAME | 계좌명 | string | Y | 12 | |
+| ORD_COND_PRC | 호가조건가격 | string | Y | 9 | 스톱지정가 시 표시 |
+| ORD_EXG_GB | 주문거래소 구분 | string | Y | 1 | 1:KRX, 2:NXT, 3:SOR-KRX, 4:SOR-NXT |
+| POPUP_YN | 실시간체결창 표시여부 | string | Y | 1 | Y/N |
+| FILLER | 필러 | string | Y | 3 | |
+| CRDT_CLS | 신용구분 | string | Y | 2 | |
+| CRDT_LOAN_DATE | 신용대출일자 | string | Y | 8 | |
+| CNTG_ISNM40 | 체결종목명 | string | Y | 40 | |
+| ODER_PRC | 주문가격 | string | Y | 9 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STCNI0",
+ "tr_key":"HTS ID"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+{
+ "header": {
+ "tr_id": "H0STCNI0",
+ "tr_key": "HTS ID",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output - 주문·정정·취소·거부 접수 통보
+HTS ID^1234567801^0000002891^^02^0^01^0^136480^0000000001^000000000^094941^0
+^1^1^06010^000000001^김한투^하림^10^^하림^
+
+# output - 체결 통보
+HTS ID^1234567801^0000002891^^02^0^00^0^136480^0000000001^000003190^094941^0
+^2^2^06010^000000001^김한투^하림^10^^하림^000000000
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/165_실시간-024_국내주식-시간외-실시간예상체결-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/165_실시간-024_국내주식-시간외-실시간예상체결-KRX.md
new file mode 100644
index 0000000..bc654c9
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/165_실시간-024_국내주식-시간외-실시간예상체결-KRX.md
@@ -0,0 +1,166 @@
+# 국내주식 시간외 실시간예상체결 (KRX)
+
+- 원본 시트명: 국내주식 시간외 실시간예상체결 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-024
+- HTTP Method: POST
+- 실전 TR_ID: H0STOAC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STOAC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외 실시간예상체결 API입니다.
+국내주식 시간외 단일가(16:00~18:00) 시간대에 실시간예상체결 데이터 확인 가능합니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0STOAC0 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일대비구분 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 1 | |
+| PRDY_CTRT | 등락율 | string | Y | 1 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 1 | |
+| STCK_OPRC | 시가 | string | Y | 1 | |
+| STCK_HGPR | 고가 | string | Y | 1 | |
+| STCK_LWPR | 저가 | string | Y | 1 | |
+| ASKP1 | 매도호가 | string | Y | 1 | |
+| BIDP1 | 매수호가 | string | Y | 1 | |
+| CNTG_VOL | 거래량 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 1 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 1 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 1 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 1 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 1 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 1 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 1 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STOAC0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STOAC0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STOAC0|001|005930^164128^77700^2^100^0.13^78209.85^77600^77800^77
+600^77800^77700^82^82^6371400^2^2^0^71.12^6995^5511^1^0.38^69.15^161015^3^100^162004^5^
+-100^161015^3^100^20240503^49^N^71160^6882^24644^30955^0.00^0^0.00
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/166_실시간-025_국내주식-시간외-실시간호가-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/166_실시간-025_국내주식-시간외-실시간호가-KRX.md
new file mode 100644
index 0000000..f85b49a
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/166_실시간-025_국내주식-시간외-실시간호가-KRX.md
@@ -0,0 +1,177 @@
+# 국내주식 시간외 실시간호가 (KRX)
+
+- 원본 시트명: 국내주식 시간외 실시간호가 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-025
+- HTTP Method: POST
+- 실전 TR_ID: H0STOAA0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STOAA0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외 실시간호가 API입니다.
+국내주식 시간외 단일가(16:00~18:00) 시간대에 실시간호가 데이터 확인 가능합니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0STOAA0 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| HOUR_CLS_CODE | 시간구분코드 | string | Y | 1 | |
+| ASKP1 | 매도호가1 | string | Y | 1 | |
+| ASKP2 | 매도호가2 | string | Y | 1 | |
+| ASKP3 | 매도호가3 | string | Y | 1 | |
+| ASKP4 | 매도호가4 | string | Y | 1 | |
+| ASKP5 | 매도호가5 | string | Y | 1 | |
+| ASKP6 | 매도호가6 | string | Y | 1 | |
+| ASKP7 | 매도호가7 | string | Y | 1 | |
+| ASKP8 | 매도호가8 | string | Y | 1 | |
+| ASKP9 | 매도호가9 | string | Y | 1 | |
+| BIDP1 | 매수호가1 | string | Y | 1 | |
+| BIDP2 | 매수호가2 | string | Y | 1 | |
+| BIDP3 | 매수호가3 | string | Y | 1 | |
+| BIDP4 | 매수호가4 | string | Y | 1 | |
+| BIDP5 | 매수호가5 | string | Y | 1 | |
+| BIDP6 | 매수호가6 | string | Y | 1 | |
+| BIDP7 | 매수호가7 | string | Y | 1 | |
+| BIDP8 | 매수호가8 | string | Y | 1 | |
+| BIDP9 | 매수호가9 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 1 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 1 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 1 | |
+| ASKP_RSQN5 | 매도호가잔량5 | string | Y | 1 | |
+| ASKP_RSQN6 | 매도호가잔량6 | string | Y | 1 | |
+| ASKP_RSQN7 | 매도호가잔량7 | string | Y | 1 | |
+| ASKP_RSQN8 | 매도호가잔량8 | string | Y | 1 | |
+| ASKP_RSQN9 | 매도호가잔량9 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 1 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 1 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 1 | |
+| BIDP_RSQN5 | 매수호가잔량5 | string | Y | 1 | |
+| BIDP_RSQN6 | 매수호가잔량6 | string | Y | 1 | |
+| BIDP_RSQN7 | 매수호가잔량7 | string | Y | 1 | |
+| BIDP_RSQN8 | 매수호가잔량8 | string | Y | 1 | |
+| BIDP_RSQN9 | 매수호가잔량9 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| OVTM_TOTAL_ASKP_RSQN | 시간외총매도호가잔량 | string | Y | 1 | |
+| OVTM_TOTAL_BIDP_RSQN | 시간외총매수호가잔량 | string | Y | 1 | |
+| ANTC_CNPR | 예상체결가 | string | Y | 1 | |
+| ANTC_CNQN | 예상체결량 | string | Y | 1 | |
+| ANTC_VOL | 예상거래량 | string | Y | 1 | |
+| ANTC_CNTG_VRSS | 예상체결대비 | string | Y | 1 | |
+| ANTC_CNTG_VRSS_SIGN | 예상체결대비부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상체결전일대비율 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN_ICDC | 총매도호가잔량증감 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN_ICDC | 총매수호가잔량증감 | string | Y | 1 | |
+| OVTM_TOTAL_ASKP_ICDC | 시간외총매도호가증감 | string | Y | 1 | |
+| OVTM_TOTAL_BIDP_ICDC | 시간외총매수호가증감 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STOAA0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STOAA0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STOAA0|001|005930^164128^B^77800^77900^78000^0^0^0^0^0^0^0^77700^
+77600^77500^0^0^0^0^0^0^0^8005^7355^9284^0^0^0^0^0^0^0^4^16654^14297^0^0^0^0^0^0^0^2464
+4^30955^0^37426^77700^82^82^100^2^0.13^13069425^-1^0^0^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/167_국내주식-실시간프로그램매매-통합_국내주식-실시간프로그램매매-통합.md b/docs/broker/kis/websocket/국내주식/실시간시세/167_국내주식-실시간프로그램매매-통합_국내주식-실시간프로그램매매-통합.md
new file mode 100644
index 0000000..0caaedb
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/167_국내주식-실시간프로그램매매-통합_국내주식-실시간프로그램매매-통합.md
@@ -0,0 +1,61 @@
+# 국내주식 실시간프로그램매매 (통합)
+
+- 원본 시트명: 국내주식 실시간프로그램매매 (통합)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간프로그램매매 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNPGM0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNPGM0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0UNPGM0 : 실시간 주식종목프로그램매매 통합 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| SELN_CNQN | 매도 체결량 | string | Y | 8 | |
+| SELN_TR_PBMN | 매도 거래 대금 | string | Y | 8 | |
+| SHNU_CNQN | 매수2 체결량 | string | Y | 8 | |
+| SHNU_TR_PBMN | 매수2 거래 대금 | string | Y | 8 | |
+| NTBY_CNQN | 순매수 체결량 | string | Y | 8 | |
+| NTBY_TR_PBMN | 순매수 거래 대금 | string | Y | 8 | |
+| SELN_RSQN | 매도호가잔량 | string | Y | 8 | |
+| SHNU_RSQN | 매수호가잔량 | string | Y | 8 | |
+| WHOL_NTBY_QTY | 전체순매수호가잔량 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/168_국내주식-실시간호가-통합_국내주식-실시간호가-통합.md b/docs/broker/kis/websocket/국내주식/실시간시세/168_국내주식-실시간호가-통합_국내주식-실시간호가-통합.md
new file mode 100644
index 0000000..a4f10f8
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/168_국내주식-실시간호가-통합_국내주식-실시간호가-통합.md
@@ -0,0 +1,115 @@
+# 국내주식 실시간호가 (통합)
+
+- 원본 시트명: 국내주식 실시간호가 (통합)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간호가 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0UNASP0 : 실시간 주식 체결가 통합 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| ASKP2 | 매도호가2 | string | Y | 4 | |
+| ASKP3 | 매도호가3 | string | Y | 4 | |
+| ASKP4 | 매도호가4 | string | Y | 4 | |
+| ASKP5 | 매도호가5 | string | Y | 4 | |
+| ASKP6 | 매도호가6 | string | Y | 4 | |
+| ASKP7 | 매도호가7 | string | Y | 4 | |
+| ASKP8 | 매도호가8 | string | Y | 4 | |
+| ASKP9 | 매도호가9 | string | Y | 4 | |
+| ASKP10 | 매도호가10 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| BIDP2 | 매수호가2 | string | Y | 4 | |
+| BIDP3 | 매수호가3 | string | Y | 4 | |
+| BIDP4 | 매수호가4 | string | Y | 4 | |
+| BIDP5 | 매수호가5 | string | Y | 4 | |
+| BIDP6 | 매수호가6 | string | Y | 4 | |
+| BIDP7 | 매수호가7 | string | Y | 4 | |
+| BIDP8 | 매수호가8 | string | Y | 4 | |
+| BIDP9 | 매수호가9 | string | Y | 4 | |
+| BIDP10 | 매수호가10 | string | Y | 4 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| ASKP_RSQN6 | 매도호가 잔량6 | string | Y | 8 | |
+| ASKP_RSQN7 | 매도호가 잔량7 | string | Y | 8 | |
+| ASKP_RSQN8 | 매도호가 잔량8 | string | Y | 8 | |
+| ASKP_RSQN9 | 매도호가 잔량9 | string | Y | 8 | |
+| ASKP_RSQN10 | 매도호가 잔량10 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN6 | 매수호가 잔량6 | string | Y | 8 | |
+| BIDP_RSQN7 | 매수호가 잔량7 | string | Y | 8 | |
+| BIDP_RSQN8 | 매수호가 잔량8 | string | Y | 8 | |
+| BIDP_RSQN9 | 매수호가 잔량9 | string | Y | 8 | |
+| BIDP_RSQN10 | 매수호가 잔량10 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| OVTM_TOTAL_ASKP_RSQN | 시간외 총 매도호가 잔량 | string | Y | 8 | |
+| OVTM_TOTAL_BIDP_RSQN | 시간외 총 매수호가 잔량 | string | Y | 8 | |
+| ANTC_CNPR | 예상 체결가 | string | Y | 4 | |
+| ANTC_CNQN | 예상 체결량 | string | Y | 8 | |
+| ANTC_VOL | 예상 거래량 | string | Y | 8 | |
+| ANTC_CNTG_VRSS | 예상 체결 대비 | string | Y | 4 | |
+| ANTC_CNTG_VRSS_SIGN | 예상 체결 대비 부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상 체결 전일 대비율 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 4 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 4 | |
+| OVTM_TOTAL_ASKP_ICDC | 시간외 총 매도호가 증감 | string | Y | 4 | |
+| OVTM_TOTAL_BIDP_ICDC | 시간외 총 매수호가 증감 | string | Y | 4 | |
+| STCK_DEAL_CLS_CODE | 주식 매매 구분 코드 | string | Y | 2 | |
+| KMID_PRC | KRX 중간가 | string | Y | 4 | |
+| KMID_TOTAL_RSQN | KRX 중간가잔량합계수량 | string | Y | 8 | |
+| KMID_CLS_CODE | KRX 중간가 매수매도 구분 | string | Y | 1 | |
+| NMID_PRC | NXT 중간가 | string | Y | 4 | |
+| NMID_TOTAL_RSQN | NXT 중간가잔량합계수량 | string | Y | 8 | |
+| NMID_CLS_CODE | NXT 중간가 매수매도 구분 | string | Y | 1 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/169_실시간-048_국내주식-실시간프로그램매매-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/169_실시간-048_국내주식-실시간프로그램매매-KRX.md
new file mode 100644
index 0000000..17b3f03
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/169_실시간-048_국내주식-실시간프로그램매매-KRX.md
@@ -0,0 +1,126 @@
+# 국내주식 실시간프로그램매매 (KRX)
+
+- 원본 시트명: 국내주식 실시간프로그램매매 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-048
+- HTTP Method: POST
+- 실전 TR_ID: H0STPGM0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STPGM0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0STPGM0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| SELN_CNQN | 매도체결량 | string | Y | 1 | |
+| SELN_TR_PBMN | 매도거래대금 | string | Y | 1 | |
+| SHNU_CNQN | 매수2체결량 | string | Y | 1 | |
+| SHNU_TR_PBMN | 매수2거래대금 | string | Y | 1 | |
+| NTBY_CNQN | 순매수체결량 | string | Y | 1 | |
+| NTBY_TR_PBMN | 순매수거래대금 | string | Y | 1 | |
+| SELN_RSQN | 매도호가잔량 | string | Y | 1 | |
+| SHNU_RSQN | 매수호가잔량 | string | Y | 1 | |
+| WHOL_NTBY_QTY | 전체순매수호가잔량 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0STPGM0",
+ "tr_key": "005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STPGM0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STPGM0|001|005930^092237^1413444^109159646900^1189408^91931710200^-2240
+36^-17227936700^65033^15475^-49558
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/170_실시간-049_국내주식-장운영정보-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/170_실시간-049_국내주식-장운영정보-KRX.md
new file mode 100644
index 0000000..e49d367
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/170_실시간-049_국내주식-장운영정보-KRX.md
@@ -0,0 +1,127 @@
+# 국내주식 장운영정보 (KRX)
+
+- 원본 시트명: 국내주식 장운영정보 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-049
+- HTTP Method: POST
+- 실전 TR_ID: H0STMKO0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STMKO0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 장운영정보 연결 시, 연결종목의 VI 발동 시와 VI 해제 시에 데이터 수신됩니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0STMKO0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| TR_SUSP_REAS_CNTT | 거래정지사유내용 | string | Y | 100 | |
+| MKOP_CLS_CODE | 장운영구분코드 | string | Y | 3 | 110 장전 동시호가 개시
112 장개시
121 장후 동시호가 개시
129 장마감
130 장개시전시간외개시
139 장개시전시간외종료
140 시간외 종가 매매 개시
146 장종료후시간외 체결지시
149 시간외 종가 매매 종료
150 시간외 단일가 매매 개시
156 시간외단일가 체결지시
159 시간외 단일가 매매 종료
164 시장임시정지
174 서킷브레이크 발동
175 서킷브레이크 해제
182 서킷브레이크 장중동시마감
184 서킷브레이크 개시
185 서킷브레이크 해제
387 사이드카 매도발동
388 사이드카 매도발동해제
397 사이드카 매수발동
398 사이드카 매수발동해제
??? 단일가개시
??? 서킷브레이크 단일가접수
F01 장개시 10초전
F06 장개시 1분전
F07 장개시 5분전
F08 장개시 10분전
F09 장개시 3분전
F11 장마감 10초전
F16 장마감 1분전
F17 장마감 5분전
F18 장마감 3분전
P01 장개시 10초전
P06 장개시 1분전
P07 장개시 5분전
P08 장개시 10분전
P09 장개시 30분전
P11 장마감 10초전
P16 장마감 1분전
P17 장마감 5분전
P18 장마감 3분전 |
+| ANTC_MKOP_CLS_CODE | 예상장운영구분코드 | string | Y | 3 | 112 장전예상종료
121 장후예상시작
129 장후예상종료
311 장전예상시작 |
+| MRKT_TRTM_CLS_CODE | 임의연장구분코드 | string | Y | 1 | 1 시초동시 임의종료 지정
2 시초동시 임의종료 해제
3 마감동시 임의종료 지정
4 마감동시 임의종료 해제
5 시간외단일가임의종료 지정
6 시간외단일가임의종료 해제 |
+| DIVI_APP_CLS_CODE | 동시호가배분처리구분코드 | string | Y | 2 | divi_app_cls_code[0] 1: 배분개시 2: 배분해제
divi_app_cls_code[1] 1: 매수상한 2: 매수하한 3: 매도상한 4: 매도하한 |
+| ISCD_STAT_CLS_CODE | 종목상태구분코드 | string | Y | 2 | 51 관리종목 지정 종목
52 시장경고 구분이 '투자위험'인 종목
53 시장경고 구분이 '투자경고'인 종목
54 시장경고 구분이 '투자주의'인 종목
55 당사 신용가능 종목
57 당사 증거금률이 100인 종목
58 거래정지 지정된 종목
59 단기과열종목으로 지정되거나 지정 연장된 종목
00 그 외 종목 |
+| VI_CLS_CODE | VI적용구분코드 | string | Y | 1 | Y VI적용된 종목
N VI적용되지 않은 종목 |
+| OVTM_VI_CLS_CODE | 시간외단일가VI적용구분코드 | string | Y | 1 | Y 시간외단일가VI 적용된 종목
N 시간외단일가VI 적용되지 않은 종목 |
+| EXCH_CLS_CODE | 거래소구분코드 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0STMKO0",
+ "tr_key": "396300"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STMKO0",
+ "tr_key": "396300",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STMKO0|001|396300^N^(null)^^311^^^55^N^N
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/171_실시간-003_국내주식-실시간체결가-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/171_실시간-003_국내주식-실시간체결가-KRX.md
new file mode 100644
index 0000000..27e9b72
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/171_실시간-003_국내주식-실시간체결가-KRX.md
@@ -0,0 +1,169 @@
+# 국내주식 실시간체결가 (KRX)
+
+- 원본 시트명: 국내주식 실시간체결가 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-003
+- HTTP Method: POST
+- 실전 TR_ID: H0STCNT0
+- 모의 TR_ID: H0STCNT0
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: ws://ops.koreainvestment.com:31000
+- URL 명: /tryitout/H0STCNT0
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+※ 데이터가 많은 경우 여러 건을 페이징 처리해서 데이터를 보내는 점 참고 부탁드립니다.
+ex) 0|H0STCNT0|004|... 인 경우 004가 데이터 개수를 의미하여, 뒤에 체결데이터가 4건 들어옴
+→ 0|H0STCNT0|004|005930^123929...(체결데이터1)...^005930^123929...(체결데이터2)...^005930^123929...(체결데이터3)...^005930^123929...(체결데이터4)...
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | Y | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | Y | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 1 | [실전/모의투자]
H0STCNT0 : 실시간 주식 체결가 |
+| tr_key | 구분값 | string | Y | 1 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| STCK_PRPR | 주식 현재가 | number | Y | 4 | 체결가격 |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| PRDY_VRSS | 전일 대비 | number | Y | 4 | |
+| PRDY_CTRT | 전일 대비율 | number | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중 평균 주식 가격 | number | Y | 8 | |
+| STCK_OPRC | 주식 시가 | number | Y | 4 | |
+| STCK_HGPR | 주식 최고가 | number | Y | 4 | |
+| STCK_LWPR | 주식 최저가 | number | Y | 4 | |
+| ASKP1 | 매도호가1 | number | Y | 4 | |
+| BIDP1 | 매수호가1 | number | Y | 4 | |
+| CNTG_VOL | 체결 거래량 | number | Y | 8 | |
+| ACML_VOL | 누적 거래량 | number | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | number | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | number | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | number | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | number | Y | 4 | |
+| CTTR | 체결강도 | number | Y | 8 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | number | Y | 8 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | number | Y | 8 | |
+| CCLD_DVSN | 체결구분 | string | Y | 1 | 1:매수(+)
3:장전
5:매도(-) |
+| SHNU_RATE | 매수비율 | number | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | number | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| OPRC_VRSS_PRPR | 시가대비 | number | Y | 4 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| HGPR_VRSS_PRPR | 고가대비 | number | Y | 4 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| LWPR_VRSS_PRPR | 저가대비 | number | Y | 4 | |
+| BSOP_DATE | 영업 일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신 장운영 구분 코드 | string | Y | 2 | (1) 첫 번째 비트
1 : 장개시전
2 : 장중
3 : 장종료후
4 : 시간외단일가
7 : 일반Buy-in
8 : 당일Buy-in
(2) 두 번째 비트
0 : 보통
1 : 종가
2 : 대량
3 : 바스켓
7 : 정리매매
8 : Buy-in |
+| TRHT_YN | 거래정지 여부 | string | Y | 1 | Y : 정지
N : 정상거래 |
+| ASKP_RSQN1 | 매도호가 잔량1 | number | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | number | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | number | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | number | Y | 8 | |
+| VOL_TNRT | 거래량 회전율 | number | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일 동시간 누적 거래량 | number | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일 동시간 누적 거래량 비율 | number | Y | 8 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | 0 : 장중
A : 장후예상
B : 장전예상
C : 9시이후의 예상가, VI발동
D : 시간외 단일가 예상 |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+| VI_STND_PRC | 정적VI발동기준가 | number | Y | 4 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STCNT0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STCNT0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+005930^093354^71900^5^-100^-0.14^72023.83^72100^72400^71700^71900^71800^1^3052
+507^219853241700^5105^6937^1832^84.90^1366314^1159996^1^0.39^20.28^090020^5^-2
+00^090820^5^-500^092619^2^200^20230612^20^N^65945^216924^1118750^2199206^0.05^
+2424142^125.92^0^^72100
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/172_실시간-028_국내지수-실시간프로그램매매.md b/docs/broker/kis/websocket/국내주식/실시간시세/172_실시간-028_국내지수-실시간프로그램매매.md
new file mode 100644
index 0000000..6c4b16b
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/172_실시간-028_국내지수-실시간프로그램매매.md
@@ -0,0 +1,205 @@
+# 국내지수 실시간프로그램매매
+
+- 원본 시트명: 국내지수 실시간프로그램매매
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-028
+- HTTP Method: POST
+- 실전 TR_ID: H0UPPGM0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UPPGM0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0UPPGM0 |
+| tr_key | 종목코드 | string | Y | 6 | 업종구분코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| BSTP_CLS_CODE | 업종 구분 코드 | object | Y | 4 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| ARBT_SELN_ENTM_CNQN | 차익 매도 위탁 체결량 | string | Y | 1 | |
+| ARBT_SELN_ONSL_CNQN | 차익 매도 자기 체결량 | string | Y | 1 | |
+| ARBT_SHNU_ENTM_CNQN | 차익 매수2 위탁 체결량 | string | Y | 1 | |
+| ARBT_SHNU_ONSL_CNQN | 차익 매수2 자기 체결량 | string | Y | 1 | |
+| NABT_SELN_ENTM_CNQN | 비차익 매도 위탁 체결량 | string | Y | 1 | |
+| NABT_SELN_ONSL_CNQN | 비차익 매도 자기 체결량 | string | Y | 1 | |
+| NABT_SHNU_ENTM_CNQN | 비차익 매수2 위탁 체결량 | string | Y | 1 | |
+| NABT_SHNU_ONSL_CNQN | 비차익 매수2 자기 체결량 | string | Y | 1 | |
+| ARBT_SELN_ENTM_CNTG_AMT | 차익 매도 위탁 체결 금액 | string | Y | 1 | |
+| ARBT_SELN_ONSL_CNTG_AMT | 차익 매도 자기 체결 금액 | string | Y | 1 | |
+| ARBT_SHNU_ENTM_CNTG_AMT | 차익 매수2 위탁 체결 금액 | string | Y | 1 | |
+| ARBT_SHNU_ONSL_CNTG_AMT | 차익 매수2 자기 체결 금액 | string | Y | 1 | |
+| NABT_SELN_ENTM_CNTG_AMT | 비차익 매도 위탁 체결 금액 | string | Y | 1 | |
+| NABT_SELN_ONSL_CNTG_AMT | 비차익 매도 자기 체결 금액 | string | Y | 1 | |
+| NABT_SHNU_ENTM_CNTG_AMT | 비차익 매수2 위탁 체결 금액 | string | Y | 1 | |
+| NABT_SHNU_ONSL_CNTG_AMT | 비차익 매수2 자기 체결 금액 | string | Y | 1 | |
+| ARBT_SMTN_SELN_VOL | 차익 합계 매도 거래량 | string | Y | 1 | |
+| ARBT_SMTM_SELN_VOL_RATE | 차익 합계 매도 거래량 비율 | string | Y | 1 | |
+| ARBT_SMTN_SELN_TR_PBMN | 차익 합계 매도 거래 대금 | string | Y | 1 | |
+| ARBT_SMTM_SELN_TR_PBMN_RATE | 차익 합계 매도 거래대금 비율 | string | Y | 1 | |
+| ARBT_SMTN_SHNU_VOL | 차익 합계 매수2 거래량 | string | Y | 1 | |
+| ARBT_SMTM_SHNU_VOL_RATE | 차익 합계 매수 거래량 비율 | string | Y | 1 | |
+| ARBT_SMTN_SHNU_TR_PBMN | 차익 합계 매수2 거래 대금 | string | Y | 1 | |
+| ARBT_SMTM_SHNU_TR_PBMN_RATE | 차익 합계 매수 거래대금 비율 | string | Y | 1 | |
+| ARBT_SMTN_NTBY_QTY | 차익 합계 순매수 수량 | string | Y | 1 | |
+| ARBT_SMTM_NTBY_QTY_RATE | 차익 합계 순매수 수량 비율 | string | Y | 1 | |
+| ARBT_SMTN_NTBY_TR_PBMN | 차익 합계 순매수 거래 대금 | string | Y | 1 | |
+| ARBT_SMTM_NTBY_TR_PBMN_RATE | 차익 합계 순매수 거래대금 비율 | string | Y | 1 | |
+| NABT_SMTN_SELN_VOL | 비차익 합계 매도 거래량 | string | Y | 1 | |
+| NABT_SMTM_SELN_VOL_RATE | 비차익 합계 매도 거래량 비율 | string | Y | 1 | |
+| NABT_SMTN_SELN_TR_PBMN | 비차익 합계 매도 거래 대금 | string | Y | 1 | |
+| NABT_SMTM_SELN_TR_PBMN_RATE | 비차익 합계 매도 거래대금 비율 | string | Y | 1 | |
+| NABT_SMTN_SHNU_VOL | 비차익 합계 매수2 거래량 | string | Y | 1 | |
+| NABT_SMTM_SHNU_VOL_RATE | 비차익 합계 매수 거래량 비율 | string | Y | 1 | |
+| NABT_SMTN_SHNU_TR_PBMN | 비차익 합계 매수2 거래 대금 | string | Y | 1 | |
+| NABT_SMTM_SHNU_TR_PBMN_RATE | 비차익 합계 매수 거래대금 비율 | string | Y | 1 | |
+| NABT_SMTN_NTBY_QTY | 비차익 합계 순매수 수량 | string | Y | 1 | |
+| NABT_SMTM_NTBY_QTY_RATE | 비차익 합계 순매수 수량 비율 | string | Y | 1 | |
+| NABT_SMTN_NTBY_TR_PBMN | 비차익 합계 순매수 거래 대금 | string | Y | 1 | |
+| NABT_SMTM_NTBY_TR_PBMN_RATE | 비차익 합계 순매수 거래대금 비 | string | Y | 1 | |
+| WHOL_ENTM_SELN_VOL | 전체 위탁 매도 거래량 | string | Y | 1 | |
+| ENTM_SELN_VOL_RATE | 위탁 매도 거래량 비율 | string | Y | 1 | |
+| WHOL_ENTM_SELN_TR_PBMN | 전체 위탁 매도 거래 대금 | string | Y | 1 | |
+| ENTM_SELN_TR_PBMN_RATE | 위탁 매도 거래대금 비율 | string | Y | 1 | |
+| WHOL_ENTM_SHNU_VOL | 전체 위탁 매수2 거래량 | string | Y | 1 | |
+| ENTM_SHNU_VOL_RATE | 위탁 매수 거래량 비율 | string | Y | 1 | |
+| WHOL_ENTM_SHNU_TR_PBMN | 전체 위탁 매수2 거래 대금 | string | Y | 1 | |
+| ENTM_SHNU_TR_PBMN_RATE | 위탁 매수 거래대금 비율 | string | Y | 1 | |
+| WHOL_ENTM_NTBY_QT | 전체 위탁 순매수 수량 | string | Y | 1 | |
+| ENTM_NTBY_QTY_RAT | 위탁 순매수 수량 비율 | string | Y | 1 | |
+| WHOL_ENTM_NTBY_TR_PBMN | 전체 위탁 순매수 거래 대금 | string | Y | 1 | |
+| ENTM_NTBY_TR_PBMN_RATE | 위탁 순매수 금액 비율 | string | Y | 1 | |
+| WHOL_ONSL_SELN_VOL | 전체 자기 매도 거래량 | string | Y | 1 | |
+| ONSL_SELN_VOL_RATE | 자기 매도 거래량 비율 | string | Y | 1 | |
+| WHOL_ONSL_SELN_TR_PBMN | 전체 자기 매도 거래 대금 | string | Y | 1 | |
+| ONSL_SELN_TR_PBMN_RATE | 자기 매도 거래대금 비율 | string | Y | 1 | |
+| WHOL_ONSL_SHNU_VOL | 전체 자기 매수2 거래량 | string | Y | 1 | |
+| ONSL_SHNU_VOL_RATE | 자기 매수 거래량 비율 | string | Y | 1 | |
+| WHOL_ONSL_SHNU_TR_PBMN | 전체 자기 매수2 거래 대금 | string | Y | 1 | |
+| ONSL_SHNU_TR_PBMN_RATE | 자기 매수 거래대금 비율 | string | Y | 1 | |
+| WHOL_ONSL_NTBY_QTY | 전체 자기 순매수 수량 | string | Y | 1 | |
+| ONSL_NTBY_QTY_RATE | 자기 순매수량 비율 | string | Y | 1 | |
+| WHOL_ONSL_NTBY_TR_PBMN | 전체 자기 순매수 거래 대금 | string | Y | 1 | |
+| ONSL_NTBY_TR_PBMN_RATE | 자기 순매수 대금 비율 | string | Y | 1 | |
+| TOTAL_SELN_QTY | 총 매도 수량 | string | Y | 1 | |
+| WHOL_SELN_VOL_RATE | 전체 매도 거래량 비율 | string | Y | 1 | |
+| TOTAL_SELN_TR_PBMN | 총 매도 거래 대금 | string | Y | 1 | |
+| WHOL_SELN_TR_PBMN_RATE | 전체 매도 거래대금 비율 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 1 | |
+| WHOL_SHUN_VOL_RATE | 전체 매수 거래량 비율 | string | Y | 1 | |
+| TOTAL_SHNU_TR_PBMN | 총 매수2 거래 대금 | string | Y | 1 | |
+| WHOL_SHUN_TR_PBMN_RATE | 전체 매수 거래대금 비율 | string | Y | 1 | |
+| WHOL_NTBY_QTY | 전체 순매수 수량 | string | Y | 1 | |
+| WHOL_SMTM_NTBY_QTY_RATE | 전체 합계 순매수 수량 비율 | string | Y | 1 | |
+| WHOL_NTBY_TR_PBMN | 전체 순매수 거래 대금 | string | Y | 1 | |
+| WHOL_NTBY_TR_PBMN_RATE | 전체 순매수 거래대금 비율 | string | Y | 1 | |
+| ARBT_ENTM_NTBY_QTY | 차익 위탁 순매수 수량 | string | Y | 1 | |
+| ARBT_ENTM_NTBY_TR_PBMN | 차익 위탁 순매수 거래 대금 | string | Y | 1 | |
+| ARBT_ONSL_NTBY_QTY | 차익 자기 순매수 수량 | string | Y | 1 | |
+| ARBT_ONSL_NTBY_TR_PBMN | 차익 자기 순매수 거래 대금 | string | Y | 1 | |
+| NABT_ENTM_NTBY_QTY | 비차익 위탁 순매수 수량 | string | Y | 1 | |
+| NABT_ENTM_NTBY_TR_PBMN | 비차익 위탁 순매수 거래 대금 | string | Y | 1 | |
+| NABT_ONSL_NTBY_QTY | 비차익 자기 순매수 수량 | string | Y | 1 | |
+| NABT_ONSL_NTBY_TR_PBMN | 비차익 자기 순매수 거래 대금 | string | Y | 1 | |
+| ACML_VOL | 누적 거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0UPPGM0",
+ "tr_key": "0001"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0UPPGM0",
+ "tr_key": "0001",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0UPPGM0|001|0001^085913^0^0^0^0^0^0^1^0^0^0^0^0^1^0^10^0^0^0.00^0^0.00^0^
+0.00^0^0.00^0^0.00^0^0.00^0^0.00^1^0.00^1^0.00^10^0.00^1^0.00^9^0.00^0^0.00^1^0.00^1^0.00^10^0
+.00^1^0.00^9^0.00^0^0.00^0^0.00^0^0.00^0^0.00^0^0.00^0^0.00^0^0.00^1^0.00^1^0.00^10^0.00^1^0.0
+0^9^0.00^0^0^0^0^1^9^0^0^0^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/173_국내주식-실시간회원사-통합_국내주식-실시간회원사-통합.md b/docs/broker/kis/websocket/국내주식/실시간시세/173_국내주식-실시간회원사-통합_국내주식-실시간회원사-통합.md
new file mode 100644
index 0000000..968a1d6
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/173_국내주식-실시간회원사-통합_국내주식-실시간회원사-통합.md
@@ -0,0 +1,128 @@
+# 국내주식 실시간회원사 (통합)
+
+- 원본 시트명: 국내주식 실시간회원사 (통합)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간회원사 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNMBC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNMBC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0UNMBC0 : 국내주식 주식종목회원사 (통합) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| SELN2_MBCR_NAME1 | 매도2 회원사명1 | string | Y | 16 | |
+| SELN2_MBCR_NAME2 | 매도2 회원사명2 | string | Y | 16 | |
+| SELN2_MBCR_NAME3 | 매도2 회원사명3 | string | Y | 16 | |
+| SELN2_MBCR_NAME4 | 매도2 회원사명4 | string | Y | 16 | |
+| SELN2_MBCR_NAME5 | 매도2 회원사명5 | string | Y | 16 | |
+| BYOV_MBCR_NAME1 | 매수 회원사명1 | string | Y | 16 | |
+| BYOV_MBCR_NAME2 | 매수 회원사명2 | string | Y | 16 | |
+| BYOV_MBCR_NAME3 | 매수 회원사명3 | string | Y | 16 | |
+| BYOV_MBCR_NAME4 | 매수 회원사명4 | string | Y | 16 | |
+| BYOV_MBCR_NAME5 | 매수 회원사명5 | string | Y | 16 | |
+| TOTAL_SELN_QTY1 | 총 매도 수량1 | string | Y | 8 | |
+| TOTAL_SELN_QTY2 | 총 매도 수량2 | string | Y | 8 | |
+| TOTAL_SELN_QTY3 | 총 매도 수량3 | string | Y | 8 | |
+| TOTAL_SELN_QTY4 | 총 매도 수량4 | string | Y | 8 | |
+| TOTAL_SELN_QTY5 | 총 매도 수량5 | string | Y | 8 | |
+| TOTAL_SHNU_QTY1 | 총 매수2 수량1 | string | Y | 8 | |
+| TOTAL_SHNU_QTY2 | 총 매수2 수량2 | string | Y | 8 | |
+| TOTAL_SHNU_QTY3 | 총 매수2 수량3 | string | Y | 8 | |
+| TOTAL_SHNU_QTY4 | 총 매수2 수량4 | string | Y | 8 | |
+| TOTAL_SHNU_QTY5 | 총 매수2 수량5 | string | Y | 8 | |
+| SELN_MBCR_GLOB_YN_1 | 매도거래원구분1 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_2 | 매도거래원구분2 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_3 | 매도거래원구분3 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_4 | 매도거래원구분4 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_5 | 매도거래원구분5 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_1 | 매수거래원구분1 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_2 | 매수거래원구분2 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_3 | 매수거래원구분3 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_4 | 매수거래원구분4 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_5 | 매수거래원구분5 | string | Y | 1 | |
+| SELN_MBCR_NO1 | 매도거래원코드1 | string | Y | 5 | |
+| SELN_MBCR_NO2 | 매도거래원코드2 | string | Y | 5 | |
+| SELN_MBCR_NO3 | 매도거래원코드3 | string | Y | 5 | |
+| SELN_MBCR_NO4 | 매도거래원코드4 | string | Y | 5 | |
+| SELN_MBCR_NO5 | 매도거래원코드5 | string | Y | 5 | |
+| SHNU_MBCR_NO1 | 매수거래원코드1 | string | Y | 5 | |
+| SHNU_MBCR_NO2 | 매수거래원코드2 | string | Y | 5 | |
+| SHNU_MBCR_NO3 | 매수거래원코드3 | string | Y | 5 | |
+| SHNU_MBCR_NO4 | 매수거래원코드4 | string | Y | 5 | |
+| SHNU_MBCR_NO5 | 매수거래원코드5 | string | Y | 5 | |
+| SELN_MBCR_RLIM1 | 매도 회원사 비중1 | string | Y | 8 | |
+| SELN_MBCR_RLIM2 | 매도 회원사 비중2 | string | Y | 8 | |
+| SELN_MBCR_RLIM3 | 매도 회원사 비중3 | string | Y | 8 | |
+| SELN_MBCR_RLIM4 | 매도 회원사 비중4 | string | Y | 8 | |
+| SELN_MBCR_RLIM5 | 매도 회원사 비중5 | string | Y | 8 | |
+| SHNU_MBCR_RLIM1 | 매수2 회원사 비중1 | string | Y | 8 | |
+| SHNU_MBCR_RLIM2 | 매수2 회원사 비중2 | string | Y | 8 | |
+| SHNU_MBCR_RLIM3 | 매수2 회원사 비중3 | string | Y | 8 | |
+| SHNU_MBCR_RLIM4 | 매수2 회원사 비중4 | string | Y | 8 | |
+| SHNU_MBCR_RLIM5 | 매수2 회원사 비중5 | string | Y | 8 | |
+| SELN_QTY_ICDC1 | 매도 수량 증감1 | string | Y | 4 | |
+| SELN_QTY_ICDC2 | 매도 수량 증감2 | string | Y | 4 | |
+| SELN_QTY_ICDC3 | 매도 수량 증감3 | string | Y | 4 | |
+| SELN_QTY_ICDC4 | 매도 수량 증감4 | string | Y | 4 | |
+| SELN_QTY_ICDC5 | 매도 수량 증감5 | string | Y | 4 | |
+| SHNU_QTY_ICDC1 | 매수2 수량 증감1 | string | Y | 4 | |
+| SHNU_QTY_ICDC2 | 매수2 수량 증감2 | string | Y | 4 | |
+| SHNU_QTY_ICDC3 | 매수2 수량 증감3 | string | Y | 4 | |
+| SHNU_QTY_ICDC4 | 매수2 수량 증감4 | string | Y | 4 | |
+| SHNU_QTY_ICDC5 | 매수2 수량 증감5 | string | Y | 4 | |
+| GLOB_TOTAL_SELN_QTY | 외국계 총 매도 수량 | string | Y | 8 | |
+| GLOB_TOTAL_SHNU_QTY | 외국계 총 매수2 수량 | string | Y | 8 | |
+| GLOB_TOTAL_SELN_QTY_ICDC | 외국계 총 매도 수량 증감 | string | Y | 4 | |
+| GLOB_TOTAL_SHNU_QTY_ICDC | 외국계 총 매수2 수량 증감 | string | Y | 4 | |
+| GLOB_NTBY_QTY | 외국계 순매수 수량 | string | Y | 8 | |
+| GLOB_SELN_RLIM | 외국계 매도 비중 | string | Y | 8 | |
+| GLOB_SHNU_RLIM | 외국계 매수2 비중 | string | Y | 8 | |
+| SELN2_MBCR_ENG_NAME1 | 매도2 영문회원사명1 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME2 | 매도2 영문회원사명2 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME3 | 매도2 영문회원사명3 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME4 | 매도2 영문회원사명4 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME5 | 매도2 영문회원사명5 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME1 | 매수 영문회원사명1 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME2 | 매수 영문회원사명2 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME3 | 매수 영문회원사명3 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME4 | 매수 영문회원사명4 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME5 | 매수 영문회원사명5 | string | Y | 20 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/174_실시간-026_국내지수-실시간체결.md b/docs/broker/kis/websocket/국내주식/실시간시세/174_실시간-026_국내지수-실시간체결.md
new file mode 100644
index 0000000..b11cd32
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/174_실시간-026_국내지수-실시간체결.md
@@ -0,0 +1,145 @@
+# 국내지수 실시간체결
+
+- 원본 시트명: 국내지수 실시간체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-026
+- HTTP Method: POST
+- 실전 TR_ID: H0UPCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UPCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0UPCNT0 |
+| tr_key | 종목코드 | string | Y | 6 | 업종구분코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| bstp_cls_code | 업종 구분 코드 | object | Y | 4 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| bsop_hour | 영업 시간 | string | Y | 6 | |
+| prpr_nmix | 현재가 지수 | string | Y | 1 | |
+| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
+| bstp_nmix_prdy_vrss | 업종 지수 전일 대비 | string | Y | 1 | |
+| acml_vol | 누적 거래량 | string | Y | 1 | |
+| acml_tr_pbmn | 누적 거래 대금 | string | Y | 1 | |
+| pcas_vol | 건별 거래량 | string | Y | 1 | |
+| pcas_tr_pbmn | 건별 거래 대금 | string | Y | 1 | |
+| prdy_ctrt | 전일 대비율 | string | Y | 1 | |
+| oprc_nmix | 시가 지수 | string | Y | 1 | |
+| nmix_hgpr | 지수 최고가 | string | Y | 1 | |
+| nmix_lwpr | 지수 최저가 | string | Y | 1 | |
+| oprc_vrss_nmix_prpr | 시가 대비 지수 현재가 | string | Y | 1 | |
+| oprc_vrss_nmix_sign | 시가 대비 지수 부호 | string | Y | 1 | |
+| hgpr_vrss_nmix_prpr | 최고가 대비 지수 현재가 | string | Y | 1 | |
+| hgpr_vrss_nmix_sign | 최고가 대비 지수 부호 | string | Y | 1 | |
+| lwpr_vrss_nmix_prpr | 최저가 대비 지수 현재가 | string | Y | 1 | |
+| lwpr_vrss_nmix_sign | 최저가 대비 지수 부호 | string | Y | 1 | |
+| prdy_clpr_vrss_oprc_rate | 전일 종가 대비 시가2 비율 | string | Y | 1 | |
+| prdy_clpr_vrss_hgpr_rate | 전일 종가 대비 최고가 비율 | string | Y | 1 | |
+| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 1 | |
+| uplm_issu_cnt | 상한 종목 수 | string | Y | 1 | |
+| ascn_issu_cnt | 상승 종목 수 | string | Y | 1 | |
+| stnr_issu_cnt | 보합 종목 수 | string | Y | 1 | |
+| down_issu_cnt | 하락 종목 수 | string | Y | 1 | |
+| lslm_issu_cnt | 하한 종목 수 | string | Y | 1 | |
+| qtqt_ascn_issu_cnt | 기세 상승 종목수 | string | Y | 1 | |
+| qtqt_down_issu_cnt | 기세 하락 종목수 | string | Y | 1 | |
+| tick_vrss | TICK대비 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0UPCNT0",
+ "tr_key": "0001"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0UPCNT0",
+ "tr_key": "0001",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0UPCNT0|001|0001^091240^2624.54^2^32.68^63952^1650684^439^10335^1.26^2615
+.72^2624.82^2610.00^23.86^2^32.96^2^18.14^2^0.92^1.27^0.70^0^670^72^177^0^0^0^19
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/175_실시간-041_국내주식-실시간예상체결-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/175_실시간-041_국내주식-실시간예상체결-KRX.md
new file mode 100644
index 0000000..11ec408
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/175_실시간-041_국내주식-실시간예상체결-KRX.md
@@ -0,0 +1,167 @@
+# 국내주식 실시간예상체결 (KRX)
+
+- 원본 시트명: 국내주식 실시간예상체결 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-041
+- HTTP Method: POST
+- 실전 TR_ID: H0STANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 실시간예상체결 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0STANC0 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일대비구분 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 4 | |
+| PRDY_CTRT | 등락율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 8 | |
+| STCK_OPRC | 시가 | string | Y | 4 | |
+| STCK_HGPR | 고가 | string | Y | 4 | |
+| STCK_LWPR | 저가 | string | Y | 4 | |
+| ASKP1 | 매도호가 | string | Y | 4 | |
+| BIDP1 | 매수호가 | string | Y | 4 | |
+| CNTG_VOL | 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 4 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 4 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 4 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 8 | |
+| HOUR_CLS_CODE | 시간구분코드 | string | Y | 1 | |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STANC0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STANC0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STANC0|001|005930^084945^77600^2^1300^1.70^0.00^0^0^0^77600^77
+500^64^221986^17226113600^0^0^0^0.00^0^0^1^0.01^0.00^000000^3^0^000000^3^0^000000^3^
+0^20240426^00^N^11591^2878^41034^6265^0.00^0^0.00^B^
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/176_실시간-062_ELW-실시간호가.md b/docs/broker/kis/websocket/국내주식/실시간시세/176_실시간-062_ELW-실시간호가.md
new file mode 100644
index 0000000..b4b25a5
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/176_실시간-062_ELW-실시간호가.md
@@ -0,0 +1,197 @@
+# ELW 실시간호가
+
+- 원본 시트명: ELW 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-062
+- HTTP Method: POST
+- 실전 TR_ID: H0EWASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EWASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 실시간호가 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EWASP0 |
+| tr_key | 구분값 | string | Y | 12 | ELW 종목코드(ex. 57LA24) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업시간 | string | Y | 6 | |
+| HOUR_CLS_CODE | 시간구분코드 | string | Y | 1 | |
+| ASKP1 | 매도호가1 | string | Y | 1 | |
+| ASKP2 | 매도호가2 | string | Y | 1 | |
+| ASKP3 | 매도호가3 | string | Y | 1 | |
+| ASKP4 | 매도호가4 | string | Y | 1 | |
+| ASKP5 | 매도호가5 | string | Y | 1 | |
+| ASKP6 | 매도호가6 | string | Y | 1 | |
+| ASKP7 | 매도호가7 | string | Y | 1 | |
+| ASKP8 | 매도호가8 | string | Y | 1 | |
+| ASKP9 | 매도호가9 | string | Y | 1 | |
+| ASKP10 | 매도호가10 | string | Y | 1 | |
+| BIDP1 | 매수호가1 | string | Y | 1 | |
+| BIDP2 | 매수호가2 | string | Y | 1 | |
+| BIDP3 | 매수호가3 | string | Y | 1 | |
+| BIDP4 | 매수호가4 | string | Y | 1 | |
+| BIDP5 | 매수호가5 | string | Y | 1 | |
+| BIDP6 | 매수호가6 | string | Y | 1 | |
+| BIDP7 | 매수호가7 | string | Y | 1 | |
+| BIDP8 | 매수호가8 | string | Y | 1 | |
+| BIDP9 | 매수호가9 | string | Y | 1 | |
+| BIDP10 | 매수호가10 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 1 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 1 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 1 | |
+| ASKP_RSQN5 | 매도호가잔량5 | string | Y | 1 | |
+| ASKP_RSQN6 | 매도호가잔량6 | string | Y | 1 | |
+| ASKP_RSQN7 | 매도호가잔량7 | string | Y | 1 | |
+| ASKP_RSQN8 | 매도호가잔량8 | string | Y | 1 | |
+| ASKP_RSQN9 | 매도호가잔량9 | string | Y | 1 | |
+| ASKP_RSQN10 | 매도호가잔량10 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 1 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 1 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 1 | |
+| BIDP_RSQN5 | 매수호가잔량5 | string | Y | 1 | |
+| BIDP_RSQN6 | 매수호가잔량6 | string | Y | 1 | |
+| BIDP_RSQN7 | 매수호가잔량7 | string | Y | 1 | |
+| BIDP_RSQN8 | 매수호가잔량8 | string | Y | 1 | |
+| BIDP_RSQN9 | 매수호가잔량9 | string | Y | 1 | |
+| BIDP_RSQN10 | 매수호가잔량10 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| ANTC_CNPR | 예상체결가 | string | Y | 1 | |
+| ANTC_CNQN | 예상체결량 | string | Y | 1 | |
+| ANTC_CNTG_VRSS_SIGN | 예상체결대비부호 | string | Y | 1 | |
+| ANTC_CNTG_VRSS | 예상체결대비 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상체결전일대비율 | string | Y | 1 | |
+| LP_ASKP_RSQN1 | LP매도호가잔량1 | string | Y | 1 | |
+| LP_ASKP_RSQN2 | LP매도호가잔량2 | string | Y | 1 | |
+| LP_ASKP_RSQN3 | LP매도호가잔량3 | string | Y | 1 | |
+| LP_BIDP_RSQN4 | LP매수호가잔량4 | string | Y | 1 | |
+| LP_ASKP_RSQN4 | LP매도호가잔량4 | string | Y | 1 | |
+| LP_BIDP_RSQN5 | LP매수호가잔량5 | string | Y | 1 | |
+| LP_ASKP_RSQN5 | LP매도호가잔량5 | string | Y | 1 | |
+| LP_BIDP_RSQN6 | LP매수호가잔량6 | string | Y | 1 | |
+| LP_ASKP_RSQN6 | LP매도호가잔량6 | string | Y | 1 | |
+| LP_BIDP_RSQN7 | LP매수호가잔량7 | string | Y | 1 | |
+| LP_ASKP_RSQN7 | LP매도호가잔량7 | string | Y | 1 | |
+| LP_ASKP_RSQN8 | LP매도호가잔량8 | string | Y | 1 | |
+| LP_BIDP_RSQN8 | LP매수호가잔량8 | string | Y | 1 | |
+| LP_ASKP_RSQN9 | LP매도호가잔량9 | string | Y | 1 | |
+| LP_BIDP_RSQN9 | LP매수호가잔량9 | string | Y | 1 | |
+| LP_ASKP_RSQN10 | LP매도호가잔량10 | string | Y | 1 | |
+| LP_BIDP_RSQN10 | LP매수호가잔량10 | string | Y | 1 | |
+| LP_BIDP_RSQN1 | LP매수호가잔량1 | string | Y | 1 | |
+| LP_TOTAL_ASKP_RSQN | LP총매도호가잔량 | string | Y | 1 | |
+| LP_BIDP_RSQN2 | LP매수호가잔량2 | string | Y | 1 | |
+| LP_TOTAL_BIDP_RSQN | LP총매수호가잔량 | string | Y | 1 | |
+| LP_BIDP_RSQN3 | LP매수호가잔량3 | string | Y | 1 | |
+| ANTC_VOL | 예상거래량 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0EWASP0",
+ "tr_key":"57JN53"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EWASP0",
+ "tr_key": "57JN53",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0EWASP0|001|57JN53^090333^0^270^275^280^285^290^295^300^305^310
+^315^265^260^255^250^245^240^235^230^225^220^132730^144770^53560^139510^104910^16386
+0^111580^41530^66600^41040^119950^176460^142150^218620^148250^160210^154250^141660^1
+40270^160640^1000090^1562460^0^0^3^0^0.00^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^0^
+0^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/177_실시간-004_국내주식-실시간호가-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/177_실시간-004_국내주식-실시간호가-KRX.md
new file mode 100644
index 0000000..9c9d8ab
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/177_실시간-004_국내주식-실시간호가-KRX.md
@@ -0,0 +1,176 @@
+# 국내주식 실시간호가 (KRX)
+
+- 원본 시트명: 국내주식 실시간호가 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-004
+- HTTP Method: POST
+- 실전 TR_ID: H0STASP0
+- 모의 TR_ID: H0STASP0
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: ws://ops.koreainvestment.com:31000
+- URL 명: /tryitout/H0STASP0
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id
+- 데이터 건수 : (ex. 001 데이터 건수를 참조하여 활용)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | Y | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | Y | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 1 | [실전/모의투자]
H0STASP0 : 주식호가 |
+| tr_key | 구분값 | string | Y | 1 | 종목번호 (6자리)
ETN의 경우, Q로 시작 (EX. Q500001) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | 0 : 장중
A : 장후예상
B : 장전예상
C : 9시이후의 예상가, VI발동
D : 시간외 단일가 예상 |
+| ASKP1 | 매도호가1 | number | Y | 4 | |
+| ASKP2 | 매도호가2 | number | Y | 4 | |
+| ASKP3 | 매도호가3 | number | Y | 4 | |
+| ASKP4 | 매도호가4 | number | Y | 4 | |
+| ASKP5 | 매도호가5 | number | Y | 4 | |
+| ASKP6 | 매도호가6 | number | Y | 4 | |
+| ASKP7 | 매도호가7 | number | Y | 4 | |
+| ASKP8 | 매도호가8 | number | Y | 4 | |
+| ASKP9 | 매도호가9 | number | Y | 4 | |
+| ASKP10 | 매도호가10 | number | Y | 4 | |
+| BIDP1 | 매수호가1 | number | Y | 4 | |
+| BIDP2 | 매수호가2 | number | Y | 4 | |
+| BIDP3 | 매수호가3 | number | Y | 4 | |
+| BIDP4 | 매수호가4 | number | Y | 4 | |
+| BIDP5 | 매수호가5 | number | Y | 4 | |
+| BIDP6 | 매수호가6 | number | Y | 4 | |
+| BIDP7 | 매수호가7 | number | Y | 4 | |
+| BIDP8 | 매수호가8 | number | Y | 4 | |
+| BIDP9 | 매수호가9 | number | Y | 4 | |
+| BIDP10 | 매수호가10 | number | Y | 4 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | number | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | number | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | number | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | number | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | number | Y | 8 | |
+| ASKP_RSQN6 | 매도호가 잔량6 | number | Y | 8 | |
+| ASKP_RSQN7 | 매도호가 잔량7 | number | Y | 8 | |
+| ASKP_RSQN8 | 매도호가 잔량8 | number | Y | 8 | |
+| ASKP_RSQN9 | 매도호가 잔량9 | number | Y | 8 | |
+| ASKP_RSQN10 | 매도호가 잔량10 | number | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | number | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | number | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | number | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | number | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | number | Y | 8 | |
+| BIDP_RSQN6 | 매수호가 잔량6 | number | Y | 8 | |
+| BIDP_RSQN7 | 매수호가 잔량7 | number | Y | 8 | |
+| BIDP_RSQN8 | 매수호가 잔량8 | number | Y | 8 | |
+| BIDP_RSQN9 | 매수호가 잔량9 | number | Y | 8 | |
+| BIDP_RSQN10 | 매수호가 잔량10 | number | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | number | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | number | Y | 8 | |
+| OVTM_TOTAL_ASKP_RSQN | 시간외 총 매도호가 잔량 | number | Y | 8 | |
+| OVTM_TOTAL_BIDP_RSQN | 시간외 총 매수호가 잔량 | number | Y | 8 | |
+| ANTC_CNPR | 예상 체결가 | number | Y | 4 | 동시호가 등 특정 조건하에서만 발생 |
+| ANTC_CNQN | 예상 체결량 | number | Y | 8 | 동시호가 등 특정 조건하에서만 발생 |
+| ANTC_VOL | 예상 거래량 | number | Y | 8 | 동시호가 등 특정 조건하에서만 발생 |
+| ANTC_CNTG_VRSS | 예상 체결 대비 | number | Y | 4 | 동시호가 등 특정 조건하에서만 발생 |
+| ANTC_CNTG_VRSS_SIGN | 예상 체결 대비 부호 | string | Y | 1 | 동시호가 등 특정 조건하에서만 발생
1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락 |
+| ANTC_CNTG_PRDY_CTRT | 예상 체결 전일 대비율 | number | Y | 8 | |
+| ACML_VOL | 누적 거래량 | number | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | number | Y | 4 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | number | Y | 4 | |
+| OVTM_TOTAL_ASKP_ICDC | 시간외 총 매도호가 증감 | number | Y | 4 | |
+| OVTM_TOTAL_BIDP_ICDC | 시간외 총 매수호가 증감 | number | Y | 4 | |
+| STCK_DEAL_CLS_CODE | 주식 매매 구분 코드 | string | Y | 2 | 사용 X (삭제된 값) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STASP0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STASP0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+005930^093730^0^71900^72000^72100^72200^72300^72400^72500^72600^72700^72800^71
+800^71700^71600^71500^71400^71300^71200^71100^71000^70900^91918^117942^92673^7
+9708^106729^141988^176192^113906^134077^104229^95221^159371^220746^284657^2127
+42^195370^182710^209747^376432^158171^1159362^2095167^0^0^0^0^525579^-72000^5^
+-100.00^3159115^0^8^0^0^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/178_국내주식-실시간체결가-통합_국내주식-실시간체결가-통합.md b/docs/broker/kis/websocket/국내주식/실시간시세/178_국내주식-실시간체결가-통합_국내주식-실시간체결가-통합.md
new file mode 100644
index 0000000..9eec5c3
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/178_국내주식-실시간체결가-통합_국내주식-실시간체결가-통합.md
@@ -0,0 +1,96 @@
+# 국내주식 실시간체결가 (통합)
+
+- 원본 시트명: 국내주식 실시간체결가 (통합)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간체결가 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | B : 법인 P : 개인 |
+| tr_type | 거래타입 | string | N | 1 | 1 : 등록 2 : 해제 |
+| content-type | 컨텐츠타입 | string | N | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0UNCNT0 : 실시간 주식 체결가 통합 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| STCK_PRPR | 주식 현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일 대비 | string | Y | 4 | |
+| PRDY_CTRT | 전일 대비율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중 평균 주식 가격 | string | Y | 8 | |
+| STCK_OPRC | 주식 시가 | string | Y | 4 | |
+| STCK_HGPR | 주식 최고가 | string | Y | 4 | |
+| STCK_LWPR | 주식 최저가 | string | Y | 4 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| CNTG_VOL | 체결 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 4 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 4 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 4 | |
+| BSOP_DATE | 영업 일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신 장운영 구분 코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지 여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| VOL_TNRT | 거래량 회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일 동시간 누적 거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일 동시간 누적 거래량 비율 | string | Y | 8 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+| VI_STND_PRC | 정적VI발동기준가 | string | Y | 4 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/179_국내주식-실시간호가-NXT_국내주식-실시간호가-NXT.md b/docs/broker/kis/websocket/국내주식/실시간시세/179_국내주식-실시간호가-NXT_국내주식-실시간호가-NXT.md
new file mode 100644
index 0000000..63a4477
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/179_국내주식-실시간호가-NXT_국내주식-실시간호가-NXT.md
@@ -0,0 +1,115 @@
+# 국내주식 실시간호가 (NXT)
+
+- 원본 시트명: 국내주식 실시간호가 (NXT)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간호가 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXASP0 : 실시간 주식 호가 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| BSOP_HOUR | 영업 시간 | string | Y | 6 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| ASKP2 | 매도호가2 | string | Y | 4 | |
+| ASKP3 | 매도호가3 | string | Y | 4 | |
+| ASKP4 | 매도호가4 | string | Y | 4 | |
+| ASKP5 | 매도호가5 | string | Y | 4 | |
+| ASKP6 | 매도호가6 | string | Y | 4 | |
+| ASKP7 | 매도호가7 | string | Y | 4 | |
+| ASKP8 | 매도호가8 | string | Y | 4 | |
+| ASKP9 | 매도호가9 | string | Y | 4 | |
+| ASKP10 | 매도호가10 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| BIDP2 | 매수호가2 | string | Y | 4 | |
+| BIDP3 | 매수호가3 | string | Y | 4 | |
+| BIDP4 | 매수호가4 | string | Y | 4 | |
+| BIDP5 | 매수호가5 | string | Y | 4 | |
+| BIDP6 | 매수호가6 | string | Y | 4 | |
+| BIDP7 | 매수호가7 | string | Y | 4 | |
+| BIDP8 | 매수호가8 | string | Y | 4 | |
+| BIDP9 | 매수호가9 | string | Y | 4 | |
+| BIDP10 | 매수호가10 | string | Y | 4 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가 잔량2 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가 잔량3 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가 잔량4 | string | Y | 8 | |
+| ASKP_RSQN5 | 매도호가 잔량5 | string | Y | 8 | |
+| ASKP_RSQN6 | 매도호가 잔량6 | string | Y | 8 | |
+| ASKP_RSQN7 | 매도호가 잔량7 | string | Y | 8 | |
+| ASKP_RSQN8 | 매도호가 잔량8 | string | Y | 8 | |
+| ASKP_RSQN9 | 매도호가 잔량9 | string | Y | 8 | |
+| ASKP_RSQN10 | 매도호가 잔량10 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가 잔량2 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가 잔량3 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가 잔량4 | string | Y | 8 | |
+| BIDP_RSQN5 | 매수호가 잔량5 | string | Y | 8 | |
+| BIDP_RSQN6 | 매수호가 잔량6 | string | Y | 8 | |
+| BIDP_RSQN7 | 매수호가 잔량7 | string | Y | 8 | |
+| BIDP_RSQN8 | 매수호가 잔량8 | string | Y | 8 | |
+| BIDP_RSQN9 | 매수호가 잔량9 | string | Y | 8 | |
+| BIDP_RSQN10 | 매수호가 잔량10 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| OVTM_TOTAL_ASKP_RSQN | 시간외 총 매도호가 잔량 | string | Y | 8 | |
+| OVTM_TOTAL_BIDP_RSQN | 시간외 총 매수호가 잔량 | string | Y | 8 | |
+| ANTC_CNPR | 예상 체결가 | string | Y | 4 | |
+| ANTC_CNQN | 예상 체결량 | string | Y | 8 | |
+| ANTC_VOL | 예상 거래량 | string | Y | 8 | |
+| ANTC_CNTG_VRSS | 예상 체결 대비 | string | Y | 4 | |
+| ANTC_CNTG_VRSS_SIGN | 예상 체결 대비 부호 | string | Y | 1 | |
+| ANTC_CNTG_PRDY_CTRT | 예상 체결 전일 대비율 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN_ICDC | 총 매도호가 잔량 증감 | string | Y | 4 | |
+| TOTAL_BIDP_RSQN_ICDC | 총 매수호가 잔량 증감 | string | Y | 4 | |
+| OVTM_TOTAL_ASKP_ICDC | 시간외 총 매도호가 증감 | string | Y | 4 | |
+| OVTM_TOTAL_BIDP_ICDC | 시간외 총 매수호가 증감 | string | Y | 4 | |
+| STCK_DEAL_CLS_CODE | 주식 매매 구분 코드 | string | Y | 2 | |
+| KMID_PRC | KRX 중간가 | string | Y | 4 | |
+| KMID_TOTAL_RSQN | KRX 중간가잔량합계수량 | string | Y | 8 | |
+| KMID_CLS_CODE | KRX 중간가 매수매도 구분 | string | Y | 1 | |
+| NMID_PRC | NXT 중간가 | string | Y | 4 | |
+| NMID_TOTAL_RSQN | NXT 중간가잔량합계수량 | string | Y | 8 | |
+| NMID_CLS_CODE | NXT 중간가 매수매도 구분 | string | Y | 1 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/180_국내주식-실시간프로그램매매-NXT_국내주식-실시간프로그램매매-NXT.md b/docs/broker/kis/websocket/국내주식/실시간시세/180_국내주식-실시간프로그램매매-NXT_국내주식-실시간프로그램매매-NXT.md
new file mode 100644
index 0000000..1399c69
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/180_국내주식-실시간프로그램매매-NXT_국내주식-실시간프로그램매매-NXT.md
@@ -0,0 +1,61 @@
+# 국내주식 실시간프로그램매매 (NXT)
+
+- 원본 시트명: 국내주식 실시간프로그램매매 (NXT)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간프로그램매매 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXPGM0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXPGM0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXPGM0 : 실시간 주식프로그램매매 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| SELN_CNQN | 매도 체결량 | string | Y | 8 | |
+| SELN_TR_PBMN | 매도 거래 대금 | string | Y | 8 | |
+| SHNU_CNQN | 매수2 체결량 | string | Y | 8 | |
+| SHNU_TR_PBMN | 매수2 거래 대금 | string | Y | 8 | |
+| NTBY_CNQN | 순매수 체결량 | string | Y | 8 | |
+| NTBY_TR_PBMN | 순매수 거래 대금 | string | Y | 8 | |
+| SELN_RSQN | 매도호가잔량 | string | Y | 8 | |
+| SHNU_RSQN | 매수호가잔량 | string | Y | 8 | |
+| WHOL_NTBY_QTY | 전체순매수호가잔량 | string | Y | 8 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/181_국내주식-실시간체결가-NXT_국내주식-실시간체결가-NXT.md b/docs/broker/kis/websocket/국내주식/실시간시세/181_국내주식-실시간체결가-NXT_국내주식-실시간체결가-NXT.md
new file mode 100644
index 0000000..fdd6f12
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/181_국내주식-실시간체결가-NXT_국내주식-실시간체결가-NXT.md
@@ -0,0 +1,96 @@
+# 국내주식 실시간체결가 (NXT)
+
+- 원본 시트명: 국내주식 실시간체결가 (NXT)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간체결가 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객타입 | string | N | 1 | 'B : 법인
P : 개인' |
+| tr_type | 거래타입 | string | N | 1 | '1 : 등록
2 : 해제' |
+| content-type | 컨텐츠타입 | string | N | 1 | ' utf-8' |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXCNT0 : 주식종목체결 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권 단축 종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | |
+| STCK_PRPR | 주식 현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일 대비 부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일 대비 | string | Y | 4 | |
+| PRDY_CTRT | 전일 대비율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중 평균 주식 가격 | string | Y | 8 | |
+| STCK_OPRC | 주식 시가 | string | Y | 4 | |
+| STCK_HGPR | 주식 최고가 | string | Y | 4 | |
+| STCK_LWPR | 주식 최저가 | string | Y | 4 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| CNTG_VOL | 체결 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적 거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적 거래 대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도 체결 건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수 체결 건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수 체결 건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총 매도 수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총 매수 수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일 거래량 대비 등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가 시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 4 | |
+| HGPR_HOUR | 최고가 시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 4 | |
+| LWPR_HOUR | 최저가 시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 4 | |
+| BSOP_DATE | 영업 일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신 장운영 구분 코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지 여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가 잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가 잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총 매도호가 잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총 매수호가 잔량 | string | Y | 8 | |
+| VOL_TNRT | 거래량 회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일 동시간 누적 거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일 동시간 누적 거래량 비율 | string | Y | 8 | |
+| HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 1 | |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+| VI_STND_PRC | 정적VI발동기준가 | string | Y | 4 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/182_실시간-061_ELW-실시간체결가.md b/docs/broker/kis/websocket/국내주식/실시간시세/182_실시간-061_ELW-실시간체결가.md
new file mode 100644
index 0000000..a2677fd
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/182_실시간-061_ELW-실시간체결가.md
@@ -0,0 +1,187 @@
+# ELW 실시간체결가
+
+- 원본 시트명: ELW 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-061
+- HTTP Method: POST
+- 실전 TR_ID: H0EWCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EWCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 실시간체결가 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EWCNT0 |
+| tr_key | 구분값 | string | Y | 12 | ELW 종목코드(ex. 57LA24) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 4 | |
+| PRDY_CTRT | 전일대비율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 8 | |
+| STCK_OPRC | 주식시가2 | string | Y | 4 | |
+| STCK_HGPR | 주식최고가 | string | Y | 4 | |
+| STCK_LWPR | 주식최저가 | string | Y | 4 | |
+| ASKP1 | 매도호가1 | string | Y | 4 | |
+| BIDP1 | 매수호가1 | string | Y | 4 | |
+| CNTG_VOL | 체결거래량 | string | Y | 8 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분코드 | string | Y | 1 | |
+| SHNU_RATE | 매수2비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2대비현재가부호 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가2대비현재가 | string | Y | 4 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가대비현재가부호 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 최고가대비현재가 | string | Y | 4 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가대비현재가부호 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 최저가대비현재가 | string | Y | 4 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| TMVL_VAL | 시간가치값 | string | Y | 8 | |
+| PRIT | 패리티 | string | Y | 8 | |
+| PRMM_VAL | 프리미엄값 | string | Y | 8 | |
+| GEAR | 기어링 | string | Y | 8 | |
+| PRLS_QRYR_RATE | 손익분기비율 | string | Y | 8 | |
+| INVL_VAL | 내재가치값 | string | Y | 8 | |
+| PRMM_RATE | 프리미엄비율 | string | Y | 8 | |
+| CFP | 자본지지점 | string | Y | 8 | |
+| LVRG_VAL | 레버리지값 | string | Y | 8 | |
+| DELTA | 델타 | string | Y | 8 | |
+| GAMA | 감마 | string | Y | 8 | |
+| VEGA | 베가 | string | Y | 8 | |
+| THETA | 세타 | string | Y | 8 | |
+| RHO | 로우 | string | Y | 8 | |
+| HTS_INTS_VLTL | HTS내재변동성 | string | Y | 8 | |
+| HTS_THPR | HTS이론가 | string | Y | 8 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 8 | |
+| APPRCH_RATE | 접근도 | string | Y | 8 | |
+| LP_HVOL | LP보유량 | string | Y | 8 | |
+| LP_HLDN_RATE | LP보유비율 | string | Y | 8 | |
+| LP_NTBY_QTY | LP순매도량 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0EWCNT0",
+ "tr_key":"57JN53"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EWCNT0",
+ "tr_key": "57JN53",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0EWCNT0|001|57JN53^090333^265^2^50^23.26^285.39^305^310^255^265
+^260^50^5071350^1447312100^560^310^-250^78.69^2650440^2085570^1^0.42^11.49^090019^5^
+-40^090019^5^-45^090316^2^10^20240426^20^N^33300^181460^992350^1655180^265.00^98.62^
+1.99^133.32^2.14^0.00^0.00^2.15^49.09^0.37^0.03^24.30^29.04^4.15^17.94^293.24^50.71^
+0^0.00^0.00^0^0.00^0
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/183_실시간-063_ELW-실시간예상체결.md b/docs/broker/kis/websocket/국내주식/실시간시세/183_실시간-063_ELW-실시간예상체결.md
new file mode 100644
index 0000000..2d8ee50
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/183_실시간-063_ELW-실시간예상체결.md
@@ -0,0 +1,178 @@
+# ELW 실시간예상체결
+
+- 원본 시트명: ELW 실시간예상체결
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-063
+- HTTP Method: POST
+- 실전 TR_ID: H0EWANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0EWANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+ELW 실시간예상체결 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0EWANC0 |
+| tr_key | 구분값 | string | Y | 12 | ELW 종목코드(ex. 57LA24) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 1 | |
+| PRDY_CTRT | 전일대비율 | string | Y | 1 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 1 | |
+| STCK_OPRC | 주식시가2 | string | Y | 1 | |
+| STCK_HGPR | 주식최고가 | string | Y | 1 | |
+| STCK_LWPR | 주식최저가 | string | Y | 1 | |
+| ASKP1 | 매도호가1 | string | Y | 1 | |
+| BIDP1 | 매수호가1 | string | Y | 1 | |
+| CNTG_VOL | 체결거래량 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 1 | |
+| CNTG_CLS_CODE | 체결구분코드 | string | Y | 1 | |
+| SHNU_RATE | 매수2비율 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 1 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가2대비현재가부호 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가2대비현재가 | string | Y | 1 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 최고가대비현재가부호 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 최고가대비현재가 | string | Y | 1 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 최저가대비현재가부호 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 최저가대비현재가 | string | Y | 1 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| TMVL_VAL | 시간가치값 | string | Y | 1 | |
+| PRIT | 패리티 | string | Y | 1 | |
+| PRMM_VAL | 프리미엄값 | string | Y | 1 | |
+| GEAR | 기어링 | string | Y | 1 | |
+| PRLS_QRYR_RATE | 손익분기비율 | string | Y | 1 | |
+| INVL_VAL | 내재가치값 | string | Y | 1 | |
+| PRMM_RATE | 프리미엄비율 | string | Y | 1 | |
+| CFP | 자본지지점 | string | Y | 1 | |
+| LVRG_VAL | 레버리지값 | string | Y | 1 | |
+| DELTA | 델타 | string | Y | 1 | |
+| GAMA | 감마 | string | Y | 1 | |
+| VEGA | 베가 | string | Y | 1 | |
+| THETA | 세타 | string | Y | 1 | |
+| RHO | 로우 | string | Y | 1 | |
+| HTS_INTS_VLTL | HTS내재변동성 | string | Y | 1 | |
+| HTS_THPR | HTS이론가 | string | Y | 1 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 1 | |
+| LP_HVOL | LP보유량 | string | Y | 1 | |
+| LP_HLDN_RATE | LP보유비율 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0EWANC0",
+ "tr_key":"57JN53"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0EWANC0",
+ "tr_key": "57JN53",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/184_국내주식-실시간예상체결-NXT_국내주식-실시간예상체결-NXT.md b/docs/broker/kis/websocket/국내주식/실시간시세/184_국내주식-실시간예상체결-NXT_국내주식-실시간예상체결-NXT.md
new file mode 100644
index 0000000..c4f5187
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/184_국내주식-실시간예상체결-NXT_국내주식-실시간예상체결-NXT.md
@@ -0,0 +1,96 @@
+# 국내주식 실시간예상체결 (NXT)
+
+- 원본 시트명: 국내주식 실시간예상체결 (NXT)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간예상체결 (NXT)
+- HTTP Method: POST
+- 실전 TR_ID: H0NXANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0NXANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | N | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | N | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | N | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0NXANC0 : 국내주식 실시간예상체결 (NXT) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일대비구분 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 4 | |
+| PRDY_CTRT | 등락율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 8 | |
+| STCK_OPRC | 시가 | string | Y | 4 | |
+| STCK_HGPR | 고가 | string | Y | 4 | |
+| STCK_LWPR | 저가 | string | Y | 4 | |
+| ASKP1 | 매도호가 | string | Y | 4 | |
+| BIDP1 | 매수호가 | string | Y | 4 | |
+| CNTG_VOL | 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 4 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 4 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 4 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 8 | |
+| HOUR_CLS_CODE | 시간구분코드 | string | Y | 1 | |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+| VI_STND_PRC | VI 상태값 | string | Y | 4 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/185_실시간-047_국내주식-실시간회원사-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/185_실시간-047_국내주식-실시간회원사-KRX.md
new file mode 100644
index 0000000..af0c61e
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/185_실시간-047_국내주식-실시간회원사-KRX.md
@@ -0,0 +1,196 @@
+# 국내주식 실시간회원사 (KRX)
+
+- 원본 시트명: 국내주식 실시간회원사 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-047
+- HTTP Method: POST
+- 실전 TR_ID: H0STMBC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STMBC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | H0STMBC0 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| SELN2_MBCR_NAME1 | 매도2회원사명1 | string | Y | 16 | |
+| SELN2_MBCR_NAME2 | 매도2회원사명2 | string | Y | 16 | |
+| SELN2_MBCR_NAME3 | 매도2회원사명3 | string | Y | 16 | |
+| SELN2_MBCR_NAME4 | 매도2회원사명4 | string | Y | 16 | |
+| SELN2_MBCR_NAME5 | 매도2회원사명5 | string | Y | 16 | |
+| BYOV_MBCR_NAME1 | 매수회원사명1 | string | Y | 16 | |
+| BYOV_MBCR_NAME2 | 매수회원사명2 | string | Y | 16 | |
+| BYOV_MBCR_NAME3 | 매수회원사명3 | string | Y | 16 | |
+| BYOV_MBCR_NAME4 | 매수회원사명4 | string | Y | 16 | |
+| BYOV_MBCR_NAME5 | 매수회원사명5 | string | Y | 16 | |
+| TOTAL_SELN_QTY1 | 총매도수량1 | string | Y | 8 | |
+| TOTAL_SELN_QTY2 | 총매도수량2 | string | Y | 8 | |
+| TOTAL_SELN_QTY3 | 총매도수량3 | string | Y | 8 | |
+| TOTAL_SELN_QTY4 | 총매도수량4 | string | Y | 8 | |
+| TOTAL_SELN_QTY5 | 총매도수량5 | string | Y | 8 | |
+| TOTAL_SHNU_QTY1 | 총매수2수량1 | string | Y | 8 | |
+| TOTAL_SHNU_QTY2 | 총매수2수량2 | string | Y | 8 | |
+| TOTAL_SHNU_QTY3 | 총매수2수량3 | string | Y | 8 | |
+| TOTAL_SHNU_QTY4 | 총매수2수량4 | string | Y | 8 | |
+| TOTAL_SHNU_QTY5 | 총매수2수량5 | string | Y | 8 | |
+| SELN_MBCR_GLOB_YN_1 | 매도거래원구분1 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_2 | 매도거래원구분2 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_3 | 매도거래원구분3 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_4 | 매도거래원구분4 | string | Y | 1 | |
+| SELN_MBCR_GLOB_YN_5 | 매도거래원구분5 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_1 | 매수거래원구분1 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_2 | 매수거래원구분2 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_3 | 매수거래원구분3 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_4 | 매수거래원구분4 | string | Y | 1 | |
+| SHNU_MBCR_GLOB_YN_5 | 매수거래원구분5 | string | Y | 1 | |
+| SELN_MBCR_NO1 | 매도거래원코드1 | string | Y | 5 | |
+| SELN_MBCR_NO2 | 매도거래원코드2 | string | Y | 5 | |
+| SELN_MBCR_NO3 | 매도거래원코드3 | string | Y | 5 | |
+| SELN_MBCR_NO4 | 매도거래원코드4 | string | Y | 5 | |
+| SELN_MBCR_NO5 | 매도거래원코드5 | string | Y | 5 | |
+| SHNU_MBCR_NO1 | 매수거래원코드1 | string | Y | 5 | |
+| SHNU_MBCR_NO2 | 매수거래원코드2 | string | Y | 5 | |
+| SHNU_MBCR_NO3 | 매수거래원코드3 | string | Y | 5 | |
+| SHNU_MBCR_NO4 | 매수거래원코드4 | string | Y | 5 | |
+| SHNU_MBCR_NO5 | 매수거래원코드5 | string | Y | 5 | |
+| SELN_MBCR_RLIM1 | 매도회원사비중1 | string | Y | 8 | |
+| SELN_MBCR_RLIM2 | 매도회원사비중2 | string | Y | 8 | |
+| SELN_MBCR_RLIM3 | 매도회원사비중3 | string | Y | 8 | |
+| SELN_MBCR_RLIM4 | 매도회원사비중4 | string | Y | 8 | |
+| SELN_MBCR_RLIM5 | 매도회원사비중5 | string | Y | 8 | |
+| SHNU_MBCR_RLIM1 | 매수2회원사비중1 | string | Y | 8 | |
+| SHNU_MBCR_RLIM2 | 매수2회원사비중2 | string | Y | 8 | |
+| SHNU_MBCR_RLIM3 | 매수2회원사비중3 | string | Y | 8 | |
+| SHNU_MBCR_RLIM4 | 매수2회원사비중4 | string | Y | 8 | |
+| SHNU_MBCR_RLIM5 | 매수2회원사비중5 | string | Y | 8 | |
+| SELN_QTY_ICDC1 | 매도수량증감1 | string | Y | 4 | |
+| SELN_QTY_ICDC2 | 매도수량증감2 | string | Y | 4 | |
+| SELN_QTY_ICDC3 | 매도수량증감3 | string | Y | 4 | |
+| SELN_QTY_ICDC4 | 매도수량증감4 | string | Y | 4 | |
+| SELN_QTY_ICDC5 | 매도수량증감5 | string | Y | 4 | |
+| SHNU_QTY_ICDC1 | 매수2수량증감1 | string | Y | 4 | |
+| SHNU_QTY_ICDC2 | 매수2수량증감2 | string | Y | 4 | |
+| SHNU_QTY_ICDC3 | 매수2수량증감3 | string | Y | 4 | |
+| SHNU_QTY_ICDC4 | 매수2수량증감4 | string | Y | 4 | |
+| SHNU_QTY_ICDC5 | 매수2수량증감5 | string | Y | 4 | |
+| GLOB_TOTAL_SELN_QTY | 외국계총매도수량 | string | Y | 8 | |
+| GLOB_TOTAL_SHNU_QTY | 외국계총매수2수량 | string | Y | 8 | |
+| GLOB_TOTAL_SELN_QTY_ICDC | 외국계총매도수량증감 | string | Y | 4 | |
+| GLOB_TOTAL_SHNU_QTY_ICDC | 외국계총매수2수량증감 | string | Y | 4 | |
+| GLOB_NTBY_QTY | 외국계순매수수량 | string | Y | 8 | |
+| GLOB_SELN_RLIM | 외국계매도비중 | string | Y | 8 | |
+| GLOB_SHNU_RLIM | 외국계매수2비중 | string | Y | 8 | |
+| SELN2_MBCR_ENG_NAME1 | 매도2영문회원사명1 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME2 | 매도2영문회원사명2 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME3 | 매도2영문회원사명3 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME4 | 매도2영문회원사명4 | string | Y | 20 | |
+| SELN2_MBCR_ENG_NAME5 | 매도2영문회원사명5 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME1 | 매수영문회원사명1 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME2 | 매수영문회원사명2 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME3 | 매수영문회원사명3 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME4 | 매수영문회원사명4 | string | Y | 20 | |
+| BYOV_MBCR_ENG_NAME5 | 매수영문회원사명5 | string | Y | 20 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "H0STMBC0",
+ "tr_key": "005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STMBC0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STMBC0|001|005930^씨티그룹^미래에셋증권^모간서울^BNK증권^키움증권^미래
+에셋증권^BNK증권^맥쿼리^NH투자증권^한국증권^903482^703873^484082^471203^246578^946273^571760^
+343109^313536^311982^Y^N^Y^N^N^N^N^Y^N^N^00037^00005^00036^00086^00050^00005^00086^00035^0001
+2^00003^19.06^14.85^10.21^9.94^5.20^19.96^12.06^7.24^6.61^6.58^14913^5054^7240^80000^3532^280
+24^42986^0^5612^3043^1387564^681749^22153^0^-705815^29.27^14.38^^^^^^^^^^
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/186_국내주식-실시간예상체결-통합_국내주식-실시간예상체결-통합.md b/docs/broker/kis/websocket/국내주식/실시간시세/186_국내주식-실시간예상체결-통합_국내주식-실시간예상체결-통합.md
new file mode 100644
index 0000000..085f683
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/186_국내주식-실시간예상체결-통합_국내주식-실시간예상체결-통합.md
@@ -0,0 +1,96 @@
+# 국내주식 실시간예상체결 (통합)
+
+- 원본 시트명: 국내주식 실시간예상체결 (통합)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 국내주식 실시간예상체결 (통합)
+- HTTP Method: POST
+- 실전 TR_ID: H0UNANC0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0UNANC0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인
P : 개인 |
+| tr_type | 거래타입 | string | Y | 1 | 1 : 등록
2 : 해제 |
+| content-type | 컨텐츠타입 | string | Y | 1 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | [실전투자]
H0UNANC0 : 국내주식 실시간예상체결 (통합) |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 4 | |
+| PRDY_VRSS_SIGN | 전일대비구분 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 4 | |
+| PRDY_CTRT | 등락율 | string | Y | 8 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 8 | |
+| STCK_OPRC | 시가 | string | Y | 4 | |
+| STCK_HGPR | 고가 | string | Y | 4 | |
+| STCK_LWPR | 저가 | string | Y | 4 | |
+| ASKP1 | 매도호가 | string | Y | 4 | |
+| BIDP1 | 매수호가 | string | Y | 4 | |
+| CNTG_VOL | 거래량 | string | Y | 8 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 8 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 4 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 4 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 4 | |
+| CTTR | 체결강도 | string | Y | 8 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 8 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 8 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 8 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 8 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 4 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 4 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 4 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 8 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 8 | |
+| HOUR_CLS_CODE | 시간구분코드 | string | Y | 1 | |
+| MRKT_TRTM_CLS_CODE | 임의종료구분코드 | string | Y | 1 | |
+| VI_STND_PRC | VI 상태값 | string | Y | 4 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/188_실시간-051_국내ETF-NAV추이.md b/docs/broker/kis/websocket/국내주식/실시간시세/188_실시간-051_국내ETF-NAV추이.md
new file mode 100644
index 0000000..53324dc
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/188_실시간-051_국내ETF-NAV추이.md
@@ -0,0 +1,109 @@
+# 국내ETF NAV추이
+
+- 원본 시트명: 국내ETF NAV추이
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-051
+- HTTP Method: POST
+- 실전 TR_ID: H0STNAV0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STNAV0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0STNAV0 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex. 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| NAV | NAV | string | Y | 8 | |
+| NAV_PRDY_VRSS_SIGN | NAV전일대비부호 | string | Y | 1 | |
+| NAV_PRDY_VRSS | NAV전일대비 | string | Y | 8 | |
+| NAV_PRDY_CTRT | NAV전일대비율 | string | Y | 8 | |
+| OPRC_NAV | NAV시가 | string | Y | 8 | |
+| HPRC_NAV | NAV고가 | string | Y | 8 | |
+| LPRC_NAV | NAV저가 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STNAV0",
+ "tr_key":"069500"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STNAV0",
+ "tr_key": "069500",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STNAV0|001|069500^37235.46^5^-381.26^-1.01^37646.25^37646.25^37202.10
+```
diff --git a/docs/broker/kis/websocket/국내주식/실시간시세/189_실시간-042_국내주식-시간외-실시간체결가-KRX.md b/docs/broker/kis/websocket/국내주식/실시간시세/189_실시간-042_국내주식-시간외-실시간체결가-KRX.md
new file mode 100644
index 0000000..f332851
--- /dev/null
+++ b/docs/broker/kis/websocket/국내주식/실시간시세/189_실시간-042_국내주식-시간외-실시간체결가-KRX.md
@@ -0,0 +1,166 @@
+# 국내주식 시간외 실시간체결가 (KRX)
+
+- 원본 시트명: 국내주식 시간외 실시간체결가 (KRX)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [국내주식] 실시간시세
+- API ID: 실시간-042
+- HTTP Method: POST
+- 실전 TR_ID: H0STOUP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0STOUP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+국내주식 시간외 실시간체결가 API입니다.
+국내주식 시간외 단일가(16:00~18:00) 시간대에 실시간체결가 데이터 확인 가능합니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0STOUP0 |
+| tr_key | 구분값 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| MKSC_SHRN_ISCD | 유가증권단축종목코드 | string | Y | 9 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| STCK_PRPR | 주식현재가 | string | Y | 1 | |
+| PRDY_VRSS_SIGN | 전일대비구분 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 1 | |
+| PRDY_CTRT | 등락율 | string | Y | 1 | |
+| WGHN_AVRG_STCK_PRC | 가중평균주식가격 | string | Y | 1 | |
+| STCK_OPRC | 시가 | string | Y | 1 | |
+| STCK_HGPR | 고가 | string | Y | 1 | |
+| STCK_LWPR | 저가 | string | Y | 1 | |
+| ASKP1 | 매도호가 | string | Y | 1 | |
+| BIDP1 | 매수호가 | string | Y | 1 | |
+| CNTG_VOL | 거래량 | string | Y | 1 | |
+| ACML_VOL | 누적거래량 | string | Y | 1 | |
+| ACML_TR_PBMN | 누적거래대금 | string | Y | 1 | |
+| SELN_CNTG_CSNU | 매도체결건수 | string | Y | 1 | |
+| SHNU_CNTG_CSNU | 매수체결건수 | string | Y | 1 | |
+| NTBY_CNTG_CSNU | 순매수체결건수 | string | Y | 1 | |
+| CTTR | 체결강도 | string | Y | 1 | |
+| SELN_CNTG_SMTN | 총매도수량 | string | Y | 1 | |
+| SHNU_CNTG_SMTN | 총매수수량 | string | Y | 1 | |
+| CNTG_CLS_CODE | 체결구분 | string | Y | 1 | |
+| SHNU_RATE | 매수비율 | string | Y | 1 | |
+| PRDY_VOL_VRSS_ACML_VOL_RATE | 전일거래량대비등락율 | string | Y | 1 | |
+| OPRC_HOUR | 시가시간 | string | Y | 6 | |
+| OPRC_VRSS_PRPR_SIGN | 시가대비구분 | string | Y | 1 | |
+| OPRC_VRSS_PRPR | 시가대비 | string | Y | 1 | |
+| HGPR_HOUR | 최고가시간 | string | Y | 6 | |
+| HGPR_VRSS_PRPR_SIGN | 고가대비구분 | string | Y | 1 | |
+| HGPR_VRSS_PRPR | 고가대비 | string | Y | 1 | |
+| LWPR_HOUR | 최저가시간 | string | Y | 6 | |
+| LWPR_VRSS_PRPR_SIGN | 저가대비구분 | string | Y | 1 | |
+| LWPR_VRSS_PRPR | 저가대비 | string | Y | 1 | |
+| BSOP_DATE | 영업일자 | string | Y | 8 | |
+| NEW_MKOP_CLS_CODE | 신장운영구분코드 | string | Y | 2 | |
+| TRHT_YN | 거래정지여부 | string | Y | 1 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 1 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 1 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 1 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 1 | |
+| VOL_TNRT | 거래량회전율 | string | Y | 1 | |
+| PRDY_SMNS_HOUR_ACML_VOL | 전일동시간누적거래량 | string | Y | 1 | |
+| PRDY_SMNS_HOUR_ACML_VOL_RATE | 전일동시간누적거래량비율 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0STOUP0",
+ "tr_key":"005930"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0STOUP0",
+ "tr_key": "005930",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|H0STOUP0|001|005930^165020^77700^2^100^0.13^78209.85^77600^77800^77
+600^77800^77700^1034^13540^1052379900^3^2^-1^71.12^8029^5511^5^0.37^69.15^161015^3^100^
+162004^5^-100^161015^3^100^20240503^40^N^7898^6461^24577^38548^0.00^18636724^0.07
+```
diff --git a/docs/broker/kis/websocket/장내채권/실시간시세/335_실시간-052_일반채권-실시간체결가.md b/docs/broker/kis/websocket/장내채권/실시간시세/335_실시간-052_일반채권-실시간체결가.md
new file mode 100644
index 0000000..3abf717
--- /dev/null
+++ b/docs/broker/kis/websocket/장내채권/실시간시세/335_실시간-052_일반채권-실시간체결가.md
@@ -0,0 +1,162 @@
+# 일반채권 실시간체결가
+
+- 원본 시트명: 일반채권 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [장내채권] 실시간시세
+- API ID: 실시간-052
+- HTTP Method: POST
+- 실전 TR_ID: H0BJCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0BJCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+일반채권 실시간체결가 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0BJCNT0 |
+| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| STND_ISCD | 표준종목코드 | string | Y | 12 | |
+| BOND_ISNM | 채권종목명 | string | Y | 80 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| PRDY_VRSS_SIGN | 전일대비부호 | string | Y | 1 | |
+| PRDY_VRSS | 전일대비 | string | Y | 8 | |
+| PRDY_CTRT | 전일대비율 | string | Y | 8 | |
+| STCK_PRPR | 현재가 | string | Y | 8 | |
+| CNTG_VOL | 체결거래량 | string | Y | 8 | |
+| STCK_OPRC | 시가 | string | Y | 8 | |
+| STCK_HGPR | 고가 | string | Y | 8 | |
+| STCK_LWPR | 저가 | string | Y | 8 | |
+| STCK_PRDY_CLPR | 전일종가 | string | Y | 8 | |
+| BOND_CNTG_ERT | 현재수익률 | string | Y | 10 | |
+| OPRC_ERT | 시가수익률 | string | Y | 10 | |
+| HGPR_ERT | 고가수익률 | string | Y | 10 | |
+| LWPR_ERT | 저가수익률 | string | Y | 10 | |
+| ACML_VOL | 누적거래량 | string | Y | 8 | |
+| PRDY_VOL | 전일거래량 | string | Y | 8 | |
+| CNTG_TYPE_CLS_CODE | 체결유형코드 | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0BJCNT0",
+ "tr_key":"KR103502GD31"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0BJCNT0",
+ "tr_key": "KR103502GD31",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output - 정제 전
+0|H0BJCNT0|001|KR103502GD31^국고03250-5303(23-2)^131743^2^5.00^0.05^10575.00^1^10525.00^10578.00^10525.00^0.00^3.012^3.037^3.010^3.037^659
+4124^9874082^2
+
+# output - 정제 후
+#### 장내채권 체결 ####
+============================================
+### [1 / 1]
+표준종목코드 [KR103502GD31]
+채권종목명 [국고03250-5303(23-2)]
+주식체결시간 [131743]
+전일대비부호 [2]
+전일대비 [5.00]
+전일대비율 [0.05]
+현재가 [10575.00]
+체결거래량 [1]
+시가 [10525.00]
+고가 [10578.00]
+저가 [10525.00]
+전일종가 [0.00]
+현재수익률 [3.012]
+시가수익률 [3.037]
+고가수익률 [3.010]
+저가수익률 [3.037]
+누적거래량 [6594124]
+전일거래량 [9874082]
+체결유형코드 [2]
+```
diff --git a/docs/broker/kis/websocket/장내채권/실시간시세/336_실시간-053_일반채권-실시간호가.md b/docs/broker/kis/websocket/장내채권/실시간시세/336_실시간-053_일반채권-실시간호가.md
new file mode 100644
index 0000000..779afa9
--- /dev/null
+++ b/docs/broker/kis/websocket/장내채권/실시간시세/336_실시간-053_일반채권-실시간호가.md
@@ -0,0 +1,172 @@
+# 일반채권 실시간호가
+
+- 원본 시트명: 일반채권 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [장내채권] 실시간시세
+- API ID: 실시간-053
+- HTTP Method: POST
+- 실전 TR_ID: H0BJCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0BJASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+일반채권 실시간호가 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| custtype | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0BJCNT0 |
+| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| STND_ISCD | 표준종목코드 | string | Y | 12 | |
+| STCK_CNTG_HOUR | 주식체결시간 | string | Y | 6 | |
+| ASKP_ERT1 | 매도호가수익률 | string | Y | 10 | |
+| BIDP_ERT1 | 매수호가수익률1 | string | Y | 10 | |
+| ASKP1 | 매도호가1 | string | Y | 8 | |
+| BIDP1 | 매수호가1 | string | Y | 8 | |
+| ASKP_RSQN1 | 매도호가잔량1 | string | Y | 8 | |
+| BIDP_RSQN1 | 매수호가잔량1 | string | Y | 8 | |
+| ASKP_ERT2 | 매도호가수익률2 | string | Y | 10 | |
+| BIDP_ERT2 | 매수호가수익률2 | string | Y | 10 | |
+| ASKP2 | 매도호가2 | string | Y | 8 | |
+| BIDP2 | 매수호가2 | string | Y | 8 | |
+| ASKP_RSQN2 | 매도호가잔량2 | string | Y | 8 | |
+| BIDP_RSQN2 | 매수호가잔량2 | string | Y | 8 | |
+| ASKP_ERT3 | 매도호가수익률3 | string | Y | 10 | |
+| BIDP_ERT3 | 매수호가수익률3 | string | Y | 10 | |
+| ASKP3 | 매도호가3 | string | Y | 8 | |
+| BIDP3 | 매수호가3 | string | Y | 8 | |
+| ASKP_RSQN3 | 매도호가잔량3 | string | Y | 8 | |
+| BIDP_RSQN3 | 매수호가잔량3 | string | Y | 8 | |
+| ASKP_ERT4 | 매도호가수익률4 | string | Y | 10 | |
+| BIDP_ERT4 | 매수호가수익률4 | string | Y | 10 | |
+| ASKP4 | 매도호가4 | string | Y | 8 | |
+| BIDP4 | 매수호가4 | string | Y | 8 | |
+| ASKP_RSQN4 | 매도호가잔량4 | string | Y | 8 | |
+| BIDP_RSQN4 | 매수호가잔량4 | string | Y | 8 | |
+| ASKP_ERT5 | 매도호가수익률5 | string | Y | 10 | |
+| BIDP_ERT5 | 매수호가수익률5 | string | Y | 10 | |
+| ASKP5 | 매도호가5 | string | Y | 8 | |
+| BIDP5 | 매수호가5 | string | Y | 8 | |
+| ASKP_RSQN52 | 매도호가잔량5 | string | Y | 8 | |
+| BIDP_RSQN53 | 매수호가잔량5 | string | Y | 8 | |
+| TOTAL_ASKP_RSQN | 총매도호가잔량 | string | Y | 8 | |
+| TOTAL_BIDP_RSQN | 총매수호가잔량 | string | Y | 8 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0BJASP0",
+ "tr_key":"KR103502GD31"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0BJASP0",
+ "tr_key": "KR103502GD31",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output - 정제 전
+0|H0BJASP0|001|KR103502GD31^131743^3.012^3.020^10575.00^10560.00^416090^323813^3.011^3.022^10576.00^10556.00^405284^57^3.010^3.022^10578.0
+0^10555.00^177098^500000^3.009^3.024^10580.00^10551.00^97637^363079^3.001^3.025^10597.00^10550.00^80000^379920^1698609^4112382
+
+# output - 정제 후
+#### 장내채권 호가 ####
+채권종목코드 [KR103502GD31]
+영업시간 [131743]
+====================================
+채권매도호가1 [10575.00], 매도호가수익률1 [3.012], 매도호가잔량1 [416090]
+채권매도호가2 [10576.00], 매도호가수익률2 [3.011], 매도호가잔량2 [405284]
+채권매도호가3 [10578.00], 매도호가수익률3 [3.010], 매도호가잔량3 [177098]
+채권매도호가4 [10580.00], 매도호가수익률4 [3.009], 매도호가잔량4 [97637]
+채권매도호가5 [10597.00], 매도호가수익률5 [3.001], 매도호가잔량5 [80000]
+채권매수호가1 [10560.00], 매수호가수익률1 [3.020], 매수호가잔량1 [323813]
+채권매수호가2 [10556.00], 매수호가수익률2 [3.022], 매수호가잔량2 [57]
+채권매수호가3 [10555.00], 매수호가수익률3 [3.022], 매수호가잔량3 [500000]
+채권매수호가4 [10551.00], 매수호가수익률4 [3.024], 매수호가잔량4 [363079]
+채권매수호가5 [10550.00], 매수호가수익률5 [3.025], 매수호가잔량5 [379920]
+====================================
+총매도호가잔량 [1698609]
+총매수호가잔량 [4112382]
+```
diff --git a/docs/broker/kis/websocket/장내채권/실시간시세/337_실시간-060_채권지수-실시간체결가.md b/docs/broker/kis/websocket/장내채권/실시간시세/337_실시간-060_채권지수-실시간체결가.md
new file mode 100644
index 0000000..cc340fe
--- /dev/null
+++ b/docs/broker/kis/websocket/장내채권/실시간시세/337_실시간-060_채권지수-실시간체결가.md
@@ -0,0 +1,163 @@
+# 채권지수 실시간체결가
+
+- 원본 시트명: 채권지수 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [장내채권] 실시간시세
+- API ID: 실시간-060
+- HTTP Method: POST
+- 실전 TR_ID: H0BICNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/H0BICNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+채권지수 실시간체결가 API입니다.
+
+[참고자료]
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
+
+[호출 데이터]
+헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
+
+[응답 데이터]
+1. 정상 등록 여부 (JSON)
+- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
+- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
+- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
+
+2. 실시간 결과 응답 ( | 로 구분되는 값)
+ex) 0|H0STCNT0|004|005930^123929^73100^5^...
+- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
+- TR_ID : 등록한 tr_id (ex. H0STCNT0)
+- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
+- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 2 | H0BICNT0 |
+| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| NMIX_ID | 지수ID | string | Y | 6 | |
+| STND_DATE1 | 기준일자1 | string | Y | 8 | |
+| TRNM_HOUR | 전송시간 | string | Y | 6 | |
+| TOTL_ERNN_NMIX_OPRC | 총수익지수시가지수 | string | Y | 1 | |
+| TOTL_ERNN_NMIX_HGPR | 총수익지수최고가 | string | Y | 1 | |
+| TOTL_ERNN_NMIX_LWPR | 총수익지수최저가 | string | Y | 1 | |
+| TOTL_ERNN_NMIX | 총수익지수 | string | Y | 1 | |
+| PRDY_TOTL_ERNN_NMIX | 전일총수익지수 | string | Y | 1 | |
+| TOTL_ERNN_NMIX_PRDY_VRSS | 총수익지수전일대비 | string | Y | 1 | |
+| TOTL_ERNN_NMIX_PRDY_VRSS_SIGN | 총수익지수전일대비부호 | string | Y | 1 | |
+| TOTL_ERNN_NMIX_PRDY_CTRT | 총수익지수전일대비율 | string | Y | 1 | |
+| CLEN_PRC_NMIX | 순가격지수 | string | Y | 1 | |
+| MRKT_PRC_NMIX | 시장가격지수 | string | Y | 1 | |
+| BOND_CALL_RNVS_NMIX | Call재투자지수 | string | Y | 1 | |
+| BOND_ZERO_RNVS_NMIX | Zero재투자지수 | string | Y | 1 | |
+| BOND_FUTS_THPR | 선물이론가격 | string | Y | 1 | |
+| BOND_AVRG_DRTN_VAL | 평균듀레이션 | string | Y | 1 | |
+| BOND_AVRG_CNVX_VAL | 평균컨벡서티 | string | Y | 1 | |
+| BOND_AVRG_YTM_VAL | 평균YTM | string | Y | 1 | |
+| BOND_AVRG_FRDL_YTM_VAL | 평균선도YTM | string | Y | 1 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0BICNT0",
+ "tr_key":"KBPR01"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "H0BICNT0",
+ "tr_key": "KBPR01",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output - 정제 전
+0|H0BICNT0|001|KBPR01^20240726^131500^163.55^163.56^163.52^163.54^163.53^0.00^2^0.00^98.92^99.50^163.54^161.83^0.00^9.45^181.22^3.07^0.00
+
+# output - 정제 후
+#### 채권지수 체결 ####
+============================================
+### [1 / 1]
+지수ID [KBPR01]
+기준일자1 [20240726]
+전송시간 [131500]
+총수익지수시가지수 [163.55]
+총수익지수최고가 [163.56]
+총수익지수최저가 [163.52]
+총수익지수 [163.54]
+전일총수익지수 [163.53]
+총수익지수전일대비 [0.00]
+총수익지수전일대비부호 [2]
+총수익지수전일대비율 [0.00]
+순가격지수 [98.92]
+시장가격지수 [99.50]
+Call재투자지수 [163.54]
+Zero재투자지수 [161.83]
+선물이론가격 [0.00]
+평균듀레이션 [9.45]
+평균컨벡서티 [181.22]
+평균YTM [3.07]
+평균선도YTM [0.00]
+```
diff --git a/docs/broker/kis/websocket/해외선물옵션/실시간시세/316_실시간-017_해외선물옵션-실시간체결가.md b/docs/broker/kis/websocket/해외선물옵션/실시간시세/316_실시간-017_해외선물옵션-실시간체결가.md
new file mode 100644
index 0000000..f6235c0
--- /dev/null
+++ b/docs/broker/kis/websocket/해외선물옵션/실시간시세/316_실시간-017_해외선물옵션-실시간체결가.md
@@ -0,0 +1,106 @@
+# 해외선물옵션 실시간체결가
+
+- 원본 시트명: 해외선물옵션 실시간체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외선물옵션]실시간시세
+- API ID: 실시간-017
+- HTTP Method: POST
+- 실전 TR_ID: HDFFF020
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFFF020
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ CME, SGX 실시간시세 유료시세 신청 필수 (포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
+- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
+ 접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
+- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
+ 등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
+
+
+(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드 - 해외선물옵션 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFFF020 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드
※ CME, SGX 실시간시세 유료시세 신청 필수
"포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)" |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SERIES_CD | 종목코드 | string | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| BSNS_DATE | 영업일자 | string | Y | 8 | |
+| MRKT_OPEN_DATE | 장개시일자 | string | Y | 8 | |
+| MRKT_OPEN_TIME | 장개시시각 | string | Y | 6 | |
+| MRKT_CLOSE_DATE | 장종료일자 | string | Y | 8 | |
+| MRKT_CLOSE_TIME | 장종료시각 | string | Y | 6 | |
+| PREV_PRICE | 전일종가 | string | Y | 15 | 전일종가, 체결가격, 전일대비가, 시가, 고가, 저가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| RECV_DATE | 수신일자 | string | Y | 8 | |
+| RECV_TIME | 수신시각 | string | Y | 6 | 수신시각(recv_time) = 실제 체결시각 |
+| ACTIVE_FLAG | 본장_전산장구분 | string | Y | 1 | |
+| LAST_PRICE | 체결가격 | string | Y | 15 | |
+| LAST_QNTT | 체결수량 | string | Y | 10 | |
+| PREV_DIFF_PRICE | 전일대비가 | string | Y | 15 | |
+| PREV_DIFF_RATE | 등락률 | string | Y | 10 | |
+| OPEN_PRICE | 시가 | string | Y | 15 | |
+| HIGH_PRICE | 고가 | string | Y | 15 | |
+| LOW_PRICE | 저가 | string | Y | 15 | |
+| VOL | 누적거래량 | string | Y | 10 | |
+| PREV_SIGN | 전일대비부호 | string | Y | 1 | |
+| QUOTSIGN | 체결구분 | string | Y | 1 | 2:매수체결 5:매도체결 |
+| RECV_TIME2 | 수신시각2 만분의일초 | string | Y | 4 | |
+| PSTTL_PRICE | 전일정산가 | string | Y | 15 | |
+| PSTTL_SIGN | 전일정산가대비 | string | Y | 1 | |
+| PSTTL_DIFF_PRICE | 전일정산가대비가격 | string | Y | 15 | |
+| PSTTL_DIFF_RATE | 전일정산가대비율 | string | Y | 10 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외선물옵션/실시간시세/317_실시간-018_해외선물옵션-실시간호가.md b/docs/broker/kis/websocket/해외선물옵션/실시간시세/317_실시간-018_해외선물옵션-실시간호가.md
new file mode 100644
index 0000000..2b4bb0c
--- /dev/null
+++ b/docs/broker/kis/websocket/해외선물옵션/실시간시세/317_실시간-018_해외선물옵션-실시간호가.md
@@ -0,0 +1,115 @@
+# 해외선물옵션 실시간호가
+
+- 원본 시트명: 해외선물옵션 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외선물옵션]실시간시세
+- API ID: 실시간-018
+- HTTP Method: POST
+- 실전 TR_ID: HDFFF010
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFFF010
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+※ CME, SGX 실시간시세 유료시세 신청 필수 (포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
+- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
+ 접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
+- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
+ 등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
+
+(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+ 1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제
+ https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+
+ 2) 혹은 포럼 - FAQ - 종목정보 다운로드 - 해외선물옵션 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+ Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+ EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+ 품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+ 품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFFF010 |
+| tr_key | 종목코드 | string | Y | 6 | 종목코드
※ CME, SGX 실시간시세 유료시세 신청 필수
"포럼 > FAQ > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)" |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| SERIES_CD | 종목코드 | object | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| RECV_DATE | 수신일자 | string | Y | 8 | |
+| RECV_TIME | 수신시각 | string | Y | 12 | |
+| PREV_PRICE | 전일종가 | string | Y | 15 | 전일종가, 매수1호가~매도5호가
※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| BID_QNTT_1 | 매수1수량 | string | Y | 10 | |
+| BID_NUM_1 | 매수1번호 | string | Y | 10 | |
+| BID_PRICE_1 | 매수1호가 | string | Y | 15 | |
+| ASK_QNTT_1 | 매도1수량 | string | Y | 10 | |
+| ASK_NUM_1 | 매도1번호 | string | Y | 10 | |
+| ASK_PRICE_1 | 매도1호가 | string | Y | 15 | |
+| BID_QNTT_2 | 매수2수량 | string | Y | 10 | |
+| BID_NUM_2 | 매수2번호 | string | Y | 10 | |
+| BID_PRICE_2 | 매수2호가 | string | Y | 15 | |
+| ASK_QNTT_2 | 매도2수량 | string | Y | 10 | |
+| ASK_NUM_2 | 매도2번호 | string | Y | 10 | |
+| ASK_PRICE_2 | 매도2호가 | string | Y | 15 | |
+| BID_QNTT_3 | 매수3수량 | string | Y | 10 | |
+| BID_NUM_3 | 매수3번호 | string | Y | 10 | |
+| BID_PRICE_3 | 매수3호가 | string | Y | 15 | |
+| ASK_QNTT_3 | 매도3수량 | string | Y | 10 | |
+| ASK_NUM_3 | 매도3번호 | string | Y | 10 | |
+| ASK_PRICE_3 | 매도3호가 | string | Y | 15 | |
+| BID_QNTT_4 | 매수4수량 | string | Y | 10 | |
+| BID_NUM_4 | 매수4번호 | string | Y | 10 | |
+| BID_PRICE_4 | 매수4호가 | string | Y | 15 | |
+| ASK_QNTT_4 | 매도4수량 | string | Y | 10 | |
+| ASK_NUM_4 | 매도4번호 | string | Y | 10 | |
+| ASK_PRICE_4 | 매도4호가 | string | Y | 15 | |
+| BID_QNTT_5 | 매수5수량 | string | Y | 10 | |
+| BID_NUM_5 | 매수5번호 | string | Y | 10 | |
+| BID_PRICE_5 | 매수5호가 | string | Y | 15 | |
+| ASK_QNTT_5 | 매도5수량 | string | Y | 10 | |
+| ASK_NUM_5 | 매도5번호 | string | Y | 10 | |
+| ASK_PRICE_5 | 매도5호가 | string | Y | 15 | |
+| STTL_PRICE | 전일정산가 | string | Y | 15 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외선물옵션/실시간시세/318_실시간-019_해외선물옵션-실시간주문내역통보.md b/docs/broker/kis/websocket/해외선물옵션/실시간시세/318_실시간-019_해외선물옵션-실시간주문내역통보.md
new file mode 100644
index 0000000..133b702
--- /dev/null
+++ b/docs/broker/kis/websocket/해외선물옵션/실시간시세/318_실시간-019_해외선물옵션-실시간주문내역통보.md
@@ -0,0 +1,92 @@
+# 해외선물옵션 실시간주문내역통보
+
+- 원본 시트명: 해외선물옵션 실시간주문내역통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외선물옵션]실시간시세
+- API ID: 실시간-019
+- HTTP Method: POST
+- 실전 TR_ID: HDFFF1C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFFF1C0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFFF1C0 |
+| tr_key | HTSID | string | Y | 8 | HTSID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| USER_ID | 유저ID | object | Y | 8 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| ACCT_NO | 계좌번호 | string | Y | 10 | |
+| ORD_DT | 주문일자 | string | Y | 8 | |
+| ODNO | 주문번호 | string | Y | 10 | |
+| ORGN_ORD_DT | 원주문일자 | string | Y | 8 | |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | |
+| SERIES | 종목명 | string | Y | 32 | |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 해당없음 : 00 , 정정 : 01 , 취소 : 02 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도, 02 : 매수 |
+| CPLX_ORD_DVSN_CD | 복합주문구분코드 | string | Y | 1 | 0 (hedge청산만 이용) |
+| PRCE_TP | 가격구분코드 | string | Y | 1 | 1:Limit, 2:Market, 3:Stop(Stop가격시 시장가) |
+| FM_EXCG_RCIT_DVSN_CD | FM거래소접수구분코드 | string | Y | 2 | 01:접수전, 02:응답, 03:거부 |
+| ORD_QTY | 주문수량 | string | Y | 18 | |
+| FM_LMT_PRIC | FMLIMIT가격 | string | Y | 21 | |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | Y | 21 | |
+| TOT_CCLD_QTY | 총체결수량 | string | Y | 18 | |
+| TOT_CCLD_UV | 총체결단가 | string | Y | 21 | |
+| ORD_REMQ | 잔량 | string | Y | 21 | |
+| FM_ORD_GRP_DT | FM주문그룹일자 | string | Y | 8 | 주문일자(ORD_DT)와 동일 |
+| ORD_GRP_STNO | 주문그룹번호 | string | Y | 12 | |
+| ORD_DTL_DTIME | 주문상세일시 | string | Y | 17 | |
+| OPRT_DTL_DTIME | 조작상세일시 | string | Y | 17 | |
+| WORK_EMPL | 주문자 | string | Y | 8 | |
+| CRCY_CD | 통화코드 | string | Y | 3 | |
+| LQD_YN | 청산여부(Y/N) | string | Y | 1 | |
+| LQD_LMT_PRIC | 청산LIMIT가격 | string | Y | 21 | |
+| LQD_STOP_PRIC | 청산STOP가격 | string | Y | 21 | |
+| TRD_COND | 체결조건코드 | string | Y | 1 | |
+| TERM_ORD_VALD_DTIME | 기간주문유효상세일시 | string | Y | 17 | |
+| SPEC_TP | 계좌청산유형구분코드 | string | Y | 1 | |
+| ECIS_RSVN_ORD_YN | 행사예약주문여부 | string | Y | 1 | |
+| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | Y | 2 | |
+| AUTO_ORD_DVSN_CD | 자동주문 전략구분 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외선물옵션/실시간시세/319_실시간-020_해외선물옵션-실시간체결내역통보.md b/docs/broker/kis/websocket/해외선물옵션/실시간시세/319_실시간-020_해외선물옵션-실시간체결내역통보.md
new file mode 100644
index 0000000..6226aec
--- /dev/null
+++ b/docs/broker/kis/websocket/해외선물옵션/실시간시세/319_실시간-020_해외선물옵션-실시간체결내역통보.md
@@ -0,0 +1,83 @@
+# 해외선물옵션 실시간체결내역통보
+
+- 원본 시트명: 해외선물옵션 실시간체결내역통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외선물옵션]실시간시세
+- API ID: 실시간-020
+- HTTP Method: POST
+- 실전 TR_ID: HDFFF2C0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFFF2C0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+개요 없음
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFFF2C0 |
+| tr_key | HTSID | string | Y | 8 | HTSID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| USER_ID | 유저ID | object | Y | 8 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| ACCT_NO | 계좌번호 | string | Y | 10 | |
+| ORD_DT | 주문일자 | string | Y | 8 | |
+| ODNO | 주문번호 | string | Y | 10 | |
+| ORGN_ORD_DT | 원주문일자 | string | Y | 8 | |
+| ORGN_ODNO | 원주문번호 | string | Y | 10 | |
+| SERIES | 종목명 | string | Y | 32 | |
+| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 해당없음 : 00 , 정정 : 01 , 취소 : 02 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도, 02 : 매수 |
+| CPLX_ORD_DVSN_CD | 복합주문구분코드 | string | Y | 1 | 0 (hedge청산만 이용) |
+| PRCE_TP | 가격구분코드 | string | Y | 1 | |
+| FM_EXCG_RCIT_DVSN_CD | FM거래소접수구분코드 | string | Y | 2 | |
+| ORD_QTY | 주문수량 | string | Y | 18 | |
+| FM_LMT_PRIC | FMLIMIT가격 | string | Y | 21 | |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | Y | 21 | |
+| TOT_CCLD_QTY | 총체결수량 | string | Y | 18 | 동일한 주문건에 대한 누적된 체결수량 (하나의 주문건에 여러건의 체결내역 발생) |
+| TOT_CCLD_UV | 총체결단가 | string | Y | 21 | |
+| ORD_REMQ | 잔량 | string | Y | 21 | |
+| FM_ORD_GRP_DT | FM주문그룹일자 | string | Y | 8 | |
+| ORD_GRP_STNO | 주문그룹번호 | string | Y | 12 | |
+| ORD_DTL_DTIME | 주문상세일시 | string | Y | 17 | |
+| OPRT_DTL_DTIME | 조작상세일시 | string | Y | 17 | |
+| WORK_EMPL | 주문자 | string | Y | 8 | |
+| CCLD_DT | 체결일자 | string | Y | 8 | |
+| CCNO | 체결번호 | string | Y | 11 | |
+| API_CCNO | API 체결번호 | string | Y | 20 | |
+| CCLD_QTY | 체결수량 | string | Y | 18 | 매 체결 단위 체결수량임 (여러건 체결내역 누적 체결수량인 총체결수량과 다름) |
+| FM_CCLD_PRIC | FM체결가격 | string | Y | 21 | |
+| CRCY_CD | 통화코드 | string | Y | 3 | |
+| TRST_FEE | 위탁수수료 | string | Y | 21 | |
+| ORD_MDIA_ONLINE_YN | 주문매체온라인여부 | string | Y | 1 | |
+| FM_CCLD_AMT | FM체결금액 | string | Y | 21 | |
+| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | Y | 2 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외주식/실시간시세/281_실시간-021_해외주식-실시간호가.md b/docs/broker/kis/websocket/해외주식/실시간시세/281_실시간-021_해외주식-실시간호가.md
new file mode 100644
index 0000000..ebf1313
--- /dev/null
+++ b/docs/broker/kis/websocket/해외주식/실시간시세/281_실시간-021_해외주식-실시간호가.md
@@ -0,0 +1,199 @@
+# 해외주식 실시간호가
+
+- 원본 시트명: 해외주식 실시간호가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외주식] 실시간시세
+- API ID: 실시간-021
+- HTTP Method: POST
+- 실전 TR_ID: HDFSASP0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFSASP0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 실시간호가 API를 이용하여 미국 실시간 10호가(매수/매도) 시세가 무료로 제공됩니다. (미국은 유료시세 제공 X)
+
+아시아 국가의 경우, HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시,
+"해외주식 실시간호가 HDFSASP0" 을 이용하여 아시아국가 유료시세(실시간호가)를 받아보실 수 있습니다. (24.11.29 반영)
+(아시아 국가 무료시세는 "해외주식 지연호가(아시아) HDFSASP1" 를 이용하시기 바랍니다.)
+
+※ 미국 : 실시간 무료, 매수/매도 각 10호가 (0분지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
+※ 아시아(홍콩, 베트남, 중국, 일본) : 실시간 유료 (단, 중국은 HTS[7781]에서 실시간시세 무료로 신청 후 이용 가능)
+
+해당 API로 미국주간거래(10:00~16:00) 시세 조회도 가능합니다.
+※ 미국주간거래 실시간 조회 시, 맨 앞자리(R), tr_key 중 시장구분 값을 다음과 같이 입력 → 나스닥: BAQ, 뉴욕: BAY, 아멕스: BAA
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+[미국주식시세 이용시 유의사항]
+
+■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
+
+※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
+※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
+
+■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가
+있을 수 있으며 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
+
+■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 유료 실시간 시세 서비스와 다를 수 있으며,
+종목별 과거 데이터(거래량, 시가, 종가, 고가, 차트 데이터 등)는 장 종료 후(오후 12시경) 유료 실시간 시세 서비스 데이터와 동일하게 업데이트됩니다.
+(출처: 한국투자증권 외화증권 거래설명서 - https://securities.koreainvestment.com/main/customer/guide/Guide.jsp?&cmd=TF04ag010002¤tPage=1&num=64)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFSASP0 |
+| tr_key | R거래소명종목코드 | string | Y | 6 | <미국 야간거래 - 무료시세>
D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
<미국 주간거래>
R+시장구분(3자리)+종목코드
예) RBAQAAPL : R+BAQ(나스닥)+AAPL(애플)
[시장구분]
BAY : 뉴욕(주간), BAQ : 나스닥(주간). BAA : 아멕스(주간)
<아시아국가 - 유료시세>
※ 유료시세 신청시에만 유료시세 수신가능
"포럼 > FAQ > 해외주식 유료시세 신청방법" 참고
R+시장구분(3자리)+종목코드
예) RHKS00003 : R+HKS(홍콩)+00003(홍콩중화가스)
[시장구분]
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| RSYM | 실시간종목코드 | object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| SYMB | 종목코드 | string | Y | 16 | |
+| ZDIV | 소숫점자리수 | string | Y | 1 | |
+| XYMD | 현지일자 | string | Y | 8 | |
+| XHMS | 현지시간 | string | Y | 6 | |
+| KYMD | 한국일자 | string | Y | 8 | |
+| KHMS | 한국시간 | string | Y | 6 | |
+| BVOL | 매수총잔량 | string | Y | 10 | |
+| AVOL | 매도총잔량 | string | Y | 10 | |
+| BDVL | 매수총잔량대비 | string | Y | 10 | |
+| ADVL | 매도총잔량대비 | string | Y | 10 | |
+| PBID1 | 매수호가1 | string | Y | 12 | |
+| PASK1 | 매도호가1 | string | Y | 12 | |
+| VBID1 | 매수잔량1 | string | Y | 10 | |
+| VASK1 | 매도잔량1 | string | Y | 10 | |
+| DBID1 | 매수잔량대비1 | string | Y | 10 | |
+| DASK1 | 매도잔량대비1 | string | Y | 10 | |
+| PBID2 | 매수호가2 | string | Y | 12 | |
+| PASK2 | 매도호가2 | string | Y | 12 | |
+| VBID2 | 매수잔량2 | string | Y | 10 | |
+| VASK2 | 매도잔량2 | string | Y | 10 | |
+| DBID2 | 매수잔량대비2 | string | Y | 10 | |
+| DASK2 | 매도잔량대비2 | string | Y | 10 | |
+| PBID3 | 매수호가3 | string | Y | 12 | |
+| PASK3 | 매도호가3 | string | Y | 12 | |
+| VBID3 | 매수잔량3 | string | Y | 10 | |
+| VASK3 | 매도잔량3 | string | Y | 10 | |
+| DBID3 | 매수잔량대비3 | string | Y | 10 | |
+| DASK3 | 매도잔량대비3 | string | Y | 10 | |
+| PBID3 | 매수호가3 | string | Y | 12 | |
+| PASK3 | 매도호가3 | string | Y | 12 | |
+| VBID3 | 매수잔량3 | string | Y | 10 | |
+| VASK3 | 매도잔량3 | string | Y | 10 | |
+| DBID3 | 매수잔량대비3 | string | Y | 10 | |
+| DASK3 | 매도잔량대비3 | string | Y | 10 | |
+| PBID4 | 매수호가4 | string | Y | 12 | |
+| PASK4 | 매도호가4 | string | Y | 12 | |
+| VBID4 | 매수잔량4 | string | Y | 10 | |
+| VASK4 | 매도잔량4 | string | Y | 10 | |
+| DBID4 | 매수잔량대비4 | string | Y | 10 | |
+| DASK4 | 매도잔량대비4 | string | Y | 10 | |
+| PBID5 | 매수호가5 | string | Y | 12 | |
+| PASK5 | 매도호가5 | string | Y | 12 | |
+| VBID5 | 매수잔량5 | string | Y | 10 | |
+| VASK5 | 매도잔량5 | string | Y | 10 | |
+| DBID5 | 매수잔량대비5 | string | Y | 10 | |
+| DASK5 | 매도잔량대비5 | string | Y | 10 | |
+| PBID6 | 매수호가6 | string | Y | 12 | |
+| PASK6 | 매도호가6 | string | Y | 12 | |
+| VBID6 | 매수잔량6 | string | Y | 10 | |
+| VASK6 | 매도잔량6 | string | Y | 10 | |
+| DBID6 | 매수잔량대비6 | string | Y | 10 | |
+| DASK6 | 매도잔량대비6 | string | Y | 10 | |
+| PBID7 | 매수호가7 | string | Y | 12 | |
+| PASK7 | 매도호가7 | string | Y | 12 | |
+| VBID7 | 매수잔량7 | string | Y | 10 | |
+| VASK7 | 매도잔량7 | string | Y | 10 | |
+| DBID7 | 매수잔량대비7 | string | Y | 10 | |
+| DASK7 | 매도잔량대비7 | string | Y | 10 | |
+| PBID8 | 매수호가8 | string | Y | 12 | |
+| PASK8 | 매도호가8 | string | Y | 12 | |
+| VBID8 | 매수잔량8 | string | Y | 10 | |
+| VASK8 | 매도잔량8 | string | Y | 10 | |
+| DBID8 | 매수잔량대비8 | string | Y | 10 | |
+| DASK8 | 매도잔량대비8 | string | Y | 10 | |
+| PBID9 | 매수호가9 | string | Y | 12 | |
+| PASK9 | 매도호가9 | string | Y | 12 | |
+| VBID9 | 매수잔량9 | string | Y | 10 | |
+| VASK9 | 매도잔량9 | string | Y | 10 | |
+| DBID9 | 매수잔량대비9 | string | Y | 10 | |
+| DASK9 | 매도잔량대비9 | string | Y | 10 | |
+| PBID10 | 매수호가10 | string | Y | 12 | |
+| PASK10 | 매도호가10 | string | Y | 12 | |
+| VBID10 | 매수잔량10 | string | Y | 10 | |
+| VASK10 | 매도잔량10 | string | Y | 10 | |
+| DBID10 | 매수잔량대비10 | string | Y | 10 | |
+| DASK10 | 매도잔량대비10 | string | Y | 10 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header": {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype": "P",
+ "tr_type": "1",
+ "content-type": "utf-8"
+ },
+ "body": {
+ "input": {
+ "tr_id": "HDFSASP0",
+ "tr_key": "RBAQAAPL"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# 연결 확인
+{
+ "header": {
+ "tr_id": "HDFSASP0",
+ "tr_key": "RBAQAAPL",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output
+0|HDFSASP0|001|RBAQAAPL^AAPL^4^20240506^202223^20240507^092223^1482^381^0^-10^182.8500^182.8700^350^57^0^-10^182.8400^182.9000^1^10^0^0^182.8300^182.9100^6^54^0^0^182.7900^182.9500^54^5^0^0^182.7500^182.9600^309^3^0^0^182.7300^182.9700^20^81^0^0^182.7000^182.9800^124^3^0^0^182.6600^182.9900^397^1^0^0^182.6500^183.0000^20^69^0^0^182.6300^183.0100^201^98^0^0
+```
diff --git a/docs/broker/kis/websocket/해외주식/실시간시세/282_실시간-008_해외주식-지연호가아시아.md b/docs/broker/kis/websocket/해외주식/실시간시세/282_실시간-008_해외주식-지연호가아시아.md
new file mode 100644
index 0000000..d21d74f
--- /dev/null
+++ b/docs/broker/kis/websocket/해외주식/실시간시세/282_실시간-008_해외주식-지연호가아시아.md
@@ -0,0 +1,80 @@
+# 해외주식 지연호가(아시아)
+
+- 원본 시트명: 해외주식 지연호가(아시아)
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외주식] 실시간시세
+- API ID: 실시간-008
+- HTTP Method: POST
+- 실전 TR_ID: HDFSASP1
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 제공 안함
+- URL 명: /tryitout/HDFSASP1
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 지연호가(아시아)의 경우 아시아 무료시세(지연호가)가 제공됩니다.
+
+HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시,
+"해외주식 실시간호가 HDFSASP0" 을 이용하여 아시아국가 유료시세(실시간호가)를 받아보실 수 있습니다. (24.11.29 반영)
+
+※ 지연시세 지연시간 : 홍콩, 베트남, 중국, 일본 - 15분지연
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| tr_type | 등록/해제 | string | Y | 1 | "1: 등록, 2:해제" |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFSASP1 |
+| tr_key | D거래소명종목코드 | string | Y | 6 | <아시아국가 - 무료시세>
D+시장구분(3자리)+종목코드
예) DHKS00003 : D+HKS(홍콩)+00003(홍콩중화가스)
[시장구분]
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이 |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| RSYM | 실시간종목코드 | string | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| SYMB | 종목코드 | string | Y | 16 | |
+| ZDIV | 소수점자리수 | string | Y | 1 | |
+| XYMD | 현지일자 | string | Y | 8 | |
+| XHMS | 현지시간 | string | Y | 6 | |
+| KYMD | 한국일자 | string | Y | 8 | |
+| KHMS | 한국시간 | string | Y | 6 | |
+| BVOL | 매수총잔량 | string | Y | 10 | |
+| AVOL | 매도총잔량 | string | Y | 10 | |
+| BDVL | 매수총잔량대비 | string | Y | 10 | |
+| ADVL | 매도총잔량대비 | string | Y | 10 | |
+| PBID1 | 매수호가1 | string | Y | 12 | |
+| PASK1 | 매도호가1 | string | Y | 12 | |
+| VBID1 | 매수잔량1 | string | Y | 10 | |
+| VASK1 | 매도잔량1 | string | Y | 10 | |
+| DBID1 | 매수잔량대비1 | string | Y | 10 | |
+| DASK1 | 매도잔량대비1 | string | Y | 10 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외주식/실시간시세/283_실시간-007_해외주식-실시간지연체결가.md b/docs/broker/kis/websocket/해외주식/실시간시세/283_실시간-007_해외주식-실시간지연체결가.md
new file mode 100644
index 0000000..209b9e8
--- /dev/null
+++ b/docs/broker/kis/websocket/해외주식/실시간시세/283_실시간-007_해외주식-실시간지연체결가.md
@@ -0,0 +1,94 @@
+# 해외주식 실시간지연체결가
+
+- 원본 시트명: 해외주식 실시간지연체결가
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외주식] 실시간시세
+- API ID: 실시간-007
+- HTTP Method: POST
+- 실전 TR_ID: HDFSCNT0
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: 모의투자 미지원
+- URL 명: /tryitout/HDFSCNT0
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외주식 실시간지연체결가의 경우 기본적으로 무료시세(지연체결가)가 제공되며,
+아시아 국가의 경우 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시 API로도 유료시세(실시간체결가)를 받아보실 수 있습니다. (24.11.29 반영)
+
+※ 지연시세 지연시간 : 미국 - 실시간무료(0분지연) / 홍콩, 베트남, 중국, 일본 - 15분지연 (중국은 실시간시세 신청 시 무료실시간시세 제공)
+ 미국의 경우 0분지연시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
+
+해당 API로 미국주간거래(10:00~16:00) 시세 조회도 가능합니다.
+※ 미국주간거래 실시간 조회 시, 맨 앞자리(R), tr_key 중 시장구분 값을 다음과 같이 입력 → 나스닥: BAQ, 뉴욕: BAY, 아멕스: BAA
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | HDFSCNT0 |
+| tr_key | D거래소명종목코드 | string | Y | 6 | <미국 야간거래/아시아 주간거래 - 무료시세>
D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이
<미국 야간거래/아시아 주간거래 - 유료시세>
※ 유료시세 신청시에만 유료시세 수신가능
"포럼 > FAQ > 해외주식 유료시세 신청방법" 참고
R+시장구분(3자리)+종목코드
예) RNASAAPL : R+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이
<미국 주간거래>
R+시장구분(3자리)+종목코드
예) RBAQAAPL : R+BAQ(나스닥)+AAPL(애플)
[시장구분]
BAY : 뉴욕(주간), BAQ : 나스닥(주간). BAA : 아멕스(주간) |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| RSYM | 실시간종목코드 | string | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| SYMB | 종목코드 | string | Y | 16 | |
+| ZDIV | 수수점자리수 | string | Y | 1 | |
+| TYMD | 현지영업일자 | string | Y | 8 | |
+| XYMD | 현지일자 | string | Y | 6 | |
+| XHMS | 현지시간 | string | Y | 6 | |
+| KYMD | 한국일자 | string | Y | 6 | |
+| KHMS | 한국시간 | string | Y | 6 | |
+| OPEN | 시가 | string | Y | 6 | |
+| HIGH | 고가 | string | Y | 6 | |
+| LOW | 저가 | string | Y | 6 | |
+| LAST | 현재가 | string | Y | 6 | |
+| SIGN | 대비구분 | string | Y | 6 | |
+| DIFF | 전일대비 | string | Y | 8 | |
+| RATE | 등락율 | string | Y | 6 | |
+| PBID | 매수호가 | string | Y | 10 | |
+| PASK | 매도호가 | string | Y | 10 | |
+| VBID | 매수잔량 | string | Y | 10 | |
+| VASK | 매도잔량 | string | Y | 10 | |
+| EVOL | 체결량 | string | Y | 12 | |
+| TVOL | 거래량 | string | Y | 12 | |
+| TAMT | 거래대금 | string | Y | 10 | |
+| BIVL | 매도체결량 | string | Y | 10 | 매수호가가 매도주문 수량을 따라가서 체결된것을 표현하여 BIVL 이라는 표현을 사용 |
+| ASVL | 매수체결량 | string | Y | 10 | 매도호가가 매수주문 수량을 따라가서 체결된것을 표현하여 ASVL 이라는 표현을 사용 |
+| STRN | 체결강도 | string | Y | 10 | |
+| MTYP | 시장구분 1:장중,2:장전,3:장후 | string | Y | 10 | |
+
+## 메모
+
+- Request Example (Python)
+- Response Example
diff --git a/docs/broker/kis/websocket/해외주식/실시간시세/284_실시간-009_해외주식-실시간체결통보.md b/docs/broker/kis/websocket/해외주식/실시간시세/284_실시간-009_해외주식-실시간체결통보.md
new file mode 100644
index 0000000..6e9ae10
--- /dev/null
+++ b/docs/broker/kis/websocket/해외주식/실시간시세/284_실시간-009_해외주식-실시간체결통보.md
@@ -0,0 +1,151 @@
+# 해외주식 실시간체결통보
+
+- 원본 시트명: 해외주식 실시간체결통보
+- API 통신방식: WEBSOCKET
+- 메뉴 위치: [해외주식] 실시간시세
+- API ID: 실시간-009
+- HTTP Method: POST
+- 실전 TR_ID: H0GSCNI0
+- 모의 TR_ID: H0GSCNI9
+- 실전 Domain: ws://ops.koreainvestment.com:21000
+- 모의 Domain: ws://ops.koreainvestment.com:31000
+- URL 명: /tryitout/H0GSCNI0
+- 모의투자 지원: 지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+[참고자료]
+
+실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
+https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
+
+실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
+https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
+
+## 레이아웃
+
+### Request Header
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| approval_key | 웹소켓 접속키 | string | Y | 286 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
+| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
+
+### Request Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| tr_id | 거래ID | string | Y | 7 | [실전투자]
H0GSCNI0 : 실시간 해외주식 체결통보
[모의투자]
H0GSCNI9 : 실시간 해외주식 체결통보 |
+| tr_key | HTSID | string | Y | 8 | HTSID |
+
+### Response Header
+
+없음
+
+### Response Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CUST_ID | 고객 ID | string | Y | 8 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
+| ACNT_NO | 계좌번호 | string | Y | 10 | |
+| ODER_NO | 주문번호 | string | Y | 10 | |
+| OODER_NO | 원주문번호 | string | Y | 10 | |
+| SELN_BYOV_CLS | 매도매수구분 | string | Y | 2 | 01:매도 02:매수 03:전매도 04:환매수 |
+| RCTF_CLS | 정정구분 | string | Y | 1 | 0:정상 1:정정 2:취소 |
+| ODER_KIND2 | 주문종류2 | string | Y | 1 | 1:시장가 2:지정자 6:단주시장가 7:단주지정가
A:MOO B:LOO C:MOC D:LOC |
+| STCK_SHRN_ISCD | 주식 단축 종목코드 | string | Y | 9 | |
+| CNTG_QTY | 체결수량 | string | Y | 10 | - 주문통보의 경우 해당 위치에 주문수량이 출력
- 체결통보인 경우 해당 위치에 체결수량이 출력 |
+| CNTG_UNPR | 체결단가 | string | Y | 9 | ※ 주문통보 시에는 주문단가가, 체결통보 시에는 체결단가가 수신 됩니다.
※ 체결단가의 경우, 국가에 따라 소수점 생략 위치가 상이합니다.
미국 4 일본 1 중국 3 홍콩 3 베트남 0
EX) 미국 AAPL(현재가 : 148.0100)의 경우 001480100으로 체결단가가 오는데,
4번째 자리에 소수점을 찍어 148.01로 해석하시면 됩니다. |
+| STCK_CNTG_HOUR | 주식 체결 시간 | string | Y | 6 | 특정 거래소의 체결시간 데이터는 수신되지 않습니다.
체결시간 데이터가 필요할 경우, 체결통보 데이터 수신 시 타임스탬프를 찍는 것으로 대체하시길 바랍니다. |
+| RFUS_YN | 거부여부 | string | Y | 1 | 0:정상 1:거부 |
+| CNTG_YN | 체결여부 | string | Y | 1 | 1:주문,정정,취소,거부 2:체결 |
+| ACPT_YN | 접수여부 | string | Y | 1 | 1:주문접수 2:확인 3:취소(FOK/IOC) |
+| BRNC_NO | 지점번호 | string | Y | 5 | |
+| ODER_QTY | 주문 수량 | string | Y | 9 | - 주문통보인 경우 해당 위치 미출력 (주문통보의 주문수량은 CNTG_QTY 위치에 출력)
- 체결통보인 경우 해당 위치에 주문수량이 출력 |
+| ACNT_NAME | 계좌명 | string | Y | 12 | |
+| CNTG_ISNM | 체결종목명 | string | Y | 14 | |
+| ODER_COND | 해외종목구분 | string | Y | 1 | 4:홍콩(HKD) 5:상해B(USD)
6:NASDAQ 7:NYSE 8:AMEX 9:OTCB
C:홍콩(CNY) A:상해A(CNY) B:심천B(HKD)
D:도쿄 E:하노이 F:호치민 |
+| DEBT_GB | 담보유형코드 | string | Y | 2 | 10:현금 15:해외주식담보대출 |
+| DEBT_DATE | 담보대출일자 | string | Y | 8 | 대출일(YYYYMMDD) |
+| START_TM | 분할매수/매도 시작시간 | string | Y | 6 | HHMMSS |
+| END_TM | 분할매수/매도 종료시간 | string | Y | 6 | HHMMSS |
+| TM_DIV_TP | 시간분할타입유형 | string | Y | 2 | 00 시간직접설정, 02 : 정규장까지 |
+| CNTG_UNPR12 | 체결단가12 | string | Y | 12 | |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+ "header":
+ {
+ "approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
+ "custtype":"P",
+ "tr_type":"1",
+ "content-type":"utf-8"
+ },
+ "body":
+ {
+ "input":
+ {
+ "tr_id":"H0GSCNI0",
+ "tr_key":"HTS ID"
+ }
+ }
+}
+```
+
+### Response Example
+
+```text
+# output - 등록 성공 시
+{
+ "header": {
+ "tr_id": "H0GSCNI0",
+ "tr_key": "HTS ID",
+ "encrypt": "N"
+ },
+ "body": {
+ "rt_cd": "0",
+ "msg_cd": "OPSP0000",
+ "msg1": "SUBSCRIBE SUCCESS",
+ "output": {
+ "iv": "0123456789abcdef",
+ "key": "abcdefghijklmnopabcdefghijklmnop"}
+ }
+}
+
+# output (복호화 전)
+1|H0GSCNI0|001|vebQjGIHMgFhxfNfvebQjGIHMgFhxfNfvebQjGIHMgFhxfNfvebQj...hxfNf
+
+# output (복호화 후)
+#### 해외주식 주문·정정·취소·거부 접수 통보 ####
+고객 ID [abcd1234]
+계좌번호 [12345678]
+주문번호 [3567]
+원주문번호 []
+매도매수구분 [02]
+정정구분 [0]
+주문종류2 [1]
+단축종목코드 [7203]
+주문수량 [0000000100]
+체결단가 [000032200]
+체결시간 []
+거부여부 [0]
+체결여부 [1]
+접수여부 [1]
+지점번호 []
+체결수량 []
+계좌명 [******]
+체결종목명 [도요타자동차]
+해외종목구분 [D]
+담보유형코드 [10]
+담보대출일자 []
+분할매수매도시작시간 []
+분할매수매도종료시간 []
+시간분할타입유형 []
+```
diff --git a/docs/discovery/dcy-002_20260603_slot-core-daemon-http-api.md b/docs/discovery/dcy-002_20260603_slot-core-daemon-http-api.md
index 849eee4..fe43dec 100644
--- a/docs/discovery/dcy-002_20260603_slot-core-daemon-http-api.md
+++ b/docs/discovery/dcy-002_20260603_slot-core-daemon-http-api.md
@@ -1,13 +1,13 @@
# 0. 문서 상태
이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다.
-- 상태: confirmed
+- 상태: confirmed (transport 부분은 dcy-006/BAT-007 에서 RabbitMQ 로 대체됨; logical intent/admission 계약은 유효)
- 문서 ID: dcy-002_20260603_slot-core-daemon-http-api
- 이슈명: trex-core 슬롯 코어 데몬화 + HTTP intent API
- 작성 시각(KST): 2026-06-03
-- 마지막 갱신 시각(KST): 2026-06-03 (draft-req)
-- 대체됨: 없음
-- 후속 Discovery 참조: 없음
+- 마지막 갱신 시각(KST): 2026-06-05 (BAT-007 transport supersede)
+- 대체됨: 본 Discovery 의 **HTTP `/v1` API transport** 가정은 dcy-006(`strategy-module-rabbitmq-transport`, BAT-007)에서 RabbitMQ messaging 으로 대체됨. logical 계약(intent admission, idempotency via `intent_log`, 단일 writer 불변식)은 그대로 유효하며 transport 만 교체. `adapters/api/` HTTP 어댑터, `GET /v1/healthz`, `POST /v1/intents/buy|sell`, `GET /v1/slots`, `GET /v1/capacity` 엔드포인트는 BAT-007 에서 제거됨.
+- 후속 Discovery 참조: dcy-006_20260605_strategy-module-rabbitmq-transport (transport 대체)
- 생성된 REQ 참조: REQ-005, REQ-006, REQ-007, REQ-008, REQ-009
# 1. 계획 상태 요약
diff --git a/docs/discovery/dcy-005_20260604_portfolio-hub-asset-snapshot-api.md b/docs/discovery/dcy-005_20260604_portfolio-hub-asset-snapshot-api.md
index fd30e4d..10a12dd 100644
--- a/docs/discovery/dcy-005_20260604_portfolio-hub-asset-snapshot-api.md
+++ b/docs/discovery/dcy-005_20260604_portfolio-hub-asset-snapshot-api.md
@@ -5,7 +5,7 @@
- 문서 ID: dcy-005_20260604_portfolio-hub-asset-snapshot-api
- 이슈명: portfolio-hub 종목 스냅샷 read API — 전략 모듈에 전략 실행 대상 자산 리스트 제공
- 작성 시각(KST): 2026-06-04 22:46
-- 마지막 갱신 시각(KST): 2026-06-05 22:36
+- 마지막 갱신 시각(KST): 2026-06-05 23:57
- 대체됨: 없음
- 후속 Discovery 참조: 없음
- 생성된 REQ 참조: 없음
@@ -18,7 +18,7 @@
- 관련 TODO/메모: dcy-004(portfolio-hub ledger write 통합, BAT-006 진행 중)의 Out of Scope `asset master 동기화·get_assets/get_portfolios 연동`. orbit `app/clients/portfolio_client.py`(read 계약 get_assets/get_portfolios 패턴). **dcy-006(confirmed) — trex-core ↔ 전략 모듈 통신 transport 를 RabbitMQ 로 확정(HTTP 표면 0). 본 Discovery 의 스냅샷 read 는 그 transport(RabbitMQ request-reply RPC) 위에서 전달된다.**
- 해석:
- dcy-004 는 체결을 portfolio-hub 원장에 기록하는 **write 방향**이었고, 본 Discovery 는 그 반대인 **read 방향** — portfolio-hub 종목 스냅샷을 trex-core 가 전략 모듈에 제공한다. dcy-004 가 명시적으로 후속으로 미룬 영역을 이어받는다.
- - **transport/계약 분리**: 본 Discovery 는 스냅샷의 **logical 계약**(응답 단위·필드·마스킹·view 모드·strategy_id 필터·신선도)을 정의하며 **transport-무관**이다. 전달 방식(HTTP 아님 — dcy-006 의 RabbitMQ RPC)은 dcy-006 소관이고, 본 문서는 그 transport 위에 logical 계약을 얹는다.
+ - **transport/계약 분리**: 본 Discovery 는 스냅샷의 **logical 계약**(응답 단위·필드·마스킹·view 모드·strategy_key 필터·신선도)을 정의하며 **transport-무관**이다. 전달 방식(HTTP 아님 — dcy-006 의 RabbitMQ RPC)은 dcy-006 소관이고, 본 문서는 그 transport 위에 logical 계약을 얹는다.
- active-cycle 판정(BAT-006 draft 진행 중)이지만 명시적 신규 입력이고, BAT-006(write)과 read 방향이 분리되어 범위 충돌이 없으므로 병렬 독립 주기로 진행한다. core 경유의 핵심 가치는 단순 패스스루가 아니라 **core 의 권위 슬롯 상태를 겹쳐(slot overlay) 전략 실행 대상 자산을 선별(pending·warning·pause 마스킹)** 해 제공하는 것이다.
# 2. 요구사항 판정 결과
@@ -35,15 +35,15 @@
- 현재 상태
- trex-core 의 read 경로는 슬롯/capacity 조회와 intent 조회뿐이고 portfolio-hub 종목을 노출하는 read 경로가 없다. (현재 이 read 들은 HTTP `/v1` 로 제공되나, dcy-006 confirmed 로 통신 transport 가 RabbitMQ 로 대체되고 HTTP 표면은 0 이 된다. 따라서 본 스냅샷 read 는 신규 HTTP 엔드포인트가 아니라 dcy-006 의 RabbitMQ RPC 로 노출한다.)
- portfolio-hub read 어댑터(get_assets/get_portfolios)가 trex-core 에 없다. dcy-004/BAT-006 은 write 방향 `LedgerPort` + portfolio-hub 어댑터만 추가하며, read 포트는 다루지 않는다.
- - 결과적으로 매수 전략 모듈이 "무엇을 살지" 정할 portfolio-hub 종목 정보를 trex-core 를 통해 받을 경로가 없다.
+ - 결과적으로 전략 모듈이 "무엇을 매매할지" 정할 portfolio-hub 종목 정보를 trex-core 를 통해 받을 경로가 없다.
- 기대 상태
- trex-core daemon 이 설정 가능한 시각(기본 07:30 KST, .env)에 일일 스케줄로 portfolio-hub 에서 자신의 `daemon_id` universe(= `managed_by_daemon_id` 가 해당 daemon 인 portfolio 집합)를 가져와 스냅샷으로 보유한다. universe 항목은 portfolio 단위로 symbol, asset_id(=portfolio_id), 현금(cash_balance), 포지션(asset_quantity), active_strategy_id, 전략파라미터(opaque JSON)를 담고 **가격(price)은 제외**한다.
- 전략 모듈 요청 시 trex-core 가 이 스냅샷을 기반으로 **portfolio-hub 보유 자산(holding 슬롯 자산 포함)을 담되 pending·warning·pause 상태 자산은 마스킹한 전략 실행 대상 자산 리스트**를 반환한다(OQ-4).
- - 가용 슬롯이 없을 때(capacity 소진)의 응답 시맨틱은 holding 포함 변경에 맞춰 재정의 대상이다(OQ-11).
+ - 응답은 요청 `view` 파라미터(`all` 기본 | `buyable` | `held`)로 base 집합을 고르고 envelope(`assets[]` + `available_slots`·`degraded` 등 meta)로 반환한다(OQ-11/OQ-12/OQ-6). 가용 슬롯이 0 이어도 보유 자산은 계속 반환되며 신규 매수 가용성은 `available_slots` meta 로 신호한다.
- 이해관계자
- 문서 작성자/구현자(AI agent)
- 리뷰어/승인자(운영자, genichin@gmail.com)
- - 매수 전략 모듈(trex-core 외부 소비자) 및 portfolio-hub(외부 자산/포지션 서비스)
+ - 전략 모듈(매수/매도/position, trex-core 외부 소비자) 및 portfolio-hub(외부 자산/포지션 서비스)
- 제약사항
- 도메인 순수성 — `trex_core.domain` 은 portfolio-hub/네트워크 의존 0(read 어댑터 격리).
- 단일 통합 경계 — portfolio-hub 자격증명/계약 접점은 trex-core 어댑터(dcy-004 재사용)로 한정하며, 매수 전략 등 모든 소비자는 core 스냅샷 계약을 경유한다(portfolio-hub 직접 호출 금지, OQ-3).
@@ -54,10 +54,10 @@
사용자 또는 운영자가 실제로 어떤 상황에서 이 변경을 필요로 하는지 대표 시나리오를 적는다.
- 전략 모듈이 자기 portfolio(전략 실행 대상 자산)를 trex-core 스냅샷 API 로 요청 → portfolio-hub 보유 자산(holding 슬롯 자산 포함)을 받되, pending·warning·pause 상태 자산은 마스킹되어 빠진 리스트를 받는다.
-- 모든 슬롯이 차 있어 더 살 수 없는 상황 → (holding 포함 변경으로 이 시맨틱 재정의 필요 — OQ-11) 신규 매수 가능 여부 신호 방식 확정 전까지 보유 자산은 계속 응답에 포함될 수 있다.
+- 모든 슬롯이 차 있어 더 살 수 없는 상황 → 보유 자산은 계속 응답에 포함되고(`view=all`/`held`), 신규 매수 가능 여부는 `available_slots` meta 로 신호한다. `view=buyable` 은 `available_slots=0` 이면 `[]` 를 반환한다(OQ-11/OQ-12).
- 막 매수 주문되어 슬롯이 pending(미체결)인 종목 → 마스킹되어 전략 모듈 응답에서 빠져 중복 매수를 막고, 체결되어 holding 이 되면 보유 자산으로 응답에 포함된다.
- 스냅샷 페치 시 portfolio-hub 포지션과 실제 브로커 계좌 포지션이 어긋난 자산 → `warning` 으로 표시되어 그 자산은 응답 리스트에서 마스킹되고 매매 전략이 수행되지 않는다.
-- 전략 모듈이 자기 `strategy_id` 를 파라미터로 넣어 포트폴리오를 요청 → 그 전략 ID 가 등록된 자산만 받는다. 파라미터를 생략하면 전체 자산을 받는다(여러 전략 모듈이 하나의 스냅샷 API 를 공유하되 자기 책임 자산만 조회).
+- 전략 모듈이 자기 `strategy_key` 를 파라미터로 넣어 포트폴리오를 요청 → 그 `strategy_key` 가 등록된 자산만 받는다. 파라미터를 생략하면 전체 자산을 받는다(여러 전략 모듈이 하나의 스냅샷 API 를 공유하되 자기 책임 자산만 조회).
- 운영자가 특정 자산을 런타임에 pause → 전략 모듈이 포트폴리오를 요청해도 그 자산은 응답에서 마스킹되어 매매가 멈추고, resume 하면 다시 응답에 포함된다.
# 4. 이번에 정의할 변경
@@ -67,18 +67,18 @@
- 일일 스냅샷 갱신: 설정 시각(기본 07:30 KST, .env)에 스케줄러(신규 daemon 컴포넌트)가 universe 를 페치해 스냅샷을 갱신한다. 현금/포지션은 baseline 에 더해, 체결 시 portfolio-hub ledger write 응답이 반환하는 변경 후 권위 cash/position 으로 갱신한다(옵션 D — 당초 옵션 C 의 core 로컬 체결 replay 보정을 대체).
- 포지션 정합 검증 + warning: 페치 시 portfolio-hub 포지션 vs 실제 브로커 계좌 포지션을 대조하고, 불일치 자산은 `warning` 상태로 응답 리스트에서 마스킹한다.
- 종목 스냅샷 read 계약: trex-core 가 보유 스냅샷을 read 계약(요청-응답, transport 는 dcy-006 RabbitMQ RPC)으로 제공하고, **holding 포함·pending·warning·pause 마스킹**한 전략 실행 대상 자산 리스트를 반환한다(slot overlay, OQ-4).
-- 전략 ID 필터: 스냅샷 read 요청이 선택적 `strategy_id` 파라미터(요청 payload, dcy-006 OQ-2)를 받아, 주어지면 해당 전략 ID 가 등록된(= `active_strategy_id` 일치) 자산만 반환하고, 없으면 (pending·warning·pause 마스킹 후) 모든 자산을 반환한다. 전략 ID 의 식별자 형태("이름?")와 "등록" 판정 기준은 OQ-9.
+- strategy_key 필터: 스냅샷 read 요청이 선택적 `strategy_key` 파라미터(요청 payload, dcy-006 OQ-2)를 받아, 주어지면 해당 `strategy_key` 가 등록된(= `active_strategy_id` 일치) 자산만 반환하고, 없으면 (pending·warning·pause 마스킹 후) 모든 자산을 반환한다. `strategy_key` 는 사람이 읽는 안정 유일 slug(예: `target-value-v1`), 단일 `active_strategy_id` 정확 일치(OQ-9).
- 런타임 pause/resume: trex-core 가 보유한 스냅샷 universe 의 개별 항목을 사용자가 런타임에 일시 중단(pause)/재개(resume)할 수 있고, pause 된 항목은 전략 모듈의 포트폴리오 요청 결과에서 제외한다. pause 단위·제어 방식·영속성은 OQ-10.
-- capacity 0 응답 시맨틱: 가용 슬롯이 0 일 때의 응답은 holding 포함 변경에 맞춰 재정의한다(OQ-11; 빈/표현 형식은 OQ-6).
+- 응답 view 모드 + envelope: 응답 base 집합을 요청 `view`(`all` 기본|`buyable`|`held`)로 선택하고 envelope(`assets[]` + `view`·`available_slots`·`degraded`·`reason` meta)로 반환한다(OQ-11/OQ-12/OQ-6). capacity 0 이어도 보유 자산은 반환, `buyable` 만 `available_slots=0` 시 `[]`.
- baseline 갱신: interface-contract(read 포트/메시지 계약)·runtime-flows(스냅샷 조회 흐름, RabbitMQ RPC)·project-structure(read 어댑터) 갱신. (dcy-006 의 transport baseline 갱신과 정합.)
## 영향 범위
변경이 미칠 코드/문서/운영 범위를 명시해 REQ 정제와 batch planning에서 추정 누락을 줄인다.
- 코드 영향:
- - 신규: `trex_core/application` read 포트, 신규 `adapters/portfolio` read 어댑터 + stub, 스냅샷 read 를 dcy-006 messaging transport(RabbitMQ RPC, `adapters/messaging`)로 노출 + 응답 스키마(transport-무관), slot overlay(점유 종목 제외) + 현금/포지션 write-응답 갱신 로직(`cash_balance_after`/`asset_quantity_after`, 옵션 D), 일일 스냅샷 스케줄러(런타임 신규), 포지션 정합 검증 + `warning` 상태, `config` 에 `daemon_id` + 스냅샷 페치 시각 주입, `strategy_id` 필터(요청 payload → `active_strategy_id` 매칭), 스냅샷 항목 pause/resume 상태 저장 + 제어 표면(제어 메시지/CLI) + 응답 산출 시 pause 마스킹.
+ - 신규: `trex_core/application` read 포트, 신규 `adapters/portfolio` read 어댑터 + stub, 스냅샷 read 를 dcy-006 messaging transport(RabbitMQ RPC, `adapters/messaging`)로 노출 + 응답 스키마(transport-무관), slot overlay(점유 종목 제외) + 현금/포지션 write-응답 갱신 로직(`cash_balance_after`/`asset_quantity_after`, 옵션 D), 일일 스냅샷 스케줄러(런타임 신규), 포지션 정합 검증 + `warning` 상태, `config` 에 스냅샷 페치 시각 주입(`daemon_id` 는 portfolio-hub 토큰에서 도출 — 별도 config 불필요, OQ-7), `strategy_key` 필터(요청 payload → `active_strategy_id` 매칭), 스냅샷 항목 pause/resume 상태 저장(Postgres, portfolio_id 키, refresh 무관) + 제어 표면(CLI + dcy-006 RPC 제어 메시지) + 응답 산출 시 pause 마스킹(전역).
- (주의: dcy-006 가 `adapters/api` HTTP 어댑터를 제거하므로, 스냅샷 read 는 신규 HTTP 엔드포인트가 아니라 dcy-006 의 RPC consumer 로 구현한다.)
- - 기존: capacity/slot 조회 재사용(점유 종목·가용 슬롯 판정), 브로커 계좌 포지션 조회(BrokerPort 잔고조회 — 정합 검증용) 재사용/확장.
+ - 기존: capacity/slot 조회 재사용(점유 종목·가용 슬롯 판정), 브로커 계좌 포지션 조회(BrokerPort 잔고조회 = KIS 주식잔고조회 `TTTC8434R`/`VTTC8434R`, `pdno`+`hldg_qty`, symbol 집계 — 정합 검증용, OQ-8) 재사용/확장.
- 문서 영향:
- interface-contract/runtime-flows/project-structure 갱신.
- 운영 영향:
@@ -88,22 +88,22 @@
실제로 구현과 검증으로 이어질 요구사항을 기능/비기능으로 나누어 정리하고, 범위 경계를 명확히 적는다.
## 기능 요구사항
-- FR-1: trex-core 가 종목 스냅샷을 read 계약(요청-응답)으로 제공한다. transport 는 dcy-006 의 RabbitMQ request-reply RPC 이며(HTTP 아님), 매수 전략 모듈이 메시지로 소비한다. 스냅샷 단위는 daemon 이 관리하는 portfolio universe 이며, 항목당 symbol, asset_id(=portfolio_id), 현금(cash_balance), 포지션(asset_quantity), active_strategy_id, 전략파라미터(opaque JSON)를 담고 가격(price)은 제외한다. (OQ-1 Answered)
-- FR-2: 스냅샷 응답(전략 실행 대상 portfolio 자산 리스트)은 **portfolio-hub 에 보유된 자산을 기본 포함하며, holding 슬롯의 자산도 포함**한다(전략 모듈이 보유 포지션까지 받아 관리). 단 다음 상태의 자산은 **마스킹**하여 응답에서 제외한다: (a) 슬롯 상태 pending(미체결 in-flight), (b) 자산 상태 warning(브로커 실제 position 불일치, FR-7), (c) 사용자 pause(FR-9). 포함/마스킹 판정은 core 권위 슬롯 상태 + 정합 검증 + pause 상태를 사용하며 portfolio-hub 보유 여부보다 우선한다(slot overlay). 본 조항은 기본(default) view 의 구성 규칙이며, 응답 베이스 집합은 요청 view 모드 파라미터(OQ-11/OQ-12)로 선택될 수 있고 마스킹은 선택된 베이스 위에 적용된다. (변경 2026-06-05, OQ-4 결정: 종전 'pending·holding 점유 종목 제외, 매수 후보 리스트' → 'holding 포함, pending·warning·pause 만 마스킹'.)
-- FR-3: 가용 슬롯이 0(capacity 소진)일 때의 응답은 **고정값이 아니라 전략 모듈이 요청 시 지정하는 view 모드 파라미터**에 따른다(OQ-11 결정). 최소 3개 모드: (a) 빈 리스트 `[]`, (b) 슬롯 점유 자산만, (c) portfolio 스냅샷 − 슬롯 점유 자산. 파라미터 이름/enum·기본 모드·마스킹(OQ-4)·strategy_id 필터(FR-8)와의 합성은 OQ-12, 빈/표현 형식은 OQ-6 에서 확정한다. (종전 'capacity 0 → 매수 후보 빈 리스트'는 OQ-4 holding 포함 + 본 결정으로 대체.)
-- FR-4: portfolio-hub read 접근을 `PortfolioHubReadPort.get_portfolios(daemon_id)` 추상화 + portfolio-hub 어댑터(`managed_by_daemon_id` 기준) + 결정론 stub 로 제공하고, dcy-004 의 portfolio-hub 어댑터/자격증명을 재사용한다. 전략파라미터는 opaque JSON 으로 통과시킨다(trex-core 가 스키마를 해석하지 않음).
+- FR-1: trex-core 가 종목 스냅샷을 read 계약(요청-응답)으로 제공한다. transport 는 dcy-006 의 RabbitMQ request-reply RPC 이며(HTTP 아님), 전략 모듈이 메시지로 소비한다. 스냅샷 단위는 daemon 이 관리하는 portfolio universe 이며, 항목당 symbol, asset_id(=portfolio_id), 현금(cash_balance), 포지션(asset_quantity), active_strategy_id, 전략파라미터(opaque JSON)를 담고 가격(price)은 제외한다. (OQ-1 Answered)
+- FR-2: 스냅샷 응답(전략 실행 대상 portfolio 자산 리스트)은 **portfolio-hub 에 보유된 자산을 기본 포함하며, holding 슬롯의 자산도 포함**한다(전략 모듈이 보유 포지션까지 받아 관리). 단 다음 상태의 자산은 **마스킹**하여 응답에서 제외한다: (a) 슬롯 상태 pending(미체결 in-flight), (b) 자산 상태 warning(브로커 실제 position 불일치, FR-7), (c) 사용자 pause(FR-9). 포함/마스킹 판정은 core 권위 슬롯 상태 + 정합 검증 + pause 상태를 사용하며 portfolio-hub 보유 여부보다 우선한다(slot overlay). 본 조항은 기본(default) view(`all`)의 구성 규칙이며, 응답 베이스 집합은 요청 `view` 파라미터(`all`/`buyable`/`held`, OQ-11/OQ-12)로 선택될 수 있고 마스킹은 선택된 베이스 위에 균일 적용된다. (변경 2026-06-05, OQ-4 결정: 종전 'pending·holding 점유 종목 제외, 매수 후보 리스트' → 'holding 포함, pending·warning·pause 만 마스킹'.)
+- FR-3: 응답은 **envelope** 로 제공한다(자산은 항상 `assets: []` 배열, null 금지; meta: `view`·`available_slots`·`degraded`·`reason`) (OQ-6). 자산 base 집합은 요청 `view` 파라미터로 선택한다(OQ-11/OQ-12) — **`all`(기본, universe 전체) | `buyable`(universe − 슬롯 점유) | `held`(holding 슬롯만)**. 마스킹(pending·warning·pause)은 전 모드 균일 적용(OQ-4; pending 은 모든 모드 마스킹이라 `held`=holding 만). capacity 는 `available_slots` meta 로 신호하며 `buyable` 은 `available_slots=0` 이면 `[]`. (종전 'capacity 0 → 매수 후보 빈 리스트'는 OQ-4 holding 포함 + 본 결정으로 대체.)
+- FR-4: portfolio-hub read 접근을 `PortfolioHubReadPort.get_portfolios(daemon_id)` 추상화 + portfolio-hub 어댑터(`managed_by_daemon_id` 기준) + 결정론 stub 로 제공하고, dcy-004 의 portfolio-hub 어댑터/자격증명을 재사용한다. `daemon_id` 는 portfolio-hub 자격증명/토큰에서 도출하며(OQ-7, 단일 진실원) 별도 config 값이 아니다(필요 시 whoami 1회 도출·캐시). 전략파라미터는 opaque JSON 으로 통과시킨다(trex-core 가 스키마를 해석하지 않음).
- FR-5: baseline 문서(interface-contract/runtime-flows/project-structure)를 read 포트·스냅샷 read 계약(RabbitMQ RPC)·read 어댑터·일일 스케줄러에 맞게 갱신한다(dcy-006 transport baseline 과 정합).
- FR-6: trex-core daemon 이 설정 가능한 시각(기본 07:30 KST, .env 로 지정)에 일일 스케줄로 `daemon_id` universe 를 페치해 스냅샷을 보유한다. universe 멤버십·전략파라미터는 일일 스냅샷으로 고정하고, 현금/포지션은 스냅샷 baseline 에 더해 **체결 시 portfolio-hub ledger write 응답의 `cash_balance_after` / `asset_quantity_after` 권위 값으로 갱신한다(옵션 D)**. (포지션/현금의 ground truth 는 portfolio-hub 이며 응답값으로 덮어써 로컬 누적 보정 drift 를 제거. portfolio-hub 가 ledger write 를 회계 단일 권위로 단일 트랜잭션 처리하고 `*_after` 를 반환하기로 확정 — A-7, portfolio-hub#8. portfolio-hub 배포(REL-003 등) 시점까지 구현 대기.)
-- FR-7: 스냅샷 페치 시 각 portfolio 의 portfolio-hub 포지션과 실제 브로커 계좌 포지션이 일치하는지 검증한다. 불일치하는 자산은 `warning` 상태로 표시하고 응답 리스트에서 마스킹해 해당 자산에 매매 전략을 수행하지 않는다.
-- FR-8: 스냅샷 read 요청은 선택적 `strategy_id` 파라미터(요청 payload, dcy-006 OQ-2 매핑)를 받는다. `strategy_id` 가 주어지면 해당 전략 ID 가 등록된(= 자산의 `active_strategy_id` 와 일치) 자산만 응답 리스트에 포함하고, `strategy_id` 가 없으면 (pending·warning·pause 마스킹 후) 모든 자산을 반환한다. 여러 전략 모듈이 같은 스냅샷 API 를 공유하되 각자 자기 책임 자산만 받는다. 전략 ID 의 식별자 형태(ID vs 이름)와 "등록" 판정 기준(단일 `active_strategy_id` 일치 vs 다중 등록)은 OQ-9.
-- FR-9: trex-core 가 보유한 스냅샷 universe 의 개별 항목을 사용자가 런타임에 일시 중단(pause)/재개(resume)할 수 있다. pause 된 항목은 전략 모듈의 포트폴리오 요청 결과(FR-2)에서 제외한다. 응답 리스트는 holding 포함을 기본으로 (pending 마스킹) ∧ (warning 마스킹) ∧ (pause 마스킹) ∧ (strategy_id 필터, 주어진 경우)의 합성으로 산출된다. pause 단위(portfolio/asset/symbol), 제어 방식(제어 API vs CLI vs config), 영속성(스냅샷 갱신·daemon 재시작 후 유지 여부), 전략별 vs 전역 적용은 OQ-10.
+- FR-7: 스냅샷 페치 시 각 portfolio 의 portfolio-hub 포지션과 실제 브로커 계좌 포지션이 **수량 정확 일치**하는지 검증한다(symbol 단위 집계, 허용 오차 없음 — OQ-8). 불일치 자산은 `warning` 상태로 표시·응답 리스트에서 마스킹하고 해당 자산에 매매 전략을 수행하지 않으며, **다음 정합 성공 시 자동 해제**한다(영속 hold 는 pause/FR-9). 브로커 포지션은 KIS 주식잔고조회(`TTTC8434R`/`VTTC8434R`, `pdno`+`hldg_qty`)를 BrokerPort 로 조회한다.
+- FR-8: 스냅샷 read 요청은 선택적 `strategy_key` 파라미터(요청 payload, dcy-006 OQ-2 매핑)를 받는다. `strategy_key` 가 주어지면 해당 `strategy_key` 가 등록된(= 자산의 `active_strategy_id` 와 일치) 자산만 응답 리스트에 포함하고, `strategy_key` 가 없으면 (pending·warning·pause 마스킹 후) 모든 자산을 반환한다. 여러 전략 모듈이 같은 스냅샷 API 를 공유하되 각자 자기 책임 자산만 받는다. `strategy_key` 는 사람이 읽을 수 있는 안정 유일 slug(예: `target-value-v1`)이며 자산의 단일 `active_strategy_id` 와 대소문자 구분 정확 일치로 매칭한다(OQ-9; 다중 등록은 범위 밖). `strategy_key` 필터는 `view` 파라미터와 **직교 합성**된다(OQ-12).
+- FR-9: trex-core 가 보유한 스냅샷 universe 의 개별 항목을 사용자가 런타임에 일시 중단(pause)/재개(resume)할 수 있다. pause 된 항목은 전략 모듈의 포트폴리오 요청 결과(FR-2)에서 제외한다. 응답 리스트는 holding 포함을 기본으로 (pending 마스킹) ∧ (warning 마스킹) ∧ (pause 마스킹) ∧ (strategy_key 필터, 주어진 경우)의 합성으로 산출된다. pause 단위는 `portfolio_id`(=asset_id), 제어는 **CLI + dcy-006 RPC 제어 메시지**, **Postgres 영속**(재시작·일일 refresh 후 유지), **전역 적용**, resume 시 다음 요청부터 즉시 복귀(OQ-10). pause(수동·영속) vs warning(자동·일시)은 독립 overlay·OR 합성.
## 비기능 요구사항
성능, 운영성, 일관성, 자동화 안정성 등 기능 외 요구사항을 적는다.
- NFR-1: 도메인 순수성 유지 — read 포트는 application 계약, 어댑터는 adapters 레이어 격리. `trex_core/domain` 은 portfolio-hub/네트워크 의존 0(import 스윕).
- NFR-2: 일관성 — 점유 종목 제외/가용 슬롯 판정은 core 의 권위 슬롯 상태(강한 일관성)를 사용한다. 현금/포지션은 일일 baseline + 체결 시 portfolio-hub ledger write 응답의 `cash_balance_after` / `asset_quantity_after` 권위 값 갱신으로 유지하고(옵션 D), 스냅샷 페치 시 브로커 계좌와 정합 검증한다(불일치 자산 `warning` 제외).
-- NFR-3: 가용성 degrade — portfolio-hub 불가 시 스냅샷 read 의 동작(에러 vs 캐시 fallback vs 빈 응답)은 OQ-5 정책을 따른다.
+- NFR-3: 가용성 degrade — portfolio-hub 가 불가해 권위 cash/position 유지가 불가하면 **명시적 degraded 신호(reason code + sanitize 된 message 포함) + 신규 전략 매매 보수적 중단**(OQ-5; 빈 리스트/silent stale 금지). core 자율 보호 매도는 유지(ledger 는 outbox 로 결국 기록). dcy-006 OQ-4 와 공통 '보수적 안전' 철학.
## 범위 경계
이번 반복에서 반드시 포함할 범위와 명시적으로 제외할 범위를 구분한다.
@@ -123,19 +123,19 @@
- 완화 방안(OQ-2 Answered, 옵션 D): 현금/포지션을 baseline + 체결 시 portfolio-hub ledger write 응답의 권위 cash/position 으로 갱신해 유지. daemon 이 유일 매매 주체이고 장중 입출금이 없다는 전제(A-6)로 정확. 추가로 페치 시 브로커 계좌 정합 검증(FR-7). 잔여 갭: 체결→write flush 사이에는 baseline 값이라 현금이 잠시 stale 할 수 있으나, 중복 매수 배제는 slot overlay(FR-2)가 즉시 담당.
- R-2 (Medium): in-flight race — dcy-004 ledger outbox 가 eventually-consistent 라, 막 체결한 종목이 portfolio-hub 포지션에 아직 반영되기 전 중복 노출될 수 있다.
- 완화 방안(OQ-4 Answered): pending 슬롯 마스킹으로 미체결 in-flight 종목을 응답에서 제외해 중복 노출을 차단한다. 체결 완료(holding)된 자산은 보유 자산으로 포함되며, 전략 모듈이 보유 상태를 보고 재매수하지 않는다(holding 자산의 보유 수량 표기 정합은 core 권위 슬롯 상태 기준 — 설계 시 확정). (종전 'pending·holding 동시 제외'에서 'pending 만 마스킹, holding 포함'으로 변경.)
-- R-3 (Medium): 가용성 결합 — portfolio-hub 장애가 매수 전략 read 를 막는다.
- - 완화 방안(OQ-5): 캐시 fallback 또는 명시적 degrade 응답 정책. 어댑터 격리(NFR-1).
+- R-3 (Medium): 가용성 결합 — portfolio-hub 장애가 전략 read 를 막는다.
+ - 완화 방안(OQ-5 Answered): 권위 cash/position 유지 불가 시 명시적 degraded 신호로 신규 매매 보수적 중단(stale 매매·누적 drift 차단). core 보호 매도는 유지(outbox 로 ledger 결국 기록). 어댑터 격리(NFR-1).
- R-4 (Low): 책임 경계 확장 — core 가 portfolio-hub read gateway 로 비대해질 위험.
- 완화 방안: 모든 소비자가 core 를 경유하되(OQ-3 Answered), core 의 부가가치(slot overlay·현금/포지션 보정·정합 검증)로 범위를 한정하고 단순 패스스루 프록시는 지양한다.
- R-5 (Medium): 포지션 drift — portfolio-hub 가 실제 브로커 계좌와 어긋나면(과거 누락·정합 오류) 스냅샷 baseline 자체가 틀린다. (옵션 D 로 전환해 core 로컬 replay 누적 drift 는 제거되었으나, portfolio-hub ↔ 브로커 계좌 간 drift 는 여전히 남는다.)
- - 완화 방안(FR-7): 스냅샷 페치 시 portfolio-hub 포지션 vs 브로커 계좌 포지션 정합 검증, 불일치 자산은 `warning` 으로 매매 제외(보수적 안전). 일치 기준·회복 규칙은 OQ-8.
+ - 완화 방안(FR-7, OQ-8 Answered): 스냅샷 페치 시 portfolio-hub 포지션 vs 브로커 계좌 포지션 **수량 정확 일치**(symbol 집계) 검증, 불일치 자산은 `warning` 으로 매매 제외(보수적 안전), 다음 정합 성공 시 자동 해제. 브로커 출처 = KIS 주식잔고조회.
## 가정
아직 확정되지 않았지만 현재 문서 작성의 기반이 되는 전제를 적는다.
- A-1: portfolio-hub 는 daemon 인증(`auth_tokens.daemon_id`)으로 자신이 관리하는 portfolio 집합을 조회하는 read 계약을 제공한다. (근거: portfolio-hub `app/api/v1_portfolios.py`·`v1_user_info.py` 의 `auth.daemon_id` 스코프)
- A-2: trex-core 는 슬롯/capacity 의 권위 단일 소스이며, 점유 종목·가용 슬롯 판정에 자기 상태를 사용할 수 있다.
-- A-3: 매수 전략 모듈은 trex-core 외부 소비자이며 dcy-006 transport(RabbitMQ request-reply RPC)로 스냅샷을 받는다(HTTP 아님). logical 계약(필드/마스킹/view 모드/strategy_id)은 transport-무관.
+- A-3: 전략 모듈은 trex-core 외부 소비자이며 dcy-006 transport(RabbitMQ request-reply RPC)로 스냅샷을 받는다(HTTP 아님). logical 계약(필드/마스킹/view 모드/strategy_key)은 transport-무관.
- A-4: dcy-004 의 portfolio-hub 어댑터/자격증명(.env `TREX_PORTFOLIO_HUB_*`)을 read 방향에서도 재사용한다.
- A-5: portfolio-hub 의 `daemon` 은 1급 엔티티이며 portfolio 가 `managed_by_daemon_id` 로 daemon 에 귀속된다(1 daemon : N portfolio, 각 portfolio ≈ 1 asset, asset_id == portfolio_id). 전략파라미터는 portfolio-hub 가 `strategy_params` JSONB 로 보관한다. trex-core daemon 의 universe = 자신이 관리하는 portfolio 집합이다. (근거: portfolio-hub `app/domain/models.py` Daemon/Portfolio, `strategy_params` JSONB migration)
- A-6: 이 trex-core daemon 은 자신이 관리하는 portfolio 의 유일한 매매 주체이며, 장중 거래 외 현금 변동(입출금)은 없다. 따라서 일일 baseline + 체결 시 portfolio-hub write 응답 갱신으로 현금/포지션을 정확히 유지할 수 있다(옵션 D 전제). (사용자 확인 2026-06-04)
@@ -161,39 +161,70 @@
- 결정: 응답(전략 실행 대상 portfolio 자산 리스트)은 **portfolio-hub 보유 자산을 기본 포함하고 holding 슬롯 자산도 포함**한다. 다음 상태만 **마스킹**(제외): (a) 슬롯 pending(미체결 in-flight), (b) warning(브로커 실제 position 불일치, FR-7), (c) 사용자 pause(FR-9). 우선순위: core 권위 슬롯 상태 + 정합 검증 + pause 가 portfolio-hub 보유 여부보다 우선(마스킹 조건 충족 시 보유 여부와 무관하게 제외). in-flight race(R-2)는 pending 마스킹으로 차단; 체결 완료분은 holding 으로 포함. (종전 'pending·holding 동시 제외' → 'holding 포함, pending·warning·pause 마스킹'으로 변경.)
- 반영 위치: `# 3` 시나리오, `# 5` FR-2·FR-9, `# 6` R-2, `# 7` S-2.
- 잔여: holding 자산의 보유 수량 표기를 core 권위 슬롯 vs 스냅샷 중 무엇 기준으로 할지(holding→ledger flush 갭의 수량 정합)는 설계 시 확정. 종전 FR-3(가용 슬롯 0 → 빈 리스트)은 'holding 포함' 변경과 충돌 → OQ-11 로 재정의.
-- OQ-5: 가용성 degrade 정책 — portfolio-hub 불가 시 read 응답을 에러로 반환하는가, 캐시 fallback 하는가, 빈 응답을 반환하는가?
- - 상태: Open
- - 처리 방안: 운영자 결정. 매수 전략의 안전 기본값(보수적 매수 중단) 우선 검토.
- - 종료 조건: degrade 동작이 NFR-3/R-3 에 반영되면 Answered.
-- OQ-6: 빈 리스트 표현 시맨틱 — 응답 리스트가 비었을 때 빈 배열(`[]`)을 반환하는가, null 을 반환하는가, 별도 메타 필드(예: `available_slots: 0`)로 신호하는가?
- - 상태: Open
- - 처리 방안: 매수 전략 모듈 소비 계약에 맞춰 결정(메시지 응답 관례상 빈 배열 + 메타 필드 권장안 검토).
- - 종료 조건: 표현 방식이 FR-3 에 반영되면 Answered.
-- OQ-7: trex-core daemon 의 `daemon_id` 주입 방식 — .env 설정값으로 직접 주입하는가, portfolio-hub 인증 토큰(`auth_tokens.daemon_id`)에서 도출하는가?
- - 상태: Open
- - 처리 방안: 운영자 결정. dcy-004 자격증명 주입(.env `TREX_PORTFOLIO_HUB_*`) 패턴과 정합성 검토.
- - 종료 조건: 주입 방식이 config/FR-4 에 반영되면 Answered.
-- OQ-8: 포지션 정합 검증 세부 — 일치 판정 기준(정확 수량 일치 vs 허용 오차), `warning` 상태 회복 조건(다음 정합 성공 시 자동 해제 여부), 브로커 계좌 포지션 출처(KIS 잔고조회 재사용 범위).
- - 상태: Open
- - 처리 방안: 설계 시 확정. BrokerPort 잔고조회 계약 + `warning` 상태 저장/회복 규칙 정의.
- - 종료 조건: 정합 기준·회복 규칙·포지션 출처가 FR-7 에 반영되면 Answered.
-- OQ-9: 전략 ID 필터의 식별자/등록 시맨틱 — 전략 모듈이 넘기는 파라미터가 안정적 식별자(ID)인가 사람이 읽는 이름인가(사용자 표기 "이름?"), 그리고 "등록" 판정이 자산의 단일 `active_strategy_id` 일치인가 자산당 다중 전략 등록(여러 전략이 한 자산을 공유) 개념인가? portfolio-hub `strategy_params`/`active_strategy_id` 와의 매핑도 함께 확정한다.
- - 상태: Open
- - 처리 방안: 운영자/전략 모듈 계약 확인. 1차안은 안정적 `strategy_id` 식별자 + 단일 `active_strategy_id` 동등 비교. 다중 등록이 필요하면 등록 목록 필드 도입 검토.
- - 종료 조건: 식별자 형태와 등록 판정 기준이 FR-8 에 반영되면 Answered.
-- OQ-10: 런타임 pause/resume 메커니즘 — pause 단위(portfolio/asset/symbol), 제어 방식(전용 제어 메시지(dcy-006 RPC) vs CLI vs config 리로드), 영속성(스냅샷 일일 갱신·daemon 재시작 후 pause 유지 여부와 저장소), 적용 범위(전역 vs 특정 전략 요청에만), resume 시 즉시 응답 복귀 규칙.
- - 상태: Open
- - 처리 방안: 운영자 결정. 1차안은 자산(=portfolio_id) 단위 pause + 제어 API + Postgres 영속(재시작·일일 갱신 후 유지) + 전역 적용. 사용 시나리오(운영 중 특정 종목만 일시 정지)에 맞춰 확정.
- - 종료 조건: pause 단위·제어 방식·영속성·적용 범위가 FR-9 에 반영되면 Answered.
+- OQ-5: 가용성 degrade 정책 — portfolio-hub 불가 시 스냅샷 read 동작.
+ - 상태: Answered (2026-06-05)
+ - 결정: portfolio-hub 가 불가해 **권위 cash/position 을 유지할 수 없는 상태**(옵션 D 의 ledger write `*_after` 갱신 불가, 또는 일일 universe fetch 실패)면 **신규 전략 매매를 보수적으로 중단**한다. 차단 사유는 'ledger 기록 불가'가 아니라(dcy-004 outbox 가 유실 없이 결국 기록) **stale cash/position 으로 매매 시 잘못된 사이징·누적 drift 위험**이다.
+ - read 응답: 빈 리스트(`[]` — '후보 없음'과 모호)나 silent stale 캐시 서빙 대신 **명시적 degraded 신호**를 실어 전략이 신규 매매를 보류하게 한다. 신호는 `degraded=true` + **degraded 사유**를 포함한다 — machine-readable reason code(예: `portfolio_hub_unavailable` / `snapshot_fetch_failed` / `cash_position_stale`)로 전략이 원인별 분기 가능하게 하고, 사람용 message 로 운영 진단을 돕는다. 단 raw 예외/자격증명 등 민감정보는 노출하지 않고 sanitize 한다.
+ - core 자율 보호 매도(손절·시간 만기, dcy-006 A-5)는 **계속 동작** — 그 체결의 ledger 도 outbox 가 복구 후 기록하므로 outage 중에도 열린 포지션은 보호된다. 즉 '중단'은 신규 전략 매매에 한정한다.
+ - dcy-006 OQ-4(RabbitMQ degrade)와 **공통 '보수적 안전' 철학**: 임의의 핵심 의존성(portfolio-hub OR RabbitMQ) degrade 시 신규 매매 중단 + core 보호 매도 유지.
+ - 반영 위치: `# 5` NFR-3, `# 6` R-3.
+ - 종료 조건(충족): degrade 동작이 NFR-3/R-3 에 반영됨.
+- OQ-6: 빈 리스트 표현 시맨틱 — 응답이 비었을 때의 표현.
+ - 상태: Answered (2026-06-05)
+ - 결정: 응답은 **envelope** 로 감싸고 자산 목록은 항상 배열(`assets: []`, **null 금지**)로 준다. 빈 배열은 '항목 없음'을 그대로 의미하고, '왜 비었는지'는 envelope 의 meta 로 구분한다 — `view`(에코된 view 모드, OQ-11/12), `available_slots`(capacity 신호), `degraded`+`reason`(OQ-5). 근거: 리스트 필드에 null 을 섞으면 소비자 분기·버그 유발 → 항상 배열. 빈 리스트만으로는 capacity 0 / 전부 마스킹 / 필터 0매칭 / degrade 를 구분 못 하므로 envelope 필요(OQ-5 가 이미 `degraded`/`reason` 을 요구해 envelope 는 사실상 강제). transport 가 메시지 payload(dcy-006 RPC)라 REST status-code 가 아니라 구조화 envelope 가 자연스럽다.
+ - 반영 위치: `# 5` FR-3 (자산 항목(FR-1)·마스킹(FR-2)은 envelope 의 `assets[]` 원소로 위치).
+ - 종료 조건(충족): 표현 방식(envelope + `[]`)이 FR-3 에 반영됨. 정확한 envelope 필드 스키마는 OQ-12 view 파라미터와 함께 REQ/설계 단계 확정.
+- OQ-7: trex-core daemon 의 `daemon_id` 출처.
+ - 상태: Answered (2026-06-05)
+ - 결정: `daemon_id` 는 **portfolio-hub 자격증명/인증 토큰(`auth_tokens.daemon_id`)에서 도출**한다(단일 진실원). 별도 `TREX_DAEMON_ID` .env 설정값을 1차 출처로 두지 않는다 — 자격증명과 분리 설정 시 dual-source drift(잘못된 universe·auth 오류) 위험. portfolio-hub read 는 토큰으로 daemon 을 스코프하므로(A-1) trex-core 는 daemon_id 를 명시적으로 들 필요가 가급적 없고, 값이 필요하면 startup 때 whoami(portfolio-hub `v1_user_info` 류) 1회로 도출·캐시한다. .env override 는 테스트/stub 한정이며 startup 에서 토큰 daemon_id 와 일치 검증(불일치 시 fail-closed)한다. dcy-004 의 `TREX_PORTFOLIO_HUB_*` 자격증명을 재사용하므로 신규 `TREX_DAEMON_ID` 주입은 불필요.
+ - 반영 위치: `# 4` 영향 범위(config), `# 5` FR-4.
+ - 종료 조건(충족): daemon_id 출처가 FR-4/영향 범위에 반영됨.
+- OQ-8: 포지션 정합 검증 세부.
+ - 상태: Answered (2026-06-05)
+ - 결정:
+ 1. **일치 기준 = 수량 정확 일치**(정수 shares, 허용 오차 없음). A-6(유일 매매 주체·장중 외부 변동 없음)상 portfolio-hub 포지션과 브로커 잔고는 동일 체결에서 파생되어 정확히 일치해야 하며, tolerance 는 실제 이상(누락 체결·외부 거래)을 가린다. 현금은 FR-7 범위 밖(수수료·세금·T+2 결제로 단순 비교 불가) — 수량만 대조.
+ 2. **warning 회복 = 다음 정합 성공 시 자동 해제**(매 정합 사이클 재계산되는 파생 플래그, sticky 아님). raise 는 매번 로깅/alert. 영속 hold 가 필요하면 운영자 pause(FR-9)로 분리한다(자동 warning=일시 / 수동 pause=영속).
+ 3. **브로커 포지션 출처 = KIS 주식잔고조회**(실전 `TTTC8434R` / 모의 `VTTC8434R`, `GET /uapi/domestic-stock/v1/trading/inquire-balance`)를 BrokerPort 잔고조회로 재사용. 항목당 `pdno`(종목코드) + `hldg_qty`(보유수량). paper broker 는 결정론 stub.
+ - **symbol 단위 집계 대조**: 브로커는 단일 계좌(dcy-003 불변식 B)라 잔고가 symbol 단위 집계 → portfolio-hub per-portfolio 포지션을 symbol 로 합산해 broker per-symbol `hldg_qty` 와 대조(보통 1 portfolio:1 symbol 이나 안전하게 집계 기준).
+ - 주의: 당일 전량매도분이 `hldg_qty=0` 으로 D-2 까지 잔고에 남을 수 있음(015 문서) → 0 수량 잔고 처리 규칙은 설계 시 확정.
+ - 반영 위치: `# 4` 영향 범위, `# 5` FR-7, `# 6` R-5.
+ - 참고: docs/broker/kis/rest/국내주식/주문/계좌/015_v1_국내주식-006_주식잔고조회.md
+ - 종료 조건(충족): 정합 기준·회복 규칙·포지션 출처가 FR-7 에 반영됨.
+- OQ-9: 전략 ID 필터의 식별자/등록 시맨틱.
+ - 상태: Answered (2026-06-05)
+ - 결정:
+ - **식별자 형태**: 전략 모듈이 넘기는 `strategy_key` 는 **사람이 읽을 수 있으면서 ID 역할을 하는 유일·안정 값**(human-readable stable slug, 예: `target-value-v1`)이다. 'display name vs opaque ID' 이원화 없이 이 slug 자체가 유일 키다. 매칭은 대소문자 구분 정확 일치(exact).
+ - **명명(2026-06-05)**: 파라미터명을 `strategy_id` → **`strategy_key`** 로 변경한다. portfolio-hub 의 `strategy_id`(그쪽 내부 전략 엔티티 ID)와 이름이 겹쳐 혼동되므로 분리한 것이다. `strategy_key` 는 trex-core 요청 파라미터(전략 모듈 자기 식별자)이며, 그 **값은 자산의 portfolio-hub `active_strategy_id` 와 매칭**된다.
+ - **등록 판정**: 자산의 **단일 `active_strategy_id` 와 동등 비교**(`strategy_key == active_strategy_id`). 한 자산은 한 시점에 하나의 active 전략에 귀속한다(portfolio-hub `active_strategy_id` 단일, A-5). 자산당 다중 전략 등록(예: buy/sell 분리, trex-core#1)은 **현재 범위 밖**이며 필요해지면 '등록 목록' 필드로 확장(후속).
+ - 반영 위치: `# 5` FR-8, `# 3` 시나리오.
+ - 종료 조건(충족): 식별자 형태·등록 판정이 FR-8 에 반영됨.
+- OQ-10: 런타임 pause/resume 메커니즘.
+ - 상태: Answered (2026-06-05)
+ - 결정:
+ - **단위**: `portfolio_id`(= asset_id) — universe 항목 키. (symbol 은 다중 portfolio 공유 시 모호하므로 portfolio_id 기준.)
+ - **제어 방식**: 운영자 admin 액션으로 **CLI + dcy-006 RPC 제어 메시지** 둘 다 제공(로컬 CLI + 원격 ops). config 리로드는 비채택.
+ - **영속성**: **Postgres 영속**(기존 단일 store), portfolio_id 키. daemon 재시작 후 유지, 일일 스냅샷 refresh 와 무관(refresh 는 universe/포지션만 갱신, pause overlay 불변).
+ - **적용 범위**: **전역** — 모든 전략 요청에서 마스킹(운영자 안전 액션, 어느 전략이 묻든 거래 금지).
+ - **resume**: pause 는 request-time mask 라 resume 시 **다음 요청부터 즉시 응답 복귀**(일일 갱신 대기 불요).
+ - pause(수동·영속) vs warning(자동·일시, OQ-8)은 독립 overlay 이며 OR 합성(둘 중 하나라도면 마스킹).
+ - 반영 위치: `# 4` 영향 범위, `# 5` FR-9.
+ - 종료 조건(충족): pause 단위·제어 방식·영속성·적용 범위가 FR-9 에 반영됨.
- OQ-11: capacity 소진 시 응답 시맨틱.
- 상태: Answered (2026-06-05) — 방향 확정, 파라미터 설계는 OQ-12 로 분리.
- - 결정: capacity(가용 슬롯)가 모두 소진됐을 때의 응답은 **고정값이 아니라 전략 모듈이 요청 시 지정하는 view 모드(파라미터)에 따라 달라진다.** 최소 3개 모드: (a) **빈 리스트 `[]`** (신규 매수 후보가 목적인 전략 — 살 게 없음), (b) **슬롯 점유 자산만** (보유 포지션 관리·매도/조절 전략 — 자기가 들고 있는 것만), (c) **portfolio 스냅샷 − 슬롯 점유 자산** (점유 안 된 잔여 universe). 같은 view 모드 개념은 capacity 0 이 아닐 때도 응답 구성을 좌우한다(이 파라미터는 strategy_id 필터(FR-8)와 별개의 두 번째 요청 파라미터).
+ - 결정: capacity(가용 슬롯)가 모두 소진됐을 때의 응답은 **고정값이 아니라 전략 모듈이 요청 시 지정하는 view 모드(파라미터)에 따라 달라진다.** 최소 3개 모드: (a) **빈 리스트 `[]`** (신규 매수 후보가 목적인 전략 — 살 게 없음), (b) **슬롯 점유 자산만** (보유 포지션 관리·매도/조절 전략 — 자기가 들고 있는 것만), (c) **portfolio 스냅샷 − 슬롯 점유 자산** (점유 안 된 잔여 universe). 같은 view 모드 개념은 capacity 0 이 아닐 때도 응답 구성을 좌우한다(이 파라미터는 strategy_key 필터(FR-8)와 별개의 두 번째 요청 파라미터). (→ OQ-12 에서 enum `all`/`buyable`/`held` 으로 확정.)
- 반영 위치: `# 5` FR-2·FR-3, `# 6` OQ-12.
- - 잔여(→ OQ-12): 파라미터 이름/enum 값, 기본 모드(생략 시), 각 모드와 마스킹(pending·warning·pause, OQ-4)·strategy_id 필터의 합성 규칙, capacity 신호 메타 필드(OQ-6) 동반 여부.
-- OQ-12: 응답 view/scope 파라미터 설계 — OQ-11 의 모드 선택을 어떤 요청 파라미터로 노출하는가.
- - 상태: Open
- - 처리 방안: 전략 모듈 소비 계약에 맞춰 결정. 정의 대상: (1) 요청 파라미터 이름·enum(예: `view` = buyable|held|remainder|all, 요청 payload — dcy-006 OQ-2 매핑), (2) 생략 시 기본 모드, (3) 각 모드 베이스 집합에 OQ-4 마스킹(pending·warning·pause)과 FR-8 strategy_id 필터를 어떻게 합성하는지(특히 'held' 모드에서 pending 포함 여부), (4) capacity 가용성 메타 필드(OQ-6) 동반 여부. 매수/매도/position 전략 구분(trex-core#1)과도 연계 — view 모드가 전략 타입별 뷰를 제공.
- - 종료 조건: 파라미터 스펙·기본 모드·합성 규칙이 FR-2/FR-3/FR-8 에 반영되면 Answered.
+ - 잔여(→ OQ-12): 파라미터 이름/enum 값, 기본 모드(생략 시), 각 모드와 마스킹(pending·warning·pause, OQ-4)·strategy_key 필터의 합성 규칙, capacity 신호 메타 필드(OQ-6) 동반 여부.
+- OQ-12: 응답 view/scope 파라미터 설계.
+ - 상태: Answered (2026-06-05)
+ - 결정:
+ - **파라미터**: 요청 payload `view`(dcy-006 OQ-2 매핑), enum = **`all` | `buyable` | `held`**. base 집합 — `all` = universe 전체(portfolio-hub 보유 + holding 슬롯), `buyable` = universe − 슬롯 점유(미점유 신규 진입 후보), `held` = holding 슬롯 자산만. (1차안의 `remainder` 는 `buyable` 과 동일이라 drop.)
+ - **기본 모드**: 생략 시 **`all`**(OQ-4/FR-2 holding 포함·FR-8 전체와 정합).
+ - **마스킹 직교·균일**: 모드는 base 집합만 고르고, 마스킹(pending·warning·pause)은 전 모드 균일 적용. **pending 은 모든 모드 마스킹** → `held` = holding 만(미체결 제외). warning/pause 도 전 모드 마스킹.
+ - **strategy_key 직교**: `view` 와 `strategy_key`(FR-8)는 독립 합성 — `assets = base(view) − mask(pending·warning·pause) − (strategy_key 필터, 주어지면)`.
+ - **capacity**: envelope 에 `available_slots` 항상 포함(OQ-6). `buyable` 은 capacity-gated — `available_slots=0` 이면 `[]`(OQ-11 정합). `held` 엔 정보성.
+ - **전략 타입 매핑(trex-core#1)**: `buyable`=매수, `held`=position/매도, `all`=통합.
+ - 반영 위치: `# 5` FR-2·FR-3·FR-8.
+ - 종료 조건(충족): 파라미터 스펙·기본 모드·합성 규칙이 FR-2/FR-3/FR-8 에 반영됨.
### 오픈 질문 처리 기준
- `Open`: 아직 답이 없고 다음 단계 진행에 영향이 있는 상태다. 문서에 유지한다.
@@ -209,12 +240,16 @@
- S-1: stub portfolio-hub read 로, 스냅샷 API 가 portfolio-hub 종목을 포함한 전략 실행 대상 자산 리스트를 반환한다.
- S-2: holding 슬롯 자산은 응답에 포함되고, pending 슬롯 자산은 마스킹되어 제외된다(slot overlay).
-- S-3: (재정의 대기 — OQ-11) 가용 슬롯 0 일 때의 응답 시맨틱(holding 포함 여부·신규 매수 불가 신호)이 확정된 대로 동작한다.
+- S-3: 가용 슬롯 0 일 때 `view=all`/`held` 는 보유 자산을 계속 반환하고 `view=buyable` 은 `[]` 를 반환하며, `available_slots=0` meta 가 신호된다(OQ-11/OQ-12).
- S-4: 도메인 import 스윕에서 portfolio-hub/네트워크 의존이 0 으로 유지된다.
- S-5: interface-contract/runtime-flows/project-structure 가 read 레이어와 정합한다.
- S-6: 스냅샷 페치 시 portfolio-hub 포지션과 브로커 계좌 포지션이 불일치하는 자산이 `warning` 으로 표시되고 응답 리스트에서 마스킹된다.
-- S-7: `strategy_id` 를 넣어 호출하면 해당 전략 ID 가 등록된 자산만, 생략하면 전체 자산이 반환된다.
+- S-7: `strategy_key` 를 넣어 호출하면 해당 `strategy_key` 가 등록된 자산만, 생략하면 전체 자산이 반환된다.
- S-8: 자산을 런타임에 pause 하면 응답 리스트에서 마스킹되고, resume 하면 다시 포함된다.
+- S-9: portfolio-hub 가 불가해 권위 cash/position 유지가 불가하면 응답에 `degraded=true` + reason code 가 실려 신규 매매 보류를 신호한다(OQ-5).
+- S-10: 요청 `view`(`all`/`buyable`/`held`)별로 base 집합이 다르고 마스킹(pending·warning·pause)은 전 모드 균일 적용된다(OQ-12).
+- S-11: 응답이 `assets`(항상 배열, 비면 `[]`·null 아님) + meta(`view`·`available_slots`·`degraded`·`reason`) envelope 형태다(OQ-6).
+- S-12: 별도 `TREX_DAEMON_ID` 없이 portfolio-hub 토큰에서 도출한 daemon_id 로 universe 를 조회한다(OQ-7).
## 측정 방식 및 데이터 출처
각 성공 기준을 어떻게 측정할지와 어떤 데이터나 문서를 근거로 쓸지 적는다.
@@ -225,8 +260,12 @@
- S-4 측정 방식: 정적 import 스윕 / 데이터 출처: `trex_core/domain` import 목록.
- S-5 측정 방식: 문서-코드 정합 점검(리뷰) / 데이터 출처: baseline 문서 vs 실제 메시지 계약(RPC)/read 포트.
- S-6 측정 방식: 포지션 불일치 주입 후 스냅샷 페치 테스트 / 데이터 출처: 자산 `warning` 상태·응답 리스트.
-- S-7 측정 방식: `strategy_id` 유/무 호출 비교 테스트 / 데이터 출처: 응답 리스트 vs 자산 `active_strategy_id`.
+- S-7 측정 방식: `strategy_key` 유/무 호출 비교 테스트 / 데이터 출처: 응답 리스트 vs 자산 `active_strategy_id`.
- S-8 측정 방식: pause→호출→resume→호출 시퀀스 테스트 / 데이터 출처: 응답 리스트 포함/제외 여부.
+- S-9 측정 방식: portfolio-hub 불가(권위 유지 불가) 주입 후 호출 테스트 / 데이터 출처: 응답 `degraded`·`reason` 필드.
+- S-10 측정 방식: `view` 값별 호출 비교 테스트 / 데이터 출처: 응답 base 집합 vs 슬롯 상태·마스킹.
+- S-11 측정 방식: 응답 스키마 검증(빈 응답 포함) / 데이터 출처: 응답 envelope 구조(`assets` 타입·meta 필드).
+- S-12 측정 방식: `TREX_DAEMON_ID` 미설정 기동 후 universe 조회 테스트 / 데이터 출처: 토큰 도출 daemon_id vs 조회된 portfolio 집합.
# 8. REQ로 넘기기 전 확인 체크
REQ 초안 작성 단계로 넘기기 전에 무엇이 확정되어야 하는지 확인한다. 미완료 항목은 후속 결정이 필요함을 뜻한다.
@@ -234,11 +273,11 @@ REQ 초안 작성 단계로 넘기기 전에 무엇이 확정되어야 하는지
- [ ] 범위(In Scope/Out of Scope) 확정 — 특히 전략 의사결정 로직·reconciliation 제외
- 기준: 운영자가 read 슬라이스 경계를 확인했다.
- [ ] 성공 지표의 측정 방식/데이터 출처 확정
- - 기준: S-1~S-5 측정 방식·출처 명시(본 문서 # 7).
+ - 기준: S-1~S-12 측정 방식·출처 명시(본 문서 # 7).
- [ ] High 영향 리스크 우선순위 및 해소 책임자 지정
- 기준: 본 Discovery 의 리스크는 현재 전부 Medium/Low. 신선도(R-1)·race(R-2)·가용성(R-3) 처리 방침을 운영자가 확인.
- [ ] 모든 오픈 질문(OQ) `Open` 상태 없음 확인
- - 기준: OQ-1~OQ-12 이 전부 Answered/Deferred 처리(현재 OQ-1·OQ-2·OQ-3·OQ-4·OQ-11 Answered, OQ-5~OQ-10·OQ-12 Open).
+ - 기준: OQ-1~OQ-12 이 전부 Answered/Deferred 처리(현재 OQ-1~OQ-12 전부 Answered).
- [ ] Freeze 확정 담당자(CONFIRMED_BY) 지정
- 기준: 운영자가 confirm-discovery 시점에 CONFIRMED_BY 를 지정한다.
@@ -259,18 +298,18 @@ REQ 초안 작성 단계로 넘기기 전에 무엇이 확정되어야 하는지
## DECIDE
- ~~스냅샷 응답 단위/필드~~ → 결정됨: daemon 관리 portfolio universe(symbol/asset_id/현금/포지션/active_strategy_id/전략파라미터 opaque JSON), 가격 제외 (OQ-1, 2026-06-04)
- ~~신선도 정책~~ → 결정됨: universe·전략파라미터 설정 시각 일일 캐시 + 현금/포지션 baseline + 체결 시 portfolio-hub write 응답의 권위 cash/position 갱신(옵션 D) (OQ-2, 2026-06-04 / 옵션 C→D 개정 2026-06-05)
-- {{DECIDE_DAEMON_ID_INJECTION}} — trex-core daemon 의 daemon_id 주입(.env vs 인증 토큰) (OQ-7)
-- {{DECIDE_EMPTY_SEMANTICS}} — 가용 슬롯 0 시 빈 배열 vs null vs 메타 필드 표현 (OQ-6)
+- ~~daemon_id 주입~~ → 결정됨: portfolio-hub 자격증명/토큰에서 도출(단일 진실원), 별도 `TREX_DAEMON_ID` 불필요; .env override 는 테스트 한정 + 토큰 일치 fail-closed (OQ-7, 2026-06-05)
+- ~~빈 표현 시맨틱~~ → 결정됨: envelope + `assets: []`(null 금지), meta(`view`·`available_slots`·`degraded`·`reason`)로 의미 분리 (OQ-6, 2026-06-05)
- ~~capacity 0 시 응답 재정의~~ → 결정됨: 응답 형태를 전략 모듈 요청 view 모드 파라미터로 선택(빈 `[]` / 슬롯 점유 자산만 / portfolio−점유) (OQ-11, 2026-06-05)
-- {{DECIDE_VIEW_PARAM}} — 응답 view/scope 파라미터 설계: 이름·enum·기본 모드·마스킹/strategy_id 합성·capacity 메타 (OQ-12)
-- {{DECIDE_STRATEGY_ID_SEMANTICS}} — 전략 ID 파라미터의 식별자 형태(ID vs 이름)와 등록 판정(단일 active vs 다중 등록) (OQ-9)
-- {{DECIDE_PAUSE_MECHANISM}} — pause/resume 단위·제어 방식(API/CLI/config)·영속성·적용 범위 (OQ-10)
+- ~~응답 view/scope 파라미터~~ → 결정됨: `view`=`all`(기본)|`buyable`|`held`, strategy_key 직교 합성, 마스킹 전 모드 균일(`held`=holding만), `available_slots` 메타(buyable은 0이면 `[]`) (OQ-12, 2026-06-05)
+- ~~전략 ID 시맨틱~~ → 결정됨: 사람이 읽는 안정 유일 slug(예: `target-value-v1`), 자산의 단일 `active_strategy_id` 와 정확 일치; 다중 등록은 범위 밖 (OQ-9, 2026-06-05)
+- ~~pause/resume 메커니즘~~ → 결정됨: portfolio_id 단위, CLI + dcy-006 RPC 제어, Postgres 영속(refresh 무관), 전역, 즉시 복귀 (OQ-10, 2026-06-05)
## CONFIRM
- {{CONFIRM_READ_SCOPE}} — read 슬라이스 범위 경계(전략 로직·reconciliation 제외) 확정
- ~~core 경유 정책~~ → 결정됨: 모든 소비자 trex-core 경유, portfolio-hub 직접 호출 금지 (OQ-3, 2026-06-04)
- ~~in-flight 합성/제외 규칙~~ → 결정됨: holding 포함, pending·warning·pause 마스킹, core 권위 우선 (OQ-4, 2026-06-05)
-- {{CONFIRM_AVAILABILITY_DEGRADE}} — portfolio-hub 불가 시 가용성 degrade 정책 (OQ-5)
+- ~~가용성 degrade 정책~~ → 결정됨: 권위 cash/position 유지 불가 시 명시적 degraded 신호 + 신규 매매 보수적 중단, core 보호 매도 유지 (OQ-5, 2026-06-05). dcy-006 OQ-4 와 공통 보수적 안전.
## DATA
- {{DATA_PORTFOLIO_HUB_READ_CONTRACT}} — portfolio-hub read API 계약(`managed_by_daemon_id` 로 daemon universe 조회) 및 응답 필드(cash_balance/asset_quantity/strategy_params JSONB) 확인
@@ -288,7 +327,7 @@ REQ 초안 작성 인계 시점의 확정 플래그와 섹션 참조만 기록
## Freeze 플래그
- Handoff Decision: 보류
-- Handoff Rationale: OQ-1(스냅샷 정의)·OQ-2(신선도, 옵션 D — portfolio-hub#8 write 응답 `*_after` 확정)·OQ-3(core 경유 정책)·OQ-4(in-flight 합성 — holding 포함, pending·warning·pause 마스킹)·OQ-11(capacity 0 응답 — view 모드 파라미터) Answered. OQ-5~OQ-10·OQ-12(가용성 degrade·빈 표현 시맨틱·daemon_id 주입·포지션 정합 세부·전략 ID 필터 시맨틱·런타임 pause/resume·응답 view 파라미터 설계)이 미확정이며, confirm-discovery 에서 운영자 결정 후 REQ Drafting 으로 인계한다.
+- Handoff Rationale: OQ-1(스냅샷 정의)·OQ-2(신선도, 옵션 D — portfolio-hub#8 write 응답 `*_after` 확정)·OQ-3(core 경유 정책)·OQ-4(in-flight 합성 — holding 포함, pending·warning·pause 마스킹)·OQ-5(가용성 degrade — 권위 cash/position 유지 불가 시 degraded 신호+보수적 중단)·OQ-6(빈 표현 — envelope + `assets: []`/meta)·OQ-7(daemon_id — 토큰 도출 단일 진실원)·OQ-8(정합 — 수량 정확 일치·symbol 집계·자동 해제·KIS 잔고조회)·OQ-9(전략 ID — 사람이 읽는 안정 slug·단일 active 일치)·OQ-10(pause — portfolio_id·CLI+MQ·Postgres 영속·전역·즉시 복귀)·OQ-11(capacity 0 응답 — view 모드 파라미터)·OQ-12(view 파라미터 — `all`/`buyable`/`held` + envelope) **전부 Answered**. 남은 인계 전 항목은 범위 경계 확인(운영자)과 CONFIRMED_BY 지정이며, confirm-discovery 에서 확정 후 REQ Drafting 으로 인계한다.
- Ready for REQ Drafting: false
- Confirmed By: TBD
- Confirmed At (KST): TBD
diff --git a/docs/discovery/dcy-006_20260605_strategy-module-rabbitmq-transport.md b/docs/discovery/dcy-006_20260605_strategy-module-rabbitmq-transport.md
index f17bb89..a34f791 100644
--- a/docs/discovery/dcy-006_20260605_strategy-module-rabbitmq-transport.md
+++ b/docs/discovery/dcy-006_20260605_strategy-module-rabbitmq-transport.md
@@ -5,10 +5,10 @@
- 문서 ID: dcy-006_20260605_strategy-module-rabbitmq-transport
- 이슈명: trex-core ↔ 전략 모듈 통신 transport — RabbitMQ 도입 (스냅샷 read + intent 제출 + 이벤트)
- 작성 시각(KST): 2026-06-05 21:23
-- 마지막 갱신 시각(KST): 2026-06-05 22:30
+- 마지막 갱신 시각(KST): 2026-06-05 22:45
- 대체됨: 없음
- 후속 Discovery 참조: 없음
-- 생성된 REQ 참조: 없음
+- 생성된 REQ 참조: REQ-021, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026
# 1. 계획 상태 요약
현재 Discovery가 어떤 배경에서 작성되고 있는지, 연계 문서가 있는지, 지금 시점의 해석이 무엇인지 짧게 요약한다.
diff --git a/docs/interface-contract.md b/docs/interface-contract.md
index 0cc628b..670e1b0 100644
--- a/docs/interface-contract.md
+++ b/docs/interface-contract.md
@@ -4,7 +4,7 @@
- Baseline Seed: .stage-pilot/bootstrap/baseline.yaml
- Status: draft
- Owner: project maintainers
-- Last Updated (KST): 2026-06-04 (BAT-006)
+- Last Updated (KST): 2026-06-05 (BAT-007)
- Source Discovery / Batch: bootstrap-baseline (pre-Discovery); HTTP API = dcy-002 / BAT-002
- Primary Runtime: daemon (HTTP API) + library (slot 도메인)
@@ -25,33 +25,86 @@
## Interface Summary
-- HTTP `/v1` API :: 슬롯 코어 데몬이 노출, 매수·매도 전략 데몬이 호출(REQ-005/007/008)
+- RabbitMQ `trex.snapshot.req` :: 전략 모듈의 스냅샷 RPC (request-reply, BAT-007)
+- RabbitMQ `trex.intent.req` :: 전략 모듈의 매수/매도 admission RPC (request-reply, BAT-007)
+- RabbitMQ `trex.events` :: 체결/슬롯 상태 이벤트 topic exchange (pub/sub, BAT-007)
- SlotService :: 슬롯 생명주기 도메인 서비스(전이/사전할당/가용성/재진입 카운트)
- SlotRepository (Protocol) :: 도메인 ↔ 저장소 경계 계약
- BrokerPort (Protocol) :: 단일 브로커 세션 경계(submit/poll/cancel) + `OrderRequest`/`OrderAck`/`FillStatus`
- LedgerPort (Protocol) :: 외부 원장(portfolio-hub) 기록 경계 + `LedgerTrade`/`LedgerWriteResult`/예외 (BAT-006)
- LedgerOutbox (Protocol) + LedgerWriter :: 체결 → 원장 기록의 outbox/재시도/멱등 (BAT-006)
+- MessagingTransport (Protocol) :: RabbitMQ / InMemory stub transport 경계 + `TransportHealth` enum (BAT-007)
-## Interface: `HTTP /v1` (슬롯 코어 데몬)
+> BAT-007 에서 HTTP `/v1` API 표면이 0 으로 제거됨(REQ-025). 이전 baseline 의 `HTTP /v1` 인터페이스 섹션은 더 이상 유효하지 않으며 본 인터페이스 인덱스에서 제거되었다. 전략-facing 통신은 위의 3 RabbitMQ 표면이 전부다.
-- Type: http-api
-- Consumers / Producers: 매수·매도 전략 데몬(클라이언트) → trex-core 슬롯 코어 데몬(서버). FastAPI+uvicorn.
-- Purpose: 전략이 intent 를 제출하고 holding 스냅샷/capacity 를 조회. 코어가 단독 admission + 슬롯 전이(단일 writer).
-- Stability: experimental (v1, 슬라이스 1)
+## Interface: `RabbitMQ messaging` (전략 모듈 ↔ trex-core, BAT-007)
-| 엔드포인트 | 입력 | 출력 | 에러/거부 |
+- Type: amqp-messaging
+- Consumers / Producers: trex-core daemon ↔ 전략 모듈(외부 소비자). RabbitMQ broker(`TREX_RABBITMQ_URL`) 가 transport.
+- Purpose: HTTP `/v1` API 를 대체하는 메시지 기반 통신. 코어가 단독 admission + 슬롯 전이(단일 writer 불변식 A) 를 유지.
+- Stability: experimental (BAT-007)
+
+### Topology
+
+| 종류 | 이름 | 타입/속성 | 용도 |
|---|---|---|---|
-| `GET /v1/healthz` | — | `{status:"ok"}` 200 | — |
-| `POST /v1/intents/buy` | intent_id, trading_date, symbol, qty?, allocated_capital?, entry_price?, strategy_id?, sell_strategy_id?, portfolio_id?, forced_close_at? | `{intent_id, status:admitted|rejected, slot_id?, reason?}` | reject: `no_idle_slot`, `idle_slot_contended` |
-| `POST /v1/intents/sell` | intent_id, slot_id, reason?, sell_strategy_id? | `{intent_id, status, slot_id?, reason?}` | reject: `slot_not_found`, `slot_not_holding:`, `slot_state_changed` |
-| `GET /v1/intents/{intent_id}` | path intent_id | `{intent_id, status, slot_id?, reason?}` | 404 intent not found |
-| `GET /v1/slots?status=&trading_date=` | query | `[SlotSnapshot]` | — |
-| `GET /v1/capacity?trading_date=&total_slots=` | query | `{idle_count, holding_count, pending_count, total_slots, scarcity_ratio}` | — |
+| 큐 | `trex.snapshot.req` | durable | 스냅샷 RPC 요청 큐 (read-only) |
+| 큐 | `trex.intent.req` | durable, `x-dead-letter-exchange=trex.events.dlq` | intent admission RPC 요청 큐 |
+| 익스체인지 | `trex.events` | topic, durable | 체결/슬롯 상태 이벤트 발행 |
+| 익스체인지 | `trex.events.dlq` | fanout, durable | 처리 실패/unroutable 메시지 격리 |
+| 큐 | `trex.events.dlq` | durable | DLQ 수집기 큐 (`trex.events.dlq` 익스체인지 바인딩) |
+| 큐 (전략별) | `trex.events.strategy.{strategy_id}` | durable, `x-message-ttl=3.6e6`, `x-max-length=10000`, `x-overflow=drop-head` | 전략 모듈별 이벤트 수신 큐 (`*.{strategy_id}.#` 바인딩) |
-### Compatibility / Invariants
-- 멱등: `intent_id` dedup(intent_log UNIQUE gate). at-least-once 재전송에도 슬롯 1회만 전이; 재조회는 `GET /v1/intents/{id}`.
-- 단일 writer: 모든 슬롯 쓰기는 코어의 SlotService(advisory lock)만. 전략은 제안만, 슬롯/브로커 직접 접근 금지.
-- 동기 커밋: 수락 시 admission+전이를 동기 커밋 후 admit/reject 응답(완전 비동기 outbox 는 브로커 Discovery Deferred).
+### Patterns
+
+| 패턴 | 표면 | 요청 속성 | 응답 |
+|---|---|---|---|
+| 스냅샷 RPC | `trex.snapshot.req` | `correlation_id`, `reply_to=amq.rabbitmq.reply-to` | reply-to 큐로 `{view, strategy_id, trading_date, slots[], capacity{}}` |
+| intent RPC | `trex.intent.req` | `correlation_id` = intent 멱등키, `reply_to=amq.rabbitmq.reply-to`, `delivery_mode=2` | reply-to 큐로 `{intent_id, status:admitted|rejected, slot_id?, reason?}`. 체결/종료는 응답 아닌 이벤트로 |
+| 이벤트 pub/sub | `trex.events` (topic) | routing key `{event_type}.{strategy_id}.{symbol}` | 전략 큐가 자기 `strategy_id` 패턴으로 바인딩 |
+
+### Message contracts
+
+#### `trex.snapshot.req` 요청 payload
+```
+{ "view": "open" | "all", "strategy_id": str | null, "trading_date": "YYYY-MM-DD" }
+```
+응답 payload는 슬롯 목록과 capacity 를 운반한다. view 모드와 strategy_id 는 payload(요청 매핑 원칙 — REQ-021).
+
+#### `trex.intent.req` 요청 payload (buy)
+```
+{ "intent_type": "buy",
+ "intent_id": "",
+ "trading_date": "YYYY-MM-DD",
+ "symbol": str, "qty": float?, "allocated_capital": float?,
+ "entry_price": float?, "strategy_id": str?, "sell_strategy_id": str?,
+ "portfolio_id": str?, "forced_close_at": "ISO-8601"? }
+```
+sell payload 는 `{"intent_type":"sell", "intent_id":..., "slot_id":..., "reason":..., "sell_strategy_id":...}`.
+
+#### `trex.events` payload (BAT-007)
+```
+{ "event_type": "slot_filled_buy"|"slot_filled_sell"|...,
+ "slot_id": str, "strategy_id": str?, "symbol": str?,
+ "status": "", "qty": float?, "avg_price": float?,
+ "portfolio_id": str?, "trading_date": "YYYY-MM-DD",
+ "sequence_at": "ISO-8601" }
+```
+- `sequence_at` = 슬롯 `updated_at` 의 단조 증가 토큰. 수신자는 last-wins 적용 가능 → 순서 보증 불요.
+- 이벤트의 `strategy_id`/`symbol` 은 routing key 에, 본문에도 함께 운반(이벤트 매핑 원칙 — REQ-021).
+
+### Reliability rules (REQ-023)
+
+- intent RPC: durable + persistent + manual ack-after-commit + `intent_log` correlation_id dedup. 단일 consumer + prefetch=1 → FIFO.
+- 스냅샷 RPC: read-only, manual ack, 별도 dedup 불요.
+- 이벤트: publisher confirms 활성, unroutable → DLQ. 페이로드는 현재 상태 + 단조 시퀀스(last-wins).
+- per-strategy 이벤트 queue: TTL/max-length 초과 시 `drop-head` + 스냅샷 RPC reconcile 로 보정.
+
+### Degrade (REQ-024)
+
+- 어댑터 `TransportHealth` ∈ {connected, disconnected, reconnecting}. 어플리케이션 레이어는 disconnected 상태에서 `TransportUnavailableError` 로 빠르게 실패한다(버퍼링 0, 보수적 중단).
+- 재연결은 백오프 1s→2s→4s→8s→16s→30s cap, 어댑터가 자체 구현.
+- core 자율 안전 매도는 transport 와 무관하게 동작해야 한다(architecture contract; 자동 트리거 구현은 별도 Discovery).
## Interface: `SlotService`
@@ -193,6 +246,36 @@
- `fee :: float` :: BrokerPort `calculate_fee` 결과(기본 0).
- `tax :: float` :: 기본 0(정밀 모델 후속).
+## Interface: `MessagingTransport` (Protocol, BAT-007)
+
+- Type: internal-service (transport boundary)
+- Consumers / Producers: 데몬 런타임(소비) ↔ 구현체(`RabbitMQTransport` 운영용 / `InMemoryTransport` 결정론 stub)
+- Purpose: 메시지 transport 추상화. 도메인은 transport/AMQP 의존 0(NFR-1).
+- Stability: experimental (BAT-007)
+
+### Inputs
+
+- declare_topology() :: 익스체인지/큐/바인딩 선언(멱등)
+- publish_event(routing_key, payload, mandatory=True) :: `trex.events` 발행. publisher confirms; unroutable → DLQ
+- call_rpc(queue, payload, *, correlation_id, timeout) :: 클라이언트 RPC (직접 reply-to 큐 대기)
+- consume_rpc_forever(queue, handler, stop) :: 서버측 RPC 소비 루프(stop 까지 블로킹, 백오프 재연결)
+- consume_events_forever(queue, binding_pattern, handler, stop) :: 이벤트 구독 루프
+
+### Outputs / Outcomes
+
+- `health() -> TransportHealth` :: `connected | disconnected | reconnecting`
+- DLQ 라우팅 :: 처리 실패/unroutable 메시지는 `trex.events.dlq` exchange/queue 로 격리
+
+### Error Contract
+
+- `TransportUnavailableError` :: connected 가 아닌 상태에서 `publish_event`/`call_rpc` 호출 시 즉시 실패(REQ-024 — 로컬 버퍼링 금지)
+- `RpcTimeoutError` :: 설정된 timeout 안에 reply 없음
+
+### Compatibility Rules
+
+- pika BlockingConnection 은 thread-safe 가 아니므로 consumer/publisher 마다 자기 connection/channel 을 가져야 한다.
+- 토폴로지 선언은 멱등하지만 attribute(durable, args) 가 기존 큐와 다르면 RabbitMQ 가 PRECONDITION_FAILED 로 거부 → batch 마이그레이션 시 큐 재선언 절차 필요.
+
## Shared Constraints
- 도메인은 외부 의존(브로커, DB 드라이버 등)을 직접 호출하지 않는다(순수 도메인 경계).
@@ -216,3 +299,4 @@
- 2026-06-03 :: BAT-002 — HTTP `/v1` API 계약(데몬, 6 엔드포인트) + 멱등/단일writer 불변식 추가(REQ-007/008/009).
- 2026-06-04 :: BAT-004 — 브로커 집행 레이어 반영(BrokerPort/paper·KIS 어댑터, execution 루프, broker_order_id 실행큐·멱등, reconciliation) (REQ-011~015).
- 2026-06-04 :: BAT-006 — LedgerPort/LedgerTrade/LedgerWriteResult 계약, LedgerOutbox/LedgerWriter, portfolio-hub `/v1/assets/{asset_id}/ledger/trades` 엔드포인트 + 409→`LedgerConflictError`, FillStatus.execution_id/fee/tax 확장 (REQ-017~020).
+- 2026-06-05 :: BAT-007 — HTTP `/v1` API 인터페이스 제거(adapters/api + fastapi/uvicorn 의존 정리), RabbitMQ messaging 계약 추가(스냅샷 RPC `trex.snapshot.req`, intent RPC `trex.intent.req`, 이벤트 topic `trex.events`, 전략별 durable queue + TTL/max-length, DLQ, publisher confirms, ack-after-commit), `MessagingTransport` Protocol + `TransportHealth` 노출 (REQ-021~026).
diff --git a/docs/project-structure.md b/docs/project-structure.md
index 2accf3e..a0d8aaf 100644
--- a/docs/project-structure.md
+++ b/docs/project-structure.md
@@ -4,7 +4,7 @@
- Baseline Seed: .stage-pilot/bootstrap/baseline.yaml
- Status: draft
- Owner: project maintainers
-- Last Updated (KST): 2026-06-04 (BAT-006)
+- Last Updated (KST): 2026-06-05 (BAT-007)
- Source Discovery / Batch: bootstrap-baseline (pre-Discovery, 3-phase lifecycle 밖의 bootstrap 산출물)
## Project Summary
@@ -21,11 +21,12 @@
- storage-agnostic 순수 도메인 (현재 in-memory repository, PostgreSQL/psycopg 는 향후 영속화 단계에서 도입 예정)
## Primary Runtime
-- Type: daemon (HTTP API) + library (slot 도메인)
+- Type: daemon (sync + thread, no HTTP) + library (slot 도메인)
- Entry Points:
- - `trex-core-daemon` (console_script → `trex_core.runtime.daemon:main`) :: 슬롯 코어 데몬 — migrate+preallocate lifecycle 후 FastAPI/uvicorn 으로 `/v1` API 서빙 (BAT-002)
- - HTTP `/v1` :: 매수·매도 전략 데몬용 intent 제출/조회 경계 (docs/interface-contract.md)
+ - `trex-core-daemon` (console_script → `trex_core.runtime.daemon:main`) :: 슬롯 코어 데몬 — migrate+preallocate+reconcile 후 4 백그라운드 스레드(intent RPC consumer / snapshot RPC consumer / execution / ledger) 기동, RabbitMQ messaging 으로 전략 모듈과 통신 (BAT-002 + BAT-007)
+ - RabbitMQ `trex.snapshot.req` / `trex.intent.req` / `trex.events` :: 매수·매도 전략 데몬과의 transport (docs/interface-contract.md)
- SlotService / SlotRepository (Protocol) :: in-process 도메인 서비스 + 저장소 경계(라이브러리 사용)
+ - MessagingTransport (Protocol) :: transport 추상화 (RabbitMQ / InMemory stub)
## Purpose
- This document is the current approved repository and package structure baseline.
@@ -62,29 +63,32 @@
│ ├── domain/slot/ # slot 순수 도메인 (BAT-001, 무의존)
│ │ ├── __init__.py · state.py · models.py(+EXPECTED_SLOT_FIELDS) · errors.py
│ │ ├── repository.py(Protocol) · service.py · in_memory_repository.py
-│ ├── application/ # 유스케이스 (BAT-002, BAT-004, BAT-006)
+│ ├── application/ # 유스케이스 (BAT-002, BAT-004, BAT-006, BAT-007)
│ │ ├── ports.py # IntentStore Protocol
│ │ ├── intents.py # IntentService / BuyIntent / SellIntent / IntentDecision
│ │ ├── broker_port.py # BrokerPort + OrderRequest/OrderAck/FillStatus + calculate_fee (BAT-004/BAT-006)
-│ │ ├── execution.py # ExecutionService (claim·dispatch·poll·transition·reconcile + ledger enqueue)
+│ │ ├── execution.py # ExecutionService (dispatch·poll·transition·reconcile + ledger enqueue + event emit hook)
│ │ ├── ledger_port.py # LedgerPort + LedgerTrade/LedgerWriteResult/예외 (BAT-006)
-│ │ └── ledger_outbox.py # LedgerOutbox Protocol + LedgerWriter + InMemoryLedgerOutbox (BAT-006)
-│ ├── adapters/ # 인프라 어댑터 (BAT-002, BAT-004, BAT-006)
-│ │ ├── api/ # FastAPI: app.py(create_app /v1) · schemas.py
+│ │ ├── ledger_outbox.py # LedgerOutbox Protocol + LedgerWriter + InMemoryLedgerOutbox (BAT-006)
+│ │ ├── messaging.py # MessagingTransport Protocol + DTO + TransportHealth (BAT-007)
+│ │ └── messaging_handlers.py # intent/snapshot RPC handlers + slot event payload builder (BAT-007)
+│ ├── adapters/ # 인프라 어댑터 (BAT-002, BAT-004, BAT-006, BAT-007)
│ │ ├── broker/ # paper.py(결정적 async 더블) · kis.py(KIS Open API) (BAT-004)
│ │ ├── ledger/ # in_memory.py(stub) · portfolio_hub.py(HTTP 어댑터) (BAT-006)
+│ │ ├── messaging/ # topology.py · in_memory.py(stub) · rabbitmq.py(pika 동기) (BAT-007)
│ │ └── persistence/ # postgresql.py(+PostgreSQLLedgerOutbox) · in_memory_intent_store.py · migrate.py · sql/(001_…, 002_create_ledger_outbox.sql)
-│ └── runtime/ # 데몬 (BAT-002, BAT-004, BAT-006)
-│ ├── config.py # DaemonConfig + KISConfig + PortfolioHubConfig(env)
-│ └── daemon.py # build_app + lifespan(migrate/preallocate/reconcile/execution 루프 + ledger writer 루프)
+│ └── runtime/ # 데몬 (BAT-002, BAT-004, BAT-006, BAT-007)
+│ ├── config.py # DaemonConfig + KISConfig + PortfolioHubConfig + RabbitMQConfig (env)
+│ └── daemon.py # Daemon class: setup(migrate/preallocate/reconcile/declare-topology) + 4 worker threads (execution·ledger·intent-rpc·snapshot-rpc) + graceful shutdown
└── tests/
├── domain/slot/ # test_state / test_service / test_contract
- ├── domain/ # test_domain_import_sweep (NFR-1 가드, BAT-006)
- ├── application/ # test_intent_concurrency · test_execution · test_execution_ledger · test_ledger_outbox
- └── adapters/{api,broker,ledger,persistence}/ # API · paper/KIS · in_memory/portfolio-hub ledger · PG repo/migration/outbox
+ ├── domain/ # test_domain_import_sweep (NFR-1 가드, BAT-006/BAT-007)
+ ├── application/ # test_intent_concurrency · test_execution · test_execution_ledger · test_ledger_outbox · test_messaging_intent_consumer · test_messaging_snapshot_consumer · test_messaging_event_publisher
+ ├── runtime/ # test_config_dotenv · test_daemon_no_http_surface (BAT-007 HTTP 표면 0 회귀 가드)
+ └── adapters/{broker,ledger,messaging,persistence}/ # paper/KIS · in_memory/portfolio-hub ledger · stub/RabbitMQ transport (게이트) · PG repo/migration/outbox
```
-> 참고: domain(BAT-001)은 무의존 코어. application/adapters/runtime 은 BAT-002 에서 추가, BAT-004 에서 broker/execution 레이어 확장, BAT-006 에서 ledger 레이어(application LedgerPort + adapters/ledger + runtime writer 루프 + persistence outbox)를 추가했다. 웹/DB/브로커/HTTP ledger 의존(fastapi/uvicorn/psycopg/httpx)은 adapters/runtime 에만 격리(NFR-1). 브로커 주문은 BrokerPort 단일 세션(불변식 B), 슬롯 쓰기는 SlotService 단일 writer(불변식 A), ledger 기록은 집행 경로 단일 주체(NFR-3).
+> 참고: domain(BAT-001)은 무의존 코어. application/adapters/runtime 은 BAT-002 에서 추가, BAT-004 에서 broker/execution 레이어 확장, BAT-006 에서 ledger 레이어 추가, BAT-007 에서 messaging 레이어(application MessagingTransport + adapters/messaging + sync+thread 데몬) 추가와 HTTP 어댑터 제거. 외부 의존(psycopg/httpx/redis/pika)은 adapters/runtime 에만 격리(NFR-1, import 스윕으로 강제). 브로커 주문은 BrokerPort 단일 세션(불변식 B), 슬롯 쓰기는 SlotService 단일 writer(불변식 A), ledger 기록은 집행 경로 단일 주체(NFR-3), 메시지 transport 는 MessagingTransport 단일 경계.
## Package / Module Responsibilities
@@ -130,3 +134,4 @@
- 2026-06-03 :: BAT-002 — application/adapters/runtime 레이어(데몬+HTTP API+PostgreSQL) 추가, Primary Runtime=daemon+library(REQ-005~009).
- 2026-06-04 :: BAT-004 — 브로커 집행 레이어 반영(BrokerPort/paper·KIS 어댑터, execution 루프, broker_order_id 실행큐·멱등, reconciliation) (REQ-011~015).
- 2026-06-04 :: BAT-006 — ledger 레이어 추가(application LedgerPort/LedgerOutbox, adapters/ledger in_memory·portfolio_hub, persistence PostgreSQLLedgerOutbox + 002 마이그레이션, runtime ledger writer 루프, FillStatus 확장, NFR-1 import 스윕) (REQ-017~020).
+- 2026-06-05 :: BAT-007 — transport 전환(`adapters/api/` 제거, `application/messaging.py` + `application/messaging_handlers.py` 신설, `adapters/messaging/` 신설(topology/in_memory/rabbitmq), runtime/daemon 을 sync+thread 4 스레드 구조로 재구성, `RabbitMQConfig` + `TREX_RABBITMQ_URL` env, `TREX_API_HOST`/`TREX_API_PORT` 폐기, `fastapi`/`uvicorn` 의존 제거 + `pika` 도입, NFR-1 import 스윕에 pika/messaging 추가, HTTP 표면 0 회귀 가드) (REQ-021~026).
diff --git a/docs/runtime-flows.md b/docs/runtime-flows.md
index ec7cf87..c1771f8 100644
--- a/docs/runtime-flows.md
+++ b/docs/runtime-flows.md
@@ -4,7 +4,7 @@
- Baseline Seed: .stage-pilot/bootstrap/baseline.yaml
- Status: draft
- Owner: project maintainers
-- Last Updated (KST): 2026-06-04 (BAT-006)
+- Last Updated (KST): 2026-06-05 (BAT-007)
- Source Discovery / Batch: bootstrap-baseline (pre-Discovery); 데몬/HTTP 흐름 = dcy-002 / BAT-002
- Primary Runtime: daemon (HTTP API) + library (slot 도메인)
@@ -21,29 +21,58 @@
## Covered Entry Points
-- `trex-core-daemon` :: 슬롯 코어 데몬 (lifecycle + HTTP `/v1` 서빙, BAT-002)
-- HTTP `/v1` :: intent 제출/조회 경계 (전략 데몬 클라이언트)
+- `trex-core-daemon` :: 슬롯 코어 데몬 (lifecycle + RabbitMQ 통신, BAT-002/BAT-007)
+- RabbitMQ `trex.snapshot.req` :: 전략 모듈의 스냅샷 RPC (request-reply, BAT-007)
+- RabbitMQ `trex.intent.req` :: 전략 모듈의 매수/매도 admission RPC (request-reply, BAT-007)
+- RabbitMQ `trex.events` :: 체결/슬롯 상태 이벤트 topic exchange (pub/sub, BAT-007)
- SlotService :: 슬롯 생명주기 도메인 서비스 (preallocate / transit / capacity / entry-count)
- SlotRepository (Protocol) :: 저장소 구현체 주입 경계
+- MessagingTransport (Protocol) :: 메시지 transport 추상화 (RabbitMQ / InMemory stub)
-## Flow: `데몬 lifecycle` (BAT-002)
+## Flow: `데몬 lifecycle` (BAT-002, BAT-007)
-1. `trex-core-daemon` 기동 → `DaemonConfig.from_env()`(TREX_POSTGRESQL_DSN 등).
-2. startup(lifespan): `apply_migrations(dsn)`(멱등) → 거래일 슬롯 `preallocate_daily_slots`(멱등, 공개 엔드포인트 아님).
-3. uvicorn 이 FastAPI `/v1` 앱 서빙(`GET /v1/healthz` 200).
-4. shutdown: 연결-당-호출 어댑터라 풀 정리 없음, graceful 종료.
+1. `trex-core-daemon` 기동 → `DaemonConfig.from_env()`(TREX_POSTGRESQL_DSN, `TREX_RABBITMQ_URL` 등).
+2. setup: `apply_migrations(dsn)`(멱등) → 거래일 슬롯 `preallocate_daily_slots`(멱등) → `execution.reconcile()`(REQ-014) → 이벤트 publisher 의 `declare_topology()`.
+3. start: 4개 백그라운드 스레드 동시 기동
+ - `trex-execution` :: 브로커 dispatch/poll 루프 (REQ-013/014)
+ - `trex-ledger` :: ledger outbox 드레인 (REQ-019)
+ - `trex-intent-rpc` :: `trex.intent.req` 소비자 (prefetch=1, FIFO, dedup via intent_log)
+ - `trex-snapshot-rpc` :: `trex.snapshot.req` 소비자
+4. shutdown: `SIGINT`/`SIGTERM` → `stop.set()` → 모든 스레드 join + 모든 transport `close()`. HTTP 표면 0, 별도 포트 바인딩 없음.
-## Flow: `매수 intent` (POST /v1/intents/buy, BAT-002)
+## Flow: `스냅샷 RPC` (RabbitMQ `trex.snapshot.req`, BAT-007)
-1. 전략 데몬이 intent(intent_id 포함)를 POST.
-2. IntentService: `intent_log.try_insert`(intent_id) dedup 게이트 — 중복이면 기존 decision 동기 반환(슬롯 무전이).
-3. 신규면 admission: `find_idle_slot` → `SlotService.transit_slot(idle→pending_buy)`(advisory lock 단일 writer). last-idle 경합 시 StateMismatch 재시도.
-4. `intent_log.finalize(admitted/rejected, slot_id)` → admit/reject 동기 응답.
+1. 전략 모듈이 RPC 요청을 `trex.snapshot.req` 큐로 publish — payload 에 `view`/`strategy_id`/`trading_date`, properties 에 `correlation_id` + `reply_to`(direct reply-to).
+2. `trex-snapshot-rpc` 스레드가 메시지 수신 → `make_snapshot_rpc_handler(slot_repo, slot_service)` 로 슬롯 목록 + 가용성 계산.
+3. 응답을 `reply_to` 큐로 publish (`correlation_id` 일치) → manual ack.
+4. read-only 이므로 dedup 불요; 재요청 시 동일 응답을 다시 생성한다.
-## Flow: `매도 intent` (POST /v1/intents/sell, BAT-002)
+## Flow: `매수/매도 intent admission RPC` (RabbitMQ `trex.intent.req`, BAT-007)
-1. 전략 데몬이 holding 슬롯을 `GET /v1/slots?status=holding` 로 조회 후 sell intent POST.
-2. dedup 게이트 → 검증(slot 이 holding 인가) → `transit_slot(holding→pending_sell)` → finalize → 동기 응답.
+1. 전략 모듈이 RPC 요청을 `trex.intent.req` 큐로 publish — payload `{intent_type, intent_id, ...}`, properties `correlation_id` = intent 멱등키, `reply_to`.
+2. `trex-intent-rpc` 스레드(단일, prefetch=1)가 메시지 수신 → `IntentService.submit_buy/sell` 호출.
+3. `intent_log.try_insert(intent_id, ...)` 가 dedup 게이트 — 중복 메시지는 기존 decision 재반환(슬롯 무전이).
+4. 신규면 admission: `find_idle_slot` → `SlotService.transit_slot(idle→pending_buy)` → Postgres durable commit.
+5. admission 응답(`status, slot_id?, reason?`)을 `reply_to` 큐로 publish → manual ack.
+6. ack-after-commit 시퀀스: durable commit 이 ack 보다 먼저이므로 ack 전 크래시 시 재전달돼도 (3) 의 dedup 으로 재실행되지 않는다.
+7. 체결/종료는 응답이 아니라 후속 이벤트(아래)로 전달 — admission 동기 + fill 비동기 2단계 시맨틱.
+
+## Flow: `슬롯 이벤트 발행/구독` (RabbitMQ `trex.events`, BAT-007)
+
+1. 체결: execution 루프가 `pending_buy→holding`(또는 `pending_sell→closed`)을 commit + ledger outbox enqueue (REQ-018/019).
+2. 같은 스레드에서 `event_publisher.publish_event(rk, payload)` 호출.
+ - routing key: `{event_type}.{strategy_id}.{symbol}` (예: `slot_filled_buy.A.005930`).
+ - payload: 현재 상태 + `sequence_at`(슬롯 `updated_at` iso) 운반 → 수신자는 last-wins 적용 가능 (순서 보증 불요).
+ - publisher confirms 활성, 발행 실패는 로그 + DLQ 라우팅(`trex.events.dlq`). publish 실패가 슬롯 전이를 롤백하지 않는다.
+3. 전략별 durable queue(`trex.events.strategy.{strategy_id}`)는 `*.{strategy_id}.#` 패턴으로 바인딩 → broker 단 필터로 자기 자산 이벤트만 수신.
+4. 전략 down 중 적체된 메시지는 catch-up 으로 복구; TTL(1h) / max-length(10k) 초과는 `drop-head` + 후속 스냅샷 RPC reconcile.
+
+## Flow: `broker degrade 분기` (BAT-007 / REQ-024)
+
+1. transport connection drop → 어댑터가 `_mark_disconnected()` + 백오프(1s→2s→4s→8s→16s→30s cap) 재연결.
+2. application 레이어는 `transport.health()` 가 `disconnected/reconnecting` 인 동안 신규 발행/RPC 가 `TransportUnavailableError` 로 빠르게 실패한다 → 전략은 매매 보류.
+3. core 자율 안전 매도(stop-loss / forced_close)는 transport 와 무관하게 execution 루프가 수행한다(설계 contract; 자동 트리거 실제 구현은 별도 Discovery — A-5 미구현).
+4. 로컬 버퍼링 없음 — broker 복구 후 옛 intent 가 자동 재생되지 않는다(전략이 신선 상태로 재판단).
## Flow: `주문 집행 루프` (백그라운드, BAT-004)
@@ -127,3 +156,4 @@
- 2026-06-03 :: BAT-002 — 데몬 lifecycle + 매수/매도 intent HTTP 흐름 추가, Primary Runtime=daemon+library(REQ-005~009). 브로커 집행/safety floor 흐름은 후속 Discovery.
- 2026-06-04 :: BAT-004 — 브로커 집행 레이어 반영(BrokerPort/paper·KIS 어댑터, execution 루프, broker_order_id 실행큐·멱등, reconciliation) (REQ-011~015).
- 2026-06-04 :: BAT-006 — ledger 통합 반영(체결→ledger outbox enqueue, LedgerWriter retry/dedup/409 흐름, FillStatus.execution_id/fee 운반, slot 전이와 ledger write 분리) (REQ-017~020).
+- 2026-06-05 :: BAT-007 — transport 전환(HTTP `/v1` API 제거, RabbitMQ 메시징 도입: 스냅샷/intent RPC + 이벤트 topic, sync+thread daemon, intent_log 멱등 ack-after-commit, publisher confirms + DLQ, per-strategy durable queue + TTL/max-length, broker degrade 분기) (REQ-021~026).
diff --git a/docs/srs/Documentation/req-026_messaging-baseline-alignment.md b/docs/srs/Documentation/req-026_messaging-baseline-alignment.md
new file mode 100644
index 0000000..92302e1
--- /dev/null
+++ b/docs/srs/Documentation/req-026_messaging-baseline-alignment.md
@@ -0,0 +1,148 @@
+# req-026: messaging 레이어 baseline 문서 정합
+
+- Status: Implemented
+- Type: Documentation
+- Priority: Medium
+- Owner: project maintainers
+
+## Intent
+- dcy-006 transport 전환(REQ-021~025) 이 도입하는 메시지 토폴로지/계약, RabbitMQ 어댑터 + sync+thread 런타임, delivery 신뢰성 + degrade 정책, HTTP 표면 0 결과를 baseline 문서에 반영해 코드와 문서의 정합을 유지한다.
+
+## Requirement
+- 아래 baseline 문서를 messaging 레이어에 맞게 갱신한다.
+ - `docs/interface-contract.md`
+ - HTTP `/v1` 섹션 제거(또는 deprecated 명시).
+ - 신규 섹션: messaging 메시지 계약(스냅샷/intent RPC, 이벤트 topic), 큐/익스체인지/routing key, `correlation_id`/reply-to 규약, ack/durable/DLQ/TTL 정책, 어댑터 신선도 상태 노출.
+ - `docs/runtime-flows.md`
+ - 기존 매수/매도 intent HTTP 흐름 제거.
+ - 신규 섹션: 스냅샷 RPC 흐름, intent admission RPC 흐름, 체결/슬롯 이벤트 발행/구독 흐름, broker degrade 분기 흐름, consumer/publisher 스레드 구성.
+ - `docs/project-structure.md`
+ - `trex_core/adapters/api/` 제거, `trex_core/adapters/messaging/` 추가.
+ - sync+thread 런타임 구성(intent RPC consumer / snapshot RPC consumer / execution / ledger 스레드) 반영.
+ - 의존성 변경(`fastapi`/`uvicorn` 제거, `pika` 추가) 반영.
+- 각 baseline 문서의 `Change Log` 에 본 변경(REQ-021~026 일괄 반영) 항목을 남긴다.
+- baseline 문서 본문이 코드와 충돌하지 않도록 manual review evidence 를 남긴다(REQ-020 패턴).
+
+## Acceptance Criteria
+1. Given REQ-021~025 구현 완료 상태, When 3 baseline 문서를 점검, Then `interface-contract.md`/`runtime-flows.md`/`project-structure.md` 모두에 messaging 레이어 섹션이 반영되어 있다.
+2. Given 갱신된 baseline 문서, When 실제 코드(`trex_core/adapters/messaging/`, `runtime/daemon.py`, 토폴로지 선언) 와 대조, Then 메시지 계약·토폴로지·런타임 스레드 구성·의존성 변경이 모순 없이 일치한다.
+3. Given 3 baseline 문서의 `Change Log`, When 점검, Then 본 transport 전환(REQ-021~026) 반영이 2026-06-05 일자로 기록되어 있다.
+4. Given baseline 문서, When 점검, Then HTTP `/v1` 섹션과 `adapters/api` 트리 항목이 잔존하지 않는다(또는 deprecated 라벨로 명시).
+
+## Impacted Area
+- Docs: docs/interface-contract.md, docs/runtime-flows.md, docs/project-structure.md
+- Modules: 없음(문서 전용)
+- Tests: 문서-코드 정합 점검(리뷰); 필요 시 interface-contract 예시와 실제 메시지 형식 대조.
+
+## Notes
+- 출처: dcy-006 FR-6.
+- baseline 갱신은 REQ-021~025 구현 내용에 의존하므로 동일 batch 후반 또는 구현 직후 수행한다(REQ-020 baseline 정합 선례와 동일 패턴).
+- `data-model.md` 는 본 transport 전환의 직접 대상이 아니다(이벤트 페이로드/큐 스키마는 interface-contract 가 담는 편이 자연스러움). 추후 이벤트 페이로드가 entity 수준으로 안정화되면 별도 REQ 에서 data-model 갱신 여부 판단.
+
+## Change Log
+
+### CHG-20260605-01
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-006 FR-6 로부터 최초 생성(Proposed).
+
+#### Intent
+- transport 전환에 따른 baseline 3문서(interface-contract/runtime-flows/project-structure) 정합을 backlog 로 정규화.
+
+#### Acceptance Criteria Delta
+- Added:
+ - 3 baseline 반영, 코드 정합, 변경 이력 기록, HTTP 잔존 0 (총 4개 기준)
+- Updated:
+ - 없음
+- Removed:
+ - 없음
+
+#### Impacted Area Delta
+- Docs:
+ - docs/interface-contract.md, docs/runtime-flows.md, docs/project-structure.md
+- Modules:
+ - 없음
+- Tests:
+ - 문서-코드 정합 점검
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 REQ-021~025 와 동일 batch 편성 권장.
+
+#### Validation Plan
+- REQ-021~025 구현 후 3 baseline 문서를 코드와 대조해 정합 확인.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- messaging 레이어 baseline 3문서(interface-contract/runtime-flows/project-structure) 정합 요구사항을 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Approved
+- Follow-up Action: REQ-021~025 와 동일 batch 후반 또는 후속 batch 편성 권장.
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- messaging 레이어 baseline 3문서(interface-contract/runtime-flows/project-structure) 정합을 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented
+- Follow-up Action: release 단계는 별도 진행.
+
+#### Validation Plan
+- AC-1: 3 baseline 문서 messaging 섹션 + Interface Summary/Covered Entry Points/트리 반영 완료.
+- AC-2: baseline ↔ 코드 정합 manual review (BAT-007 verification.md Manual 섹션).
+- AC-3: 3 baseline 문서 Change Log 모두 2026-06-05 BAT-007 항목 추가.
+- AC-4: docs/interface-contract.md 의 HTTP `/v1` 섹션 제거 + project-structure 트리에서 adapters/api 제거.
diff --git a/docs/srs/Exception/req-023_messaging-delivery-reliability.md b/docs/srs/Exception/req-023_messaging-delivery-reliability.md
new file mode 100644
index 0000000..9176ce0
--- /dev/null
+++ b/docs/srs/Exception/req-023_messaging-delivery-reliability.md
@@ -0,0 +1,154 @@
+# req-023: messaging delivery 신뢰성 (effectively-once + durable + DLQ + publisher confirms)
+
+- Status: Implemented
+- Type: Exception
+- Priority: High
+- Owner: project maintainers
+
+## Intent
+- RabbitMQ 메시징을 도입하면서 at-least-once 재전달이 intent 중복 실행이나 슬롯 권위 불변식 위반을 일으키지 않도록, idempotency + durable + 단일 consumer FIFO + dead-letter + publisher confirms 로 effectively-once 동작을 보장한다. 진짜 exactly-once 는 추구하지 않는다.
+
+## Requirement
+- intent admission RPC 는 다음 신뢰성 규약을 따른다.
+ - 메시지/큐는 durable + persistent delivery_mode.
+ - `correlation_id` = intent 멱등키(dcy-003 패턴, `{asset_id}:{order_id}:{execution_id}` 또는 등가) 로 dedup.
+ - 슬롯 전이를 Postgres 에 durable commit 한 뒤 ack(manual ack). 재전달 시 dedup 게이트가 단일 실행을 보장한다.
+ - 단일 consumer + prefetch=1 로 FIFO 순서 보존(trex-core 단일 writer 불변식 A 와 정합).
+- 스냅샷 RPC 는 read-only 멱등이므로 at-least-once + transient 큐/메시지 + manual ack 로 운영하고 별도 dedup 을 강제하지 않는다.
+- 이벤트 pub/sub 는 다음 신뢰성 규약을 따른다.
+ - `trex.events` 는 durable topic exchange.
+ - 전략별 queue 는 durable + per-strategy 로 down 중 catch-up 가능. 무한 적체 방지를 위해 TTL 또는 max-length 정책을 적용하고 초과분은 drop-oldest 후 스냅샷 RPC 로 reconcile.
+ - 이벤트 페이로드는 delta 가 아니라 **현재 상태 + 단조 증가 시퀀스(슬롯 version/timestamp)** 를 운반해 last-wins 가 성립하도록 한다(순서 보증 불요).
+ - 발행은 publisher confirms 로 broker 수락을 확인하고, 발행 실패/거부는 dead-letter 경로로 격리한다.
+- 미수신/중복 이벤트 보정은 권위 reconcile 경로인 스냅샷 RPC 가 담당한다(이벤트는 push 최적화이지 단일 진실원이 아님).
+
+## Acceptance Criteria
+1. Given 동일 `correlation_id` 의 intent 메시지가 2회 전달, When intent consumer 가 처리, Then 슬롯 전이는 1회만 일어나고 두 번째는 dedup 으로 무시된다(NFR-2).
+2. Given intent consumer 가 슬롯 transition 후 ack 직전 크래시 상황을 시뮬레이션, When 재기동 후 동일 메시지가 재전달, Then 멱등 dedup 으로 슬롯이 추가 전이되지 않고 결국 ack 된다(durable commit + ack 순서).
+3. Given intent 큐, When 토폴로지를 검사, Then 큐와 메시지가 durable/persistent 이고 consumer 가 단일 + prefetch=1 로 선언되어 있다.
+4. Given 전략 queue 가 down 인 상태에서 trex-core 가 이벤트를 발행, When 전략이 복구되어 queue 를 다시 소비, Then 적체된 이벤트를 catch-up 으로 수신한다(durable per-strategy queue).
+5. Given 이벤트 페이로드, When 형식을 검사, Then `current state + 단조 시퀀스` 필드가 포함되어 last-wins 적용이 가능하다.
+6. Given trex-core 가 이벤트를 발행, When broker 가 거부/확인 실패, Then publisher confirms 가 실패를 감지하고 메시지를 dead-letter 경로로 격리한다.
+7. Given TTL 또는 max-length 가 설정된 이벤트 queue, When 한도를 초과, Then 초과 메시지는 drop-oldest 로 제거되고 후속 스냅샷 RPC reconcile 로 누락이 보정된다.
+
+## Impacted Area
+- Docs: docs/runtime-flows.md(신뢰성/dedup/ack/DLQ 흐름), docs/interface-contract.md(메시지 속성/큐 옵션) — REQ-026 에서 정합.
+- Modules: REQ-022 의 어댑터/consumer 에 ack 시점·dedup 게이트·publisher confirms·DLQ 라우팅을 통합. dedup 게이트는 dcy-003 의 멱등 store 재사용.
+- Tests: 중복 intent 메시지 dedup, crash-after-commit-before-ack 재처리, durable queue + prefetch=1 토폴로지 검사, per-strategy queue catch-up, 이벤트 페이로드 모양, publisher confirms 실패 DLQ, TTL/max-length drop-oldest + reconcile.
+
+## Notes
+- 출처: dcy-006 FR-4, NFR-2, OQ-3, R-2.
+- NFR-2(effectively-once) 는 별도 REQ 로 승격하지 않고 본 REQ AC-1/AC-2 로 흡수한다.
+- 진짜 exactly-once 는 추구하지 않는다(분산 메시징 일반 원칙). 멱등 + 권위 reconcile 로 실제 효과를 낸다.
+- DLQ 라우팅 키/큐 이름 같은 세부 규약은 batch design 에서 확정한다(본 REQ 는 정책 수준).
+
+## Change Log
+
+### CHG-20260605-01
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-006 FR-4 로부터 최초 생성(Proposed). NFR-2(effectively-once) 흡수.
+
+#### Intent
+- messaging delivery 신뢰성(intent dedup, durable+FIFO, 이벤트 catch-up, publisher confirms, DLQ, TTL/max-length) backlog 정규화.
+
+#### Acceptance Criteria Delta
+- Added:
+ - 중복 intent dedup, crash-after-commit-before-ack 재처리, durable+prefetch=1 토폴로지, per-strategy queue catch-up, 이벤트 페이로드 모양, publisher confirms DLQ, TTL/max-length drop-oldest (총 7개 기준)
+- Updated:
+ - 없음
+- Removed:
+ - 없음
+
+#### Impacted Area Delta
+- Docs:
+ - docs/runtime-flows.md, docs/interface-contract.md
+- Modules:
+ - adapters/messaging consumer/publisher 의 ack/dedup/DLQ/confirms 통합
+- Tests:
+ - 신뢰성 7가지 시나리오
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 batch 편성
+
+#### Validation Plan
+- stub/RabbitMQ 어댑터로 dedup/durable/catch-up/confirms/DLQ/TTL 시나리오를 검증.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- messaging delivery 신뢰성(effectively-once + durable + DLQ + publisher confirms) 요구사항을 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Approved
+- Follow-up Action: REQ-021/022/025 와 함께 batch 편성
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- messaging delivery 신뢰성(effectively-once + durable + DLQ + publisher confirms + TTL/max-length)을 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented
+- Follow-up Action: release 단계는 별도 진행
+
+#### Validation Plan
+- AC-1: tests/application/test_messaging_intent_consumer.py::test_duplicate_correlation_id_dedups_via_intent_log + tests/adapters/messaging/test_rabbitmq_intent_e2e.py::test_intent_admission_rpc_dedups_duplicate_correlation_id_over_rabbitmq (실 RabbitMQ).
+- AC-2: ack-after-handler 코드(Daemon._intent_rpc_loop) + dedup 테스트가 ack 순서 전제 통과.
+- AC-3: tests/adapters/messaging/test_rabbitmq_intent_e2e.py::test_intent_queue_topology_uses_dlq_pointer.
+- AC-4: topology.STRATEGY_QUEUE_ARGS + per-strategy filter 테스트.
+- AC-5: tests/application/test_messaging_event_publisher.py::test_fill_emits_slot_filled_event_with_routing_key_and_state.
+- AC-6: RabbitMQTransport._publish_dlq + handler exception NACK + tests/adapters/messaging/test_in_memory_transport.py::test_publish_event_with_no_subscriber_routes_to_dlq.
+- AC-7: tests/adapters/messaging/test_topology.py::test_strategy_queue_args_have_ttl_and_max_length.
diff --git a/docs/srs/Integration/req-021_messaging-topology-and-contract-mapping.md b/docs/srs/Integration/req-021_messaging-topology-and-contract-mapping.md
index 7844138..98e7554 100644
--- a/docs/srs/Integration/req-021_messaging-topology-and-contract-mapping.md
+++ b/docs/srs/Integration/req-021_messaging-topology-and-contract-mapping.md
@@ -1,6 +1,6 @@
# req-021: messaging 토폴로지 + 메시지 계약 매핑
-- Status: Proposed
+- Status: Implemented
- Type: Integration
- Priority: High
- Owner: project maintainers
@@ -76,3 +76,69 @@
#### Validation Plan
- stub 어댑터 통합테스트로 RPC 매핑·이벤트 routing key 필터링·매핑 원칙을 검증.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- messaging 토폴로지 + 메시지 계약 매핑을 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Approved
+- Follow-up Action: REQ-022/023/025 와 함께 batch 편성(통신 단절 R-5 회피)
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- messaging 토폴로지 + 메시지 계약 매핑 구현과 검증 evidence 확보 후 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented
+- Follow-up Action: release 단계는 별도 진행
+
+#### Validation Plan
+- AC-1: tests/adapters/messaging/test_rabbitmq_transport.py::test_declare_topology_creates_core_entities.
+- AC-2: tests/application/test_messaging_snapshot_consumer.py + tests/adapters/messaging/test_rabbitmq_transport.py::test_rpc_roundtrip.
+- AC-3: tests/application/test_messaging_intent_consumer.py + test_messaging_event_publisher.py 조합.
+- AC-4: tests/application/test_messaging_event_publisher.py::test_event_for_strategy_a_does_not_reach_strategy_b_queue + tests/adapters/messaging/test_rabbitmq_transport.py::test_event_publish_and_per_strategy_consume.
+- AC-5: tests/adapters/messaging/test_topology.py.
diff --git a/docs/srs/Integration/req-022_messaging-transport-port-and-rabbitmq-adapter.md b/docs/srs/Integration/req-022_messaging-transport-port-and-rabbitmq-adapter.md
new file mode 100644
index 0000000..fbb0d36
--- /dev/null
+++ b/docs/srs/Integration/req-022_messaging-transport-port-and-rabbitmq-adapter.md
@@ -0,0 +1,154 @@
+# req-022: messaging transport 포트 + RabbitMQ 어댑터 + stub + sync+thread daemon
+
+- Status: Implemented
+- Type: Integration
+- Priority: High
+- Owner: project maintainers
+
+## Intent
+- 메시징 접근을 application 경계의 transport 포트로 추상화하고, `pika`(동기) RabbitMQ 어댑터와 결정론 stub 을 adapters 레이어에 격리해 도메인 순수성을 유지하면서 메시지 기반 통신을 가능하게 한다. uvicorn 제거 후 데몬을 sync+thread 런타임으로 재구성한다.
+
+## Requirement
+- application 레이어에 `MessagingTransport` (또는 동등한) Protocol 을 정의해 publish/subscribe/RPC consume 진입점을 추상화한다.
+- 신규 `trex_core/adapters/messaging/` 패키지에 두 구현체를 둔다.
+ - `RabbitMQTransport`: `pika`(동기) BlockingConnection 기반. consumer/publisher 스레드별 connection/channel 또는 `add_callback_threadsafe` 규약을 따른다(pika 는 thread-safe 가 아님).
+ - `InMemoryTransport` (stub): 결정론 테스트용 in-process publish/subscribe/RPC.
+- 데몬을 sync+thread 런타임으로 재구성한다(dcy-006 OQ-5): consumer 스레드(intent RPC, prefetch=1 단일 FIFO; snapshot RPC) + 기존 execution/ledger 루프 스레드 + 이벤트 publisher(execution 루프가 자기 channel 로 발행). graceful shutdown 은 기존 `stop` event 패턴을 확장해 connection close 까지 포함한다.
+- pika 자동 재연결이 없는 특성을 보정하기 위해 connection drop 시 백오프 기반 재연결 루프를 직접 구현하고 REQ-024 degrade 정책과 연동한다.
+- `trex_core/domain` 은 transport/AMQP 의존 0 을 유지한다(NFR-1, import 스윕).
+
+## Acceptance Criteria
+1. Given in-process `InMemoryTransport` stub, When 테스트가 publish/subscribe/RPC 진입점을 호출, Then 외부 broker 없이 메시지 송수신이 동작한다.
+2. Given `RabbitMQTransport`, When `TREX_RABBITMQ_URL` 로 broker 에 접속, Then connection/channel 이 열리고 declared 큐/익스체인지로 메시지 송수신이 가능하다(integration 수준, 인프라 미가용 시 skip 게이트 허용).
+3. Given 데몬 기동, When lifecycle 을 시작, Then intent RPC consumer 스레드, snapshot RPC consumer 스레드, execution/ledger 스레드가 동시에 동작하고, shutdown 시 `stop` event 후 모든 스레드와 connection 이 정상 종료된다(`uvicorn.run` 의존 0).
+4. Given broker connection 이 끊긴 상태, When 어댑터가 감지, Then 백오프 재연결을 직접 수행하고, REQ-024 degrade 정책(버퍼링 금지·보수적 중단)에 따라 신규 처리를 중단한다.
+5. Given 정적 import 스윕, When `trex_core/domain` 을 점검, Then `pika`/AMQP/`trex_core.adapters.messaging` 의존이 0 이다(NFR-1).
+
+## Impacted Area
+- Docs: docs/project-structure.md(adapters/messaging 위치 + 런타임 스레드 구성), docs/runtime-flows.md(consumer 스레드/이벤트 publisher 흐름) — REQ-026 에서 정합.
+- Modules:
+ - 신규 `trex_core/application/messaging.py`(`MessagingTransport` Protocol)
+ - 신규 `trex_core/adapters/messaging/` (`rabbitmq.py`, `in_memory.py`)
+ - 변경 `trex_core/runtime/daemon.py`(uvicorn 제거, consumer 스레드 추가, graceful shutdown 확장)
+ - 변경 `trex_core/runtime/config.py` (`TREX_RABBITMQ_URL` 로딩; REQ-025 와 함께 `TREX_API_HOST`/`TREX_API_PORT` 폐기)
+ - 영향 `trex_core/application/intents.py`, dcy-005 스냅샷 application 서비스 — transport-무관 포트로 호출되도록 재배선
+- Tests:
+ - in-process stub 통합테스트(publish/subscribe/RPC)
+ - RabbitMQ integration 테스트(`TREX_RABBITMQ_URL` 게이트, 미가용 시 skip)
+ - 데몬 lifecycle 테스트(스레드 기동/종료)
+ - `tests/domain/test_domain_import_sweep.py` 가 `pika`·`adapters.messaging` 추가 금지 prefix 로 가드
+
+## Notes
+- 출처: dcy-006 FR-3, NFR-1, OQ-5, OQ-6.
+- NFR-1(도메인 순수성) 은 REQ-017 AC-4 와 동일한 패턴으로 본 REQ AC-5 에 흡수한다(별도 REQ 미승격).
+- HTTP 어댑터 제거와 `TREX_API_HOST/PORT` 폐기는 REQ-025 본문에서 책임진다(본 REQ 는 신규 transport 도입 범위).
+- 실 RabbitMQ broker 인스턴스/자격증명 provision 은 delivery/운영 작업으로 위임됨(DATA, 비차단).
+
+## Change Log
+
+### CHG-20260605-01
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-006 FR-3 로부터 최초 생성(Proposed). NFR-1(도메인 순수성) 흡수.
+
+#### Intent
+- 메시징 transport 포트 + RabbitMQ 어댑터 + stub + sync+thread 데몬 재구성 backlog 정규화.
+
+#### Acceptance Criteria Delta
+- Added:
+ - stub publish/sub/RPC, RabbitMQ integration, 데몬 lifecycle, 재연결+degrade 연동, 도메인 import 스윕 (총 5개 기준)
+- Updated:
+ - 없음
+- Removed:
+ - 없음
+
+#### Impacted Area Delta
+- Docs:
+ - docs/project-structure.md, docs/runtime-flows.md
+- Modules:
+ - application/messaging.py, adapters/messaging/{rabbitmq,in_memory}, runtime/daemon.py, runtime/config.py
+- Tests:
+ - in-process stub, RabbitMQ integration(게이트), 데몬 lifecycle, import 스윕
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 batch 편성
+
+#### Validation Plan
+- stub 기반 통합테스트 + RabbitMQ integration 테스트(미가용 시 skip) + import 스윕으로 검증.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- messaging transport 포트 + RabbitMQ 어댑터 + stub + sync+thread daemon 재구성을 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Approved
+- Follow-up Action: REQ-021/023/025 와 함께 batch 편성
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- MessagingTransport 포트 + RabbitMQ 어댑터 + stub + sync+thread daemon 재구성을 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented
+- Follow-up Action: release 단계는 별도 진행
+
+#### Validation Plan
+- AC-1: tests/adapters/messaging/test_in_memory_transport.py 5종.
+- AC-2: tests/adapters/messaging/test_rabbitmq_transport.py 5종 (실 RabbitMQ 통합).
+- AC-3: tests/runtime/test_daemon_no_http_surface.py::test_daemon_module_has_no_fastapi_or_uvicorn_import + Daemon 4 스레드 코드.
+- AC-4: RabbitMQTransport 재연결 백오프 코드 + tests/adapters/messaging/test_in_memory_transport.py::test_unavailable_transport_raises_on_publish_and_rpc.
+- AC-5: tests/domain/test_domain_import_sweep.py.
diff --git a/docs/srs/Interface/req-025_http-api-complete-removal.md b/docs/srs/Interface/req-025_http-api-complete-removal.md
new file mode 100644
index 0000000..2d0e2ef
--- /dev/null
+++ b/docs/srs/Interface/req-025_http-api-complete-removal.md
@@ -0,0 +1,157 @@
+# req-025: HTTP `/v1` API 완전 제거 (healthz 포함, HTTP 표면 0)
+
+- Status: Implemented
+- Type: Interface
+- Priority: High
+- Owner: project maintainers
+
+## Intent
+- RabbitMQ 단일 transport 결정(dcy-006 OQ-1)에 따라 trex-core 의 HTTP `/v1` API 표면을 0 으로 만든다. 전략-facing 엔드포인트뿐 아니라 `GET /v1/healthz` 같은 앱 레벨 헬스 표면까지 제거하고(OQ-7), liveness 는 프로세스 감독(systemd/supervisor/docker restart)이 담당한다. 이중 transport 병행을 두지 않는다.
+
+## Requirement
+- 아래 HTTP 엔드포인트와 그 어댑터를 trex-core 코드와 baseline 에서 제거한다.
+ - `POST /v1/intents/buy`, `POST /v1/intents/sell`
+ - `GET /v1/intents/{intent_id}`
+ - `GET /v1/slots`, `GET /v1/capacity`
+ - `GET /v1/healthz`
+ - dcy-005 가 HTTP 로 가정한 스냅샷 read 엔드포인트(아직 미구현인 경우 가정 자체 갱신)
+- `trex_core/adapters/api/` HTTP 어댑터 패키지를 제거하고, FastAPI/uvicorn/Starlette 직접 의존을 코어 런타임에서 제거한다(테스트 전용 보조 import 도 마찬가지). `pyproject.toml` 의 `fastapi`/`uvicorn` 의존성을 정리한다.
+- `TREX_API_HOST` / `TREX_API_PORT` env 와 그 로딩 코드를 폐기한다(`DaemonConfig`/`.env.example` 정리).
+- 데몬 기동 후 HTTP 리스너가 어떤 포트에도 바인딩되어 있지 않아야 한다(HTTP 표면 0). 앱 레벨 헬스/관측성은 로그·메트릭으로 대체한다.
+- dcy-002 의 HTTP intent API 가정과 dcy-005 의 HTTP pull 가정(FR-1/A-3)을 cross-reference 로 갱신한다.
+
+## Acceptance Criteria
+1. Given 새 트리, When `find trex_core -path '*/adapters/api/*'` 또는 `grep -r "fastapi\|uvicorn" trex_core/`, Then 결과가 비어 있다(HTTP 어댑터 잔존 0).
+2. Given trex-core daemon, When 기동 후 포트 스캔, Then 어떤 TCP 포트에도 HTTP 리스너가 열려 있지 않다(HTTP 표면 0, dcy-006 S-6).
+3. Given `DaemonConfig.from_env()`, When 환경 변수 로딩, Then `TREX_API_HOST`/`TREX_API_PORT` 를 더 이상 참조하지 않고, 누락되어도 기동에 영향이 없다.
+4. Given `pyproject.toml`, When 의존성 목록을 점검, Then `fastapi`/`uvicorn`/`starlette` 가 코어 runtime 의존성에서 제거되어 있다.
+5. Given dcy-002·dcy-005 의 HTTP 가정 본문, When 본 변경 완료 시점에 cross-reference 갱신을 확인, Then 두 Discovery 의 HTTP 가정이 "transport 는 RabbitMQ(dcy-006)" 로 일관되게 안내된다.
+6. Given liveness 확인 시나리오, When 프로세스 감독(systemd/supervisor/docker restart)이 프로세스 죽음을 감지, Then 재시작이 broker 가용성과 무관하게 동작한다(broker 장애가 재시작 루프 유발 금지).
+
+## Impacted Area
+- Docs: docs/interface-contract.md(HTTP `/v1` 섹션 제거), docs/runtime-flows.md(HTTP 흐름 제거), docs/project-structure.md(adapters/api 제거), docs/discovery/dcy-002·dcy-005 cross-reference 갱신 — REQ-026 에서 정합.
+- Modules:
+ - 제거 `trex_core/adapters/api/` 전체(`app.py`, `schemas.py`)
+ - 변경 `trex_core/runtime/daemon.py`(uvicorn import/실행 제거; REQ-022 의 sync+thread 런타임으로 교체)
+ - 변경 `trex_core/runtime/config.py`(`TREX_API_HOST`/`TREX_API_PORT` 폐기)
+ - 변경 `pyproject.toml`(fastapi/uvicorn 제거; httpx 는 ledger 어댑터 사용처가 있으므로 유지)
+ - 변경 `.env.example`(API_HOST/PORT 제거, `TREX_RABBITMQ_URL` 추가는 REQ-022 책임)
+- Tests:
+ - 제거 `tests/adapters/api/` 전체(또는 messaging 등가 테스트로 이관)
+ - 추가 daemon HTTP-표면-0 회귀 가드(포트 스캔 또는 import 가드)
+
+## Notes
+- 출처: dcy-006 FR-5, OQ-1, OQ-7.
+- 본 REQ 의 검증은 transport 가 RabbitMQ 로 대체 가능한 상태(REQ-021/REQ-022/REQ-023 구현)에 의존한다. 동일 batch 또는 직후 batch 에서 함께 deliver 해야 통신 단절 위험(R-5)을 피할 수 있다.
+- httpx 는 본 REQ 가 제거 대상에서 제외한다(portfolio-hub ledger 어댑터가 사용).
+- 외부 운영 가시성(메트릭/로그) 표준화는 본 REQ 범위 밖이며 후속 운영 트랙으로 추적한다.
+
+## Change Log
+
+### CHG-20260605-01
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-006 FR-5/OQ-1/OQ-7 로부터 최초 생성(Proposed). HTTP `/v1` API + healthz + adapters/api + API_HOST/PORT env + fastapi/uvicorn 의존 전부 제거 backlog 정규화.
+
+#### Intent
+- 이중 transport 병행 없이 HTTP 표면 0 을 달성하고 dcy-002·dcy-005 의 HTTP 가정을 갱신.
+
+#### Acceptance Criteria Delta
+- Added:
+ - HTTP 어댑터 잔존 0, HTTP 리스너 0, env 폐기, 의존성 제거, cross-reference 갱신, 프로세스 감독 liveness (총 6개 기준)
+- Updated:
+ - 없음
+- Removed:
+ - 없음
+
+#### Impacted Area Delta
+- Docs:
+ - docs/interface-contract.md, docs/runtime-flows.md, docs/project-structure.md, dcy-002/dcy-005 cross-reference
+- Modules:
+ - adapters/api 제거, runtime/daemon.py, runtime/config.py, pyproject.toml, .env.example
+- Tests:
+ - adapters/api 테스트 제거 또는 이관, daemon HTTP-표면-0 회귀 가드
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: yes (BAT-002 HTTP API 관련 구현 일부가 RabbitMQ 로 대체)
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 REQ-021~023 과 동일 batch 편성(통신 단절 R-5 회피).
+
+#### Validation Plan
+- 코드 grep + 포트 스캔 + env 누락 기동 + pyproject 의존성 검사 + cross-reference 리뷰 + 프로세스 감독 시나리오로 검증.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- HTTP `/v1` API 완전 제거(healthz 포함, HTTP 표면 0)와 fastapi/uvicorn 의존 정리를 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: yes (BAT-002 HTTP API 관련 구현 일부 RabbitMQ 로 대체)
+- Status Recommendation: Approved
+- Follow-up Action: REQ-021/022/023 과 반드시 동일 batch 로 deliver(big-bang 마이그레이션 R-5 회피)
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- HTTP `/v1` API + healthz + adapters/api + fastapi/uvicorn 의존 + TREX_API_HOST/PORT 폐기를 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: yes (BAT-002 HTTP API 관련 구현/테스트 일부 RabbitMQ 로 대체됨; tests/adapters/api/ 제거)
+- Status Recommendation: Implemented
+- Follow-up Action: release 단계에서 전략 모듈 cut-over 순서 합의.
+
+#### Validation Plan
+- AC-1: tests/runtime/test_daemon_no_http_surface.py::test_adapters_api_tree_does_not_exist + test_no_fastapi_or_uvicorn_in_trex_core_source.
+- AC-2: tests/runtime/test_daemon_no_http_surface.py::test_daemon_module_has_no_fastapi_or_uvicorn_import.
+- AC-3: tests/runtime/test_daemon_no_http_surface.py::test_config_env_no_longer_references_api_host_or_port.
+- AC-4: tests/runtime/test_daemon_no_http_surface.py::test_pyproject_dependencies_have_no_fastapi_or_uvicorn.
+- AC-5: docs/discovery/dcy-002_…md 헤더 supersede 메모 + dcy-005 cross-reference 보유.
+- AC-6: Daemon.run 의 signal handler + 포트 바인딩 0 코드 review.
diff --git a/docs/srs/Non-Functional/req-024_rabbitmq-availability-degrade-policy.md b/docs/srs/Non-Functional/req-024_rabbitmq-availability-degrade-policy.md
new file mode 100644
index 0000000..62e4c07
--- /dev/null
+++ b/docs/srs/Non-Functional/req-024_rabbitmq-availability-degrade-policy.md
@@ -0,0 +1,143 @@
+# req-024: RabbitMQ 가용성 degrade 정책 (버퍼링 금지 + 보수적 중단 + core 안전 매도 독립)
+
+- Status: Implemented
+- Type: Non-Functional
+- Priority: High
+- Owner: project maintainers
+
+## Intent
+- HTTP fallback 없이 RabbitMQ 단일 transport 로 전환되므로(dcy-006 OQ-1, R-3 High), broker 장애가 trex-core 의 신규 매매를 통제 불능 상태로 만들지 않도록 명시적인 degrade 정책을 강제한다. 열린 포지션은 core 자율 안전 매도가 transport·전략과 독립으로 보호하는 전제를 별도 backlog 로 가시화한다.
+
+## Requirement
+- RabbitMQ broker 가 불가용일 때 trex-core 는 아래 정책을 따른다(dcy-006 OQ-4).
+ 1. **버퍼링 금지**: 새 intent 메시지를 로컬 디스크/큐에 적재해 복구 후 자동 재생하지 않는다. 지나간 결정의 지연 실행 위험을 차단한다.
+ 2. **신규 매매 보수적 중단**: 스냅샷 RPC 타임아웃·intent 발행 실패 시 전략 측은 매매를 보류하고, trex-core 는 신규 슬롯 전이를 유입시키지 않는다(복구 후 신선 데이터로 재판단).
+- `MessagingTransport` 어댑터는 connection drop / 재연결 백오프 / 신선도(staleness) 상태를 명확히 노출해 application 레이어가 위 정책을 일관되게 적용할 수 있게 한다.
+- core 자율 안전 매도(손절 stop-loss, 시간 만기 forced_close) 는 RabbitMQ 가용성 및 전략 모듈 동작 여부와 **독립**으로 수행되어야 한다는 architecture 전제를 본 REQ 의 명시적 contract 로 둔다(현재 미구현, dcy-006 A-5 — 본 REQ 는 정책 contract 만 정의하고 구현은 별도 Discovery 로 위임).
+
+## Acceptance Criteria
+1. Given RabbitMQ broker 가 불가용, When 전략이 intent 를 발행하려 시도, Then trex-core 는 새 슬롯 전이를 일으키지 않는다(보수적 중단).
+2. Given RabbitMQ broker 가 일시 불가용 후 복구, When 복구 시점에 broker 또는 클라이언트에 누적된 intent 가 있는지 확인, Then trex-core 측에 로컬 버퍼링된 intent 가 없고 자동 재생도 일어나지 않는다(버퍼링 금지).
+3. Given RabbitMQ connection drop, When 어댑터 상태를 조회, Then `connected/disconnected/reconnecting` 신선도 상태가 application 레이어에 노출되어 degrade 분기에 사용된다.
+4. Given dcy-006 A-5(core 자율 안전 매도)가 본 변경 범위 외에 별도 트랙으로 존재함, When 본 REQ 를 검증, Then 본 REQ 는 정책 contract(독립 동작 전제)만 강제하고 구현 자체는 후속 Discovery/REQ 로 추적되도록 Notes 에 명시되어 있다.
+5. Given 복구 후 첫 사이클, When 전략이 신규 매매를 결정, Then 결정은 복구 후 신선 스냅샷에 근거하고, 복구 전 결정의 자동 실행은 없다.
+
+## Impacted Area
+- Docs: docs/runtime-flows.md(degrade 분기 흐름), docs/interface-contract.md(어댑터 신선도 상태 노출) — REQ-026 에서 정합.
+- Modules: REQ-022 어댑터의 connection 상태/재연결 루프 노출, application 레이어의 broker-down 분기.
+- Tests: broker 중단 주입 후 신규 intent 전이 없음, 복구 후 자동 재생 없음, connection 상태 전이 노출 테스트.
+
+## Notes
+- 출처: dcy-006 NFR-3, OQ-4, R-3, A-5.
+- core 자율 안전 매도(stop-loss, forced_close) 는 현재 미구현(`forced_close_at` 필드만 존재, 자동 트리거 로직 없음, stop-loss 부재). 본 REQ 는 그 capability 가 RabbitMQ·전략과 **독립**이어야 한다는 architecture contract 만 backlog 로 둔다 — 실제 구현은 본 transport 범위 밖이며 별도 Discovery 로 추적해야 한다.
+- dcy-005 OQ-5(스냅샷 read 가용성) 와 공통 "보수적 안전" 철학을 따른다.
+- 본 REQ 의 검증은 stub broker 가용성 토글로 충분히 수행 가능하며, 실 RabbitMQ 인프라 의존성을 강제하지 않는다.
+
+## Change Log
+
+### CHG-20260605-01
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-006 NFR-3 로부터 최초 생성(Proposed). HTTP fallback 부재로 High 영향 가용성 결합(R-3) 처리 방침을 backlog 로 정규화.
+
+#### Intent
+- broker 장애 시 trex-core 의 보수적 중단·버퍼링 금지 정책과 core 자율 안전 매도 독립 전제를 별도 NFR REQ 로 분리해 운영 가시성 확보.
+
+#### Acceptance Criteria Delta
+- Added:
+ - 보수적 중단, 버퍼링 금지, connection 신선도 노출, A-5 정책 contract 분리, 복구 후 신선 결정 (총 5개 기준)
+- Updated:
+ - 없음
+- Removed:
+ - 없음
+
+#### Impacted Area Delta
+- Docs:
+ - docs/runtime-flows.md, docs/interface-contract.md
+- Modules:
+ - adapters/messaging connection 상태 노출, application degrade 분기
+- Tests:
+ - broker 중단/복구 시나리오 3종
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 batch 편성. core 자율 안전 매도 구현은 별도 Discovery 로 분리 트래킹.
+
+#### Validation Plan
+- stub broker 가용성 토글로 보수적 중단·버퍼링 금지·신선도 상태를 검증. A-5 항목은 정책 contract review.
+
+### CHG-20260605-02
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Proposed -> Approved. confirm-req 승인 게이트 통과.
+
+#### Intent
+- RabbitMQ 가용성 degrade 정책(버퍼링 금지 + 보수적 중단 + core 자율 안전 매도 독립 contract)을 delivery input 으로 승인.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - none
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Approved
+- Follow-up Action: REQ-022 어댑터의 connection 상태 노출과 동일 batch 편성 권장. core 자율 안전 매도 구현은 별도 Discovery 로 분리 트래킹.
+
+#### Validation Plan
+- 기존 Acceptance Criteria 로 batch delivery 에서 검증.
+
+### CHG-20260605-03
+- Date: 2026-06-05
+- Author: Justin Ko
+
+#### Change Summary
+- Status 변경: Approved -> Implemented. BAT-007 release-candidate verification evidence 기반.
+
+#### Intent
+- RabbitMQ 가용성 degrade 정책(버퍼링 금지 + 보수적 중단 + core 자율 안전 매도 독립 contract)을 구현 완료 상태로 동기화.
+
+#### Acceptance Criteria Delta
+- Added/Updated/Removed: 없음
+
+#### Impacted Area Delta
+- Docs/Modules/Tests: 없음
+
+#### Delivery Trace Delta
+- Batches:
+ - BAT-007 (release-candidate)
+- Releases:
+ - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented
+- Follow-up Action: core 자율 안전 매도 구현은 별도 Discovery 로 분리 트래킹.
+
+#### Validation Plan
+- AC-1: tests/adapters/messaging/test_in_memory_transport.py::test_unavailable_transport_raises_on_publish_and_rpc + tests/application/test_messaging_event_publisher.py::test_publish_failure_does_not_break_execution_loop.
+- AC-2: MessagingTransport Protocol 에 enqueue 가 없음 + 어댑터 코드 review (publish 실패 → 즉시 raise/DLQ, 로컬 보관 0).
+- AC-3: TransportHealth enum + 어댑터 상태 머신 코드 + AC-1 테스트가 disconnected 노출 검증.
+- AC-4: REQ-024 본문 Notes + BAT-007 implementation/verification Remaining Risks 에 명시.
+- AC-5: 발행 실패가 슬롯 전이를 롤백하지 않음 (test_publish_failure_does_not_break_execution_loop).
diff --git a/docs/srs/index.md b/docs/srs/index.md
index 38700f7..c5142ec 100644
--- a/docs/srs/index.md
+++ b/docs/srs/index.md
@@ -74,7 +74,7 @@
## Next Requirement ID
-- Current: `REQ-021`
+- Current: `REQ-027`
- Rule: `Requirement Register`에 있는 가장 큰 REQ 번호보다 정확히 1 커야 한다.
## Requirement Register
@@ -101,11 +101,17 @@
| REQ-018 | 체결→원장 기록 (집행 루프 fill hook) | Integration | Implemented | High | project maintainers | [req-018](./Integration/req-018_fill-to-ledger-recording.md) |
| REQ-019 | ledger outbox durability + correlation_id 멱등 | Exception | Implemented | High | project maintainers | [req-019](./Exception/req-019_ledger-outbox-durability-idempotency.md) |
| REQ-020 | ledger 레이어 baseline 문서 정합 | Documentation | Implemented | Medium | project maintainers | [req-020](./Documentation/req-020_ledger-baseline-alignment.md) |
+| REQ-021 | messaging 토폴로지 + 메시지 계약 매핑 | Integration | Implemented | High | project maintainers | [req-021](./Integration/req-021_messaging-topology-and-contract-mapping.md) |
+| REQ-022 | messaging transport 포트 + RabbitMQ 어댑터 + stub + sync+thread daemon | Integration | Implemented | High | project maintainers | [req-022](./Integration/req-022_messaging-transport-port-and-rabbitmq-adapter.md) |
+| REQ-023 | messaging delivery 신뢰성 (effectively-once + durable + DLQ + publisher confirms) | Exception | Implemented | High | project maintainers | [req-023](./Exception/req-023_messaging-delivery-reliability.md) |
+| REQ-024 | RabbitMQ 가용성 degrade 정책 (버퍼링 금지 + 보수적 중단 + core 안전 매도 독립) | Non-Functional | Implemented | High | project maintainers | [req-024](./Non-Functional/req-024_rabbitmq-availability-degrade-policy.md) |
+| REQ-025 | HTTP `/v1` API 완전 제거 (healthz 포함, HTTP 표면 0) | Interface | Implemented | High | project maintainers | [req-025](./Interface/req-025_http-api-complete-removal.md) |
+| REQ-026 | messaging 레이어 baseline 문서 정합 | Documentation | Implemented | Medium | project maintainers | [req-026](./Documentation/req-026_messaging-baseline-alignment.md) |
## Recent Change Log Summary
+- 2026-06-05 :: REQ-021~026 Approved → Implemented — BAT-007 release-candidate verification evidence 기반. (confirm-req-implemented)
+- 2026-06-05 :: REQ-021~026 Proposed -> Approved — 승인 게이트 통과. (confirm-req)
+- 2026-06-05 :: REQ-021~026 최초 생성(Proposed) — dcy-006 FR-1~FR-6 분해(NFR-1 → REQ-022 흡수, NFR-2 → REQ-023 흡수, NFR-3 → REQ-024 승격). (draft-req)
- 2026-06-04 :: REQ-017~020 Approved → Implemented — BAT-006 release-candidate verification evidence 기반. (confirm-req-implemented)
- 2026-06-04 :: REQ-017~020 Proposed -> Approved — 승인 게이트 통과. (confirm-req)
-- 2026-06-04 :: REQ-017~020 최초 생성(Proposed) — dcy-004 FR-1~FR-5 분해(NFR-1~3 흡수). (draft-req)
-- 2026-06-04 :: REQ-016 생성 + Approved — KIS 토큰 Redis 캐시 (minor-change). (draft-req/confirm-req)
-- 2026-06-04 :: REQ-011~015 Approved → Implemented — BAT-004 verification evidence 기반. (confirm-req-implemented)
diff --git a/pyproject.toml b/pyproject.toml
index e162b97..b8ccc5a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,18 +4,17 @@ version = "0.1.0"
description = "Shared core for the trex product family; first domain: slot lifecycle (storage-agnostic pure domain)"
requires-python = ">=3.12"
dependencies = [
- "fastapi>=0.110",
- "uvicorn>=0.29",
"psycopg[binary]>=3.1",
"python-dotenv>=1.0",
"redis>=5",
+ "httpx>=0.27",
+ "pika>=1.3",
]
[project.optional-dependencies]
dev = [
"pytest>=8",
"ruff>=0.4",
- "httpx>=0.27",
]
[project.scripts]
diff --git a/tests/adapters/api/test_intent_api.py b/tests/adapters/api/test_intent_api.py
deleted file mode 100644
index d7874a5..0000000
--- a/tests/adapters/api/test_intent_api.py
+++ /dev/null
@@ -1,112 +0,0 @@
-"""HTTP /v1 API tests via in-memory adapters (REQ-005/007/008).
-
-No PostgreSQL needed: the app is wired with the in-memory slot repo + intent
-store, exercising the full request → admission → transition → response path.
-"""
-from __future__ import annotations
-
-from datetime import date
-
-import pytest
-from fastapi.testclient import TestClient
-
-from trex_core.adapters.api.app import create_app
-from trex_core.adapters.persistence.in_memory_intent_store import InMemoryIntentStore
-from trex_core.application.intents import IntentService
-from trex_core.domain.slot import SlotService, SlotState
-from trex_core.domain.slot.in_memory_repository import InMemorySlotRepository
-
-DAY = date(2026, 6, 3)
-
-
-@pytest.fixture
-def ctx():
- repo = InMemorySlotRepository()
- svc = SlotService(repo)
- intents = IntentService(svc, repo, InMemoryIntentStore())
- svc.preallocate_daily_slots(DAY, 3)
- app = create_app(
- slot_service=svc, slot_repo=repo, intent_service=intents, default_total_slots=3
- )
- return repo, svc, intents, TestClient(app)
-
-
-def _buy(client, intent_id, symbol="005930"):
- return client.post(
- "/v1/intents/buy",
- json={"intent_id": intent_id, "trading_date": DAY.isoformat(), "symbol": symbol, "qty": 10},
- )
-
-
-def test_healthz(ctx):
- _, _, _, client = ctx
- r = client.get("/v1/healthz")
- assert r.status_code == 200 and r.json()["status"] == "ok"
-
-
-def test_buy_intent_admits_and_transitions(ctx):
- repo, _, _, client = ctx
- r = _buy(client, "buy-1")
- assert r.status_code == 200
- body = r.json()
- assert body["status"] == "admitted" and body["slot_id"]
- slot = repo.fetch_slot(__import__("uuid").UUID(body["slot_id"]))
- assert slot.status is SlotState.PENDING_BUY and slot.symbol == "005930"
-
-
-def test_buy_intent_idempotent_resubmit(ctx):
- repo, _, _, client = ctx
- r1 = _buy(client, "buy-dup")
- r2 = _buy(client, "buy-dup") # same intent_id
- assert r1.json() == r2.json() # identical decision
- # only ONE slot moved out of idle
- pending = [s for s in repo.list_slots(DAY) if s.status is SlotState.PENDING_BUY]
- assert len(pending) == 1
-
-
-def test_buy_intent_rejected_when_no_idle(ctx):
- _, _, _, client = ctx
- for i in range(3):
- assert _buy(client, f"buy-fill-{i}").json()["status"] == "admitted"
- r = _buy(client, "buy-overflow")
- assert r.json()["status"] == "rejected" and r.json()["reason"] == "no_idle_slot"
-
-
-def test_sell_intent_requires_holding(ctx):
- repo, _, _, client = ctx
- # a freshly bought slot is pending_buy, not holding -> sell rejected
- slot_id = _buy(client, "buy-for-sell").json()["slot_id"]
- r = client.post("/v1/intents/sell", json={"intent_id": "sell-1", "slot_id": slot_id})
- assert r.json()["status"] == "rejected" and r.json()["reason"].startswith("slot_not_holding")
-
-
-def test_sell_intent_admits_from_holding(ctx):
- repo, svc, _, client = ctx
- import uuid
-
- slot_id = uuid.UUID(_buy(client, "buy-h").json()["slot_id"])
- svc.transit_slot(slot_id, SlotState.PENDING_BUY, SlotState.HOLDING, reason="filled", actor="t")
- r = client.post("/v1/intents/sell", json={"intent_id": "sell-h", "slot_id": str(slot_id)})
- assert r.json()["status"] == "admitted"
- assert repo.fetch_slot(slot_id).status is SlotState.PENDING_SELL
-
-
-def test_get_intent_roundtrip(ctx):
- _, _, _, client = ctx
- _buy(client, "buy-q")
- r = client.get("/v1/intents/buy-q")
- assert r.status_code == 200 and r.json()["status"] == "admitted"
- assert client.get("/v1/intents/does-not-exist").status_code == 404
-
-
-def test_list_slots_and_capacity(ctx):
- _, _, _, client = ctx
- _buy(client, "buy-c")
- slots = client.get(
- "/v1/slots", params={"status": "pending_buy", "trading_date": DAY.isoformat()}
- ).json()
- assert len(slots) == 1 and slots[0]["status"] == "pending_buy"
- cap = client.get(
- "/v1/capacity", params={"total_slots": 3, "trading_date": DAY.isoformat()}
- ).json()
- assert cap["idle_count"] == 2 and cap["pending_count"] == 1 and cap["total_slots"] == 3
diff --git a/tests/adapters/api/__init__.py b/tests/adapters/messaging/__init__.py
similarity index 100%
rename from tests/adapters/api/__init__.py
rename to tests/adapters/messaging/__init__.py
diff --git a/tests/adapters/messaging/test_in_memory_transport.py b/tests/adapters/messaging/test_in_memory_transport.py
new file mode 100644
index 0000000..cee6de1
--- /dev/null
+++ b/tests/adapters/messaging/test_in_memory_transport.py
@@ -0,0 +1,88 @@
+"""InMemoryTransport stub tests (REQ-022 AC-1 + REQ-024 degrade)."""
+from __future__ import annotations
+
+import threading
+import time
+
+import pytest
+
+from trex_core.adapters.messaging.in_memory import InMemoryTransport
+from trex_core.adapters.messaging import topology
+from trex_core.application.messaging import (
+ RpcRequest,
+ RpcResponse,
+ RpcTimeoutError,
+ TransportHealth,
+ TransportUnavailableError,
+)
+
+
+def test_publish_and_subscribe_routes_by_pattern():
+ t = InMemoryTransport()
+ received: list[tuple[str, dict]] = []
+ stop = threading.Event()
+ th = threading.Thread(
+ target=t.consume_events_forever,
+ args=("trex.events.strategy.A", topology.strategy_event_binding_pattern("A"),
+ lambda rk, p: received.append((rk, p)), stop),
+ daemon=True,
+ )
+ th.start()
+ time.sleep(0.05)
+ # Routed to A's subscriber
+ t.publish_event(topology.event_routing_key("slot_filled_buy", "A", "005930"),
+ {"slot": "1"})
+ # NOT routed to A's subscriber (strategy B)
+ t.publish_event(topology.event_routing_key("slot_filled_buy", "B", "005930"),
+ {"slot": "2"})
+ time.sleep(0.05)
+ stop.set()
+ th.join(timeout=1.0)
+ assert len(received) == 1
+ assert received[0][0] == "slot_filled_buy.A.005930"
+ assert received[0][1] == {"slot": "1"}
+
+
+def test_rpc_call_dispatches_to_registered_handler():
+ t = InMemoryTransport()
+
+ def handler(req: RpcRequest) -> RpcResponse:
+ return RpcResponse(payload={"echo": req.payload, "cid": req.correlation_id})
+
+ stop = threading.Event()
+ th = threading.Thread(
+ target=t.consume_rpc_forever,
+ args=("trex.intent.req", handler, stop),
+ daemon=True,
+ )
+ th.start()
+ time.sleep(0.05)
+ resp = t.call_rpc("trex.intent.req", {"x": 1}, correlation_id="cid-1", timeout=0.5)
+ assert resp["echo"] == {"x": 1}
+ assert resp["cid"] == "cid-1"
+ stop.set()
+ th.join(timeout=1.0)
+
+
+def test_unavailable_transport_raises_on_publish_and_rpc():
+ t = InMemoryTransport()
+ t.set_available(False)
+ assert t.health() is TransportHealth.DISCONNECTED
+ with pytest.raises(TransportUnavailableError):
+ t.publish_event("e.A.S", {"x": 1})
+ with pytest.raises(TransportUnavailableError):
+ t.call_rpc("trex.intent.req", {"x": 1}, correlation_id="cid", timeout=0.1)
+
+
+def test_rpc_without_registered_consumer_times_out():
+ t = InMemoryTransport()
+ with pytest.raises(RpcTimeoutError):
+ t.call_rpc("trex.intent.req", {}, correlation_id="cid", timeout=0.05)
+
+
+def test_publish_event_with_no_subscriber_routes_to_dlq():
+ t = InMemoryTransport()
+ t.publish_event("slot_filled_buy.A.005930", {"slot": "1"})
+ dlq = t.dlq_messages()
+ assert len(dlq) == 1
+ assert dlq[0][0] == "slot_filled_buy.A.005930"
diff --git a/tests/adapters/messaging/test_rabbitmq_intent_e2e.py b/tests/adapters/messaging/test_rabbitmq_intent_e2e.py
new file mode 100644
index 0000000..a182f54
--- /dev/null
+++ b/tests/adapters/messaging/test_rabbitmq_intent_e2e.py
@@ -0,0 +1,127 @@
+"""End-to-end intent RPC against RabbitMQ + intent_log dedup (REQ-023 AC-1/AC-3).
+
+Skipped without TREX_RABBITMQ_TEST_URL. Wires the real RabbitMQTransport to
+the application-layer intent handler and proves that:
+ - publishing the same correlation_id twice triggers slot transition only ONCE
+ - the durable RPC queue is declared with the DLQ pointer (AC-3 topology check)
+ - intent_log persists the dedup decision
+"""
+from __future__ import annotations
+
+import os
+import threading
+import time
+import uuid
+from datetime import date
+
+import pytest
+
+from trex_core.adapters.messaging import topology
+from trex_core.adapters.messaging.rabbitmq import RabbitMQTransport
+from trex_core.adapters.persistence.in_memory_intent_store import InMemoryIntentStore
+from trex_core.application.intents import IntentService
+from trex_core.application.messaging_handlers import make_intent_rpc_handler
+from trex_core.domain.slot import SlotService, SlotState
+from trex_core.domain.slot.in_memory_repository import InMemorySlotRepository
+
+DAY = date(2026, 6, 5)
+
+
+@pytest.fixture
+def mq_url() -> str:
+ url = os.environ.get("TREX_RABBITMQ_TEST_URL")
+ if not url:
+ pytest.skip("TREX_RABBITMQ_TEST_URL not set")
+ return url
+
+
+def _drain(url: str, queue: str) -> None:
+ import pika
+ conn = pika.BlockingConnection(pika.URLParameters(url))
+ try:
+ ch = conn.channel()
+ try:
+ ch.queue_delete(queue=queue)
+ except Exception: # noqa: BLE001
+ pass
+ finally:
+ conn.close()
+
+
+def test_intent_admission_rpc_dedups_duplicate_correlation_id_over_rabbitmq(mq_url):
+ """REQ-023 AC-1: same correlation_id processed twice ⇒ slot transitions ONCE."""
+ repo = InMemorySlotRepository()
+ svc = SlotService(repo)
+ intents = IntentService(svc, repo, InMemoryIntentStore())
+ svc.preallocate_daily_slots(DAY, 3)
+ handler = make_intent_rpc_handler(intents)
+
+ queue = f"trex.test.intent.{uuid.uuid4().hex[:8]}"
+ server = RabbitMQTransport(mq_url, timeout=5.0)
+ client = RabbitMQTransport(mq_url, timeout=5.0)
+ try:
+ # Pre-declare with DLQ pointer (mirrors production declare_topology shape)
+ server._ensure_connected()
+ server._channel.queue_declare(
+ queue, durable=True,
+ arguments={"x-dead-letter-exchange": topology.EVENTS_DLQ_EXCHANGE},
+ )
+
+ stop = threading.Event()
+ th = threading.Thread(
+ target=server.consume_rpc_forever, args=(queue, handler, stop), daemon=True,
+ )
+ th.start()
+ time.sleep(0.2)
+
+ cid = "buy-dup-rmq"
+ payload = {
+ "intent_type": "buy", "intent_id": cid,
+ "trading_date": DAY.isoformat(), "symbol": "005930", "qty": 10,
+ }
+ r1 = client.call_rpc(queue, payload, correlation_id=cid, timeout=3.0)
+ r2 = client.call_rpc(queue, payload, correlation_id=cid, timeout=3.0)
+ assert r1 == r2
+ assert r1["status"] == "admitted"
+
+ pending = [s for s in repo.list_slots(DAY) if s.status is SlotState.PENDING_BUY]
+ assert len(pending) == 1, "intent_log dedup must prevent double slot transition"
+
+ stop.set()
+ th.join(timeout=2.0)
+ finally:
+ server.close()
+ client.close()
+ _drain(mq_url, queue)
+
+
+def test_intent_queue_topology_uses_dlq_pointer(mq_url):
+ """REQ-023 AC-3 / REQ-022 AC-2 topology assertion."""
+ import pika
+ t = RabbitMQTransport(mq_url, timeout=5.0)
+ try:
+ t.declare_topology()
+ # Re-declare with the SAME args is no-op; declaring with DIFFERENT args
+ # would raise PRECONDITION_FAILED. Use that as a topology assertion.
+ conn = pika.BlockingConnection(pika.URLParameters(mq_url))
+ try:
+ ch = conn.channel()
+ # Same args → ok
+ ch.queue_declare(
+ topology.INTENT_REQ_QUEUE, durable=True,
+ arguments={"x-dead-letter-exchange": topology.EVENTS_DLQ_EXCHANGE},
+ )
+ ch.close()
+ # Different args → must raise
+ ch2 = conn.channel()
+ with pytest.raises(pika.exceptions.ChannelClosedByBroker):
+ ch2.queue_declare(
+ topology.INTENT_REQ_QUEUE, durable=False,
+ )
+ finally:
+ try:
+ conn.close()
+ except Exception: # noqa: BLE001
+ pass
+ finally:
+ t.close()
diff --git a/tests/adapters/messaging/test_rabbitmq_transport.py b/tests/adapters/messaging/test_rabbitmq_transport.py
new file mode 100644
index 0000000..906a423
--- /dev/null
+++ b/tests/adapters/messaging/test_rabbitmq_transport.py
@@ -0,0 +1,171 @@
+"""RabbitMQTransport integration tests (REQ-022 AC-2, REQ-023, REQ-024).
+
+Skipped without TREX_RABBITMQ_TEST_URL. Each test uses a unique uuid in
+queue/routing keys to avoid colliding with other tests or runs.
+"""
+from __future__ import annotations
+
+import os
+import threading
+import time
+import uuid
+
+import pytest
+
+from trex_core.adapters.messaging import topology
+from trex_core.adapters.messaging.rabbitmq import RabbitMQTransport
+from trex_core.application.messaging import (
+ RpcRequest,
+ RpcResponse,
+ RpcTimeoutError,
+ TransportHealth,
+)
+
+
+@pytest.fixture
+def mq_url() -> str:
+ url = os.environ.get("TREX_RABBITMQ_TEST_URL")
+ if not url:
+ pytest.skip("TREX_RABBITMQ_TEST_URL not set; skipping RabbitMQ integration test")
+ return url
+
+
+def _drain_queue(url: str, queue: str) -> None:
+ import pika
+ conn = pika.BlockingConnection(pika.URLParameters(url))
+ try:
+ ch = conn.channel()
+ try:
+ ch.queue_delete(queue=queue)
+ except Exception: # noqa: BLE001
+ pass
+ finally:
+ conn.close()
+
+
+def test_declare_topology_creates_core_entities(mq_url):
+ t = RabbitMQTransport(mq_url, timeout=5.0)
+ try:
+ t.declare_topology()
+ # If declare_topology succeeded, exchanges/queues now exist. Re-declare
+ # is idempotent (RabbitMQ no-op on existing matching definitions).
+ t.declare_topology()
+ assert t.health() is TransportHealth.CONNECTED
+ finally:
+ t.close()
+
+
+def test_rpc_roundtrip(mq_url):
+ queue = f"trex.test.rpc.{uuid.uuid4().hex[:8]}"
+ server = RabbitMQTransport(mq_url, timeout=5.0)
+ client = RabbitMQTransport(mq_url, timeout=5.0)
+ try:
+ # Pre-declare RPC queue (server-side will redeclare too).
+ ch = server._channel
+ if server._conn is None:
+ server._connect()
+ ch = server._channel
+ ch.queue_declare(queue, durable=True,
+ arguments={"x-dead-letter-exchange": topology.EVENTS_DLQ_EXCHANGE})
+
+ def handler(req: RpcRequest) -> RpcResponse:
+ return RpcResponse(payload={"echo": req.payload, "cid": req.correlation_id})
+
+ stop = threading.Event()
+ th = threading.Thread(
+ target=server.consume_rpc_forever,
+ args=(queue, handler, stop),
+ daemon=True,
+ )
+ th.start()
+ time.sleep(0.2)
+ resp = client.call_rpc(queue, {"hello": "world"}, correlation_id="cid-1", timeout=3.0)
+ assert resp["echo"] == {"hello": "world"}
+ assert resp["cid"] == "cid-1"
+ stop.set()
+ th.join(timeout=2.0)
+ finally:
+ server.close()
+ client.close()
+ _drain_queue(mq_url, queue)
+
+
+def test_event_publish_and_per_strategy_consume(mq_url):
+ suffix = uuid.uuid4().hex[:8]
+ strategy_a = f"A-{suffix}"
+ strategy_b = f"B-{suffix}"
+ queue_a = topology.strategy_event_queue_name(strategy_a)
+ queue_b = topology.strategy_event_queue_name(strategy_b)
+
+ publisher = RabbitMQTransport(mq_url, timeout=5.0)
+ consumer_a = RabbitMQTransport(mq_url, timeout=5.0)
+ consumer_b = RabbitMQTransport(mq_url, timeout=5.0)
+ received_a: list[tuple[str, dict]] = []
+ received_b: list[tuple[str, dict]] = []
+ stop = threading.Event()
+ try:
+ publisher.declare_topology()
+ # Pre-declare per-strategy queues so the publisher's message is not
+ # discarded before the consumers start.
+ publisher.declare_strategy_queue(queue_a, topology.strategy_event_binding_pattern(strategy_a))
+ publisher.declare_strategy_queue(queue_b, topology.strategy_event_binding_pattern(strategy_b))
+
+ th_a = threading.Thread(
+ target=consumer_a.consume_events_forever,
+ args=(queue_a, topology.strategy_event_binding_pattern(strategy_a),
+ lambda rk, p: received_a.append((rk, p)), stop),
+ daemon=True,
+ )
+ th_b = threading.Thread(
+ target=consumer_b.consume_events_forever,
+ args=(queue_b, topology.strategy_event_binding_pattern(strategy_b),
+ lambda rk, p: received_b.append((rk, p)), stop),
+ daemon=True,
+ )
+ th_a.start()
+ th_b.start()
+ time.sleep(0.3)
+
+ rk_a = topology.event_routing_key("slot_filled_buy", strategy_a, "005930")
+ rk_b = topology.event_routing_key("slot_filled_buy", strategy_b, "005930")
+ publisher.publish_event(rk_a, {"slot": "1", "for": "A"})
+ publisher.publish_event(rk_b, {"slot": "2", "for": "B"})
+
+ deadline = time.monotonic() + 3.0
+ while time.monotonic() < deadline and (not received_a or not received_b):
+ time.sleep(0.05)
+
+ assert any(rk == rk_a for rk, _ in received_a)
+ assert all(rk != rk_b for rk, _ in received_a), "A queue must not receive B events"
+ assert any(rk == rk_b for rk, _ in received_b)
+ assert all(rk != rk_a for rk, _ in received_b), "B queue must not receive A events"
+ finally:
+ stop.set()
+ time.sleep(0.2)
+ publisher.close()
+ consumer_a.close()
+ consumer_b.close()
+ _drain_queue(mq_url, queue_a)
+ _drain_queue(mq_url, queue_b)
+
+
+def test_call_rpc_timeout(mq_url):
+ queue = f"trex.test.rpc.timeout.{uuid.uuid4().hex[:8]}"
+ client = RabbitMQTransport(mq_url, timeout=5.0)
+ try:
+ # Declare a queue with no consumer; RPC must time out.
+ client._ensure_connected()
+ client._channel.queue_declare(queue, durable=True)
+ with pytest.raises(RpcTimeoutError):
+ client.call_rpc(queue, {"x": 1}, correlation_id="cid-timeout", timeout=0.5)
+ finally:
+ client.close()
+ _drain_queue(mq_url, queue)
+
+
+def test_close_marks_disconnected(mq_url):
+ t = RabbitMQTransport(mq_url, timeout=5.0)
+ t.declare_topology()
+ assert t.health() is TransportHealth.CONNECTED
+ t.close()
+ assert t.health() is TransportHealth.DISCONNECTED
diff --git a/tests/adapters/messaging/test_topology.py b/tests/adapters/messaging/test_topology.py
new file mode 100644
index 0000000..cba29fa
--- /dev/null
+++ b/tests/adapters/messaging/test_topology.py
@@ -0,0 +1,33 @@
+"""Topology constants + routing key builders (REQ-021)."""
+from __future__ import annotations
+
+from trex_core.adapters.messaging import topology
+
+
+def test_topology_constants():
+ assert topology.SNAPSHOT_REQ_QUEUE == "trex.snapshot.req"
+ assert topology.INTENT_REQ_QUEUE == "trex.intent.req"
+ assert topology.EVENTS_EXCHANGE == "trex.events"
+ assert topology.EVENTS_DLQ_EXCHANGE == "trex.events.dlq"
+
+
+def test_event_routing_key_format():
+ assert topology.event_routing_key("slot_filled_buy", "A", "005930") == \
+ "slot_filled_buy.A.005930"
+ # dots/wildcards in inputs are sanitized to underscores
+ assert topology.event_routing_key("e.x", "y*z", "a#b") == "e_x.y_z.a_b"
+ # None / empty strategy → "_"
+ assert topology.event_routing_key("e", None, "S") == "e._.S"
+
+
+def test_strategy_queue_name_and_binding_pattern():
+ assert topology.strategy_event_queue_name("A") == "trex.events.strategy.A"
+ assert topology.strategy_event_binding_pattern("A") == "*.A.#"
+
+
+def test_strategy_queue_args_have_ttl_and_max_length():
+ args = topology.STRATEGY_QUEUE_ARGS
+ assert args["x-message-ttl"] > 0
+ assert args["x-max-length"] > 0
+ assert args["x-overflow"] == "drop-head"
+ assert args["x-dead-letter-exchange"] == topology.EVENTS_DLQ_EXCHANGE
diff --git a/tests/application/test_messaging_event_publisher.py b/tests/application/test_messaging_event_publisher.py
new file mode 100644
index 0000000..f6cec85
--- /dev/null
+++ b/tests/application/test_messaging_event_publisher.py
@@ -0,0 +1,131 @@
+"""Slot transition event emission tests (REQ-021 + REQ-023 + REQ-018 hook)."""
+from __future__ import annotations
+
+import threading
+import time
+from datetime import date
+
+from trex_core.adapters.broker.paper import PaperBroker
+from trex_core.adapters.ledger.in_memory import InMemoryLedger
+from trex_core.adapters.messaging import topology
+from trex_core.adapters.messaging.in_memory import InMemoryTransport
+from trex_core.adapters.persistence.in_memory_intent_store import InMemoryIntentStore
+from trex_core.application.execution import ExecutionService
+from trex_core.application.intents import BuyIntent, IntentService
+from trex_core.application.ledger_outbox import InMemoryLedgerOutbox, LedgerWriter
+from trex_core.application.messaging_handlers import slot_transition_event_payload
+from trex_core.domain.slot import SlotService, SlotState
+from trex_core.domain.slot.in_memory_repository import InMemorySlotRepository
+
+DAY = date(2026, 6, 5)
+
+
+def _wire(transport):
+ repo = InMemorySlotRepository()
+ svc = SlotService(repo)
+ intents = IntentService(svc, repo, InMemoryIntentStore())
+ outbox = InMemoryLedgerOutbox()
+ ledger = InMemoryLedger()
+ writer = LedgerWriter(outbox, ledger)
+ svc.preallocate_daily_slots(DAY, 3)
+
+ def emitter(event_type: str, slot) -> None:
+ rk = topology.event_routing_key(event_type, slot.strategy_id or "_", slot.symbol or "_")
+ payload = slot_transition_event_payload(slot, event_type=event_type)
+ try:
+ transport.publish_event(rk, payload)
+ except Exception: # noqa: BLE001
+ pass
+
+ execution = ExecutionService(svc, repo, PaperBroker(fill_after_polls=0),
+ ledger_outbox=outbox, event_emitter=emitter)
+ return repo, svc, intents, execution, writer
+
+
+def test_fill_emits_slot_filled_event_with_routing_key_and_state():
+ transport = InMemoryTransport()
+ received: list[tuple[str, dict]] = []
+ stop = threading.Event()
+ th = threading.Thread(
+ target=transport.consume_events_forever,
+ args=("trex.events.strategy.A", topology.strategy_event_binding_pattern("A"),
+ lambda rk, p: received.append((rk, p)), stop),
+ daemon=True,
+ )
+ th.start()
+ time.sleep(0.05)
+
+ repo, _, intents, execution, _ = _wire(transport)
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10,
+ strategy_id="A", portfolio_id="PF-1",
+ ))
+ execution.run_once()
+ time.sleep(0.05)
+ stop.set()
+ th.join(timeout=1.0)
+
+ assert len(received) == 1
+ rk, payload = received[0]
+ assert rk == "slot_filled_buy.A.005930"
+ # payload carries current state + monotonic sequence (REQ-023 AC-5)
+ assert payload["event_type"] == "slot_filled_buy"
+ assert payload["status"] == SlotState.HOLDING.value
+ assert payload["strategy_id"] == "A"
+ assert payload["symbol"] == "005930"
+ assert "sequence_at" in payload # last-wins ordering token
+
+
+def test_event_for_strategy_a_does_not_reach_strategy_b_queue():
+ """REQ-021 AC-4: per-strategy routing key binding filters at the broker."""
+ transport = InMemoryTransport()
+ received_a: list[tuple[str, dict]] = []
+ received_b: list[tuple[str, dict]] = []
+ stop = threading.Event()
+ th_a = threading.Thread(
+ target=transport.consume_events_forever,
+ args=("q.A", topology.strategy_event_binding_pattern("A"),
+ lambda rk, p: received_a.append((rk, p)), stop),
+ daemon=True,
+ )
+ th_b = threading.Thread(
+ target=transport.consume_events_forever,
+ args=("q.B", topology.strategy_event_binding_pattern("B"),
+ lambda rk, p: received_b.append((rk, p)), stop),
+ daemon=True,
+ )
+ th_a.start()
+ th_b.start()
+ time.sleep(0.05)
+
+ _, _, intents, execution, _ = _wire(transport)
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10,
+ strategy_id="A", portfolio_id="PF-1",
+ ))
+ execution.run_once()
+ time.sleep(0.05)
+ stop.set()
+ th_a.join(timeout=1.0)
+ th_b.join(timeout=1.0)
+
+ assert any(rk == "slot_filled_buy.A.005930" for rk, _ in received_a)
+ assert received_b == []
+
+
+def test_publish_failure_does_not_break_execution_loop():
+ """Publish errors must NOT roll back slot transitions or ledger enqueue."""
+ transport = InMemoryTransport()
+ transport.set_available(False) # all publishes will raise TransportUnavailableError
+
+ repo, _, intents, execution, _ = _wire(transport)
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10,
+ strategy_id="A", portfolio_id="PF-1",
+ ))
+ r = execution.run_once()
+ # Slot still transitioned; ledger still enqueued.
+ assert r.filled == 1
+ assert r.ledger_enqueued == 1
+ pending = [s for s in repo.list_slots(DAY) if s.status is SlotState.HOLDING]
+ assert len(pending) == 1
diff --git a/tests/application/test_messaging_intent_consumer.py b/tests/application/test_messaging_intent_consumer.py
new file mode 100644
index 0000000..caeb1e1
--- /dev/null
+++ b/tests/application/test_messaging_intent_consumer.py
@@ -0,0 +1,132 @@
+"""Intent admission RPC handler + dedup tests (REQ-021/022/023, dcy-006).
+
+The handler calls IntentService.submit_*, so dedup uses the IntentStore
+(intent_log) gate (REQ-007). Two messages with the same correlation_id
+trigger exactly ONE slot transition (REQ-023 AC-1).
+"""
+from __future__ import annotations
+
+from datetime import date
+
+
+from trex_core.adapters.persistence.in_memory_intent_store import InMemoryIntentStore
+from trex_core.application.intents import IntentService
+from trex_core.application.messaging import RpcRequest
+from trex_core.application.messaging_handlers import make_intent_rpc_handler
+from trex_core.domain.slot import SlotService, SlotState
+from trex_core.domain.slot.in_memory_repository import InMemorySlotRepository
+
+DAY = date(2026, 6, 5)
+
+
+def _wire():
+ repo = InMemorySlotRepository()
+ svc = SlotService(repo)
+ intents = IntentService(svc, repo, InMemoryIntentStore())
+ svc.preallocate_daily_slots(DAY, 3)
+ return repo, svc, intents
+
+
+def _buy_req(intent_id: str, symbol: str = "005930") -> RpcRequest:
+ return RpcRequest(
+ payload={
+ "intent_type": "buy",
+ "intent_id": intent_id,
+ "trading_date": DAY.isoformat(),
+ "symbol": symbol,
+ "qty": 10,
+ },
+ correlation_id=intent_id,
+ )
+
+
+def test_buy_admission_returns_admitted_and_transitions_slot():
+ repo, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ resp = handler(_buy_req("buy-1"))
+ assert resp.payload["status"] == "admitted"
+ assert resp.payload["slot_id"]
+ from uuid import UUID
+ slot = repo.fetch_slot(UUID(resp.payload["slot_id"]))
+ assert slot.status is SlotState.PENDING_BUY and slot.symbol == "005930"
+
+
+def test_duplicate_correlation_id_dedups_via_intent_log():
+ """REQ-023 AC-1: same intent_id ⇒ slot transition exactly once."""
+ repo, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ r1 = handler(_buy_req("buy-dup"))
+ r2 = handler(_buy_req("buy-dup"))
+ assert r1.payload == r2.payload
+ pending = [s for s in repo.list_slots(DAY) if s.status is SlotState.PENDING_BUY]
+ assert len(pending) == 1
+
+
+def test_buy_rejected_when_no_idle_slot():
+ repo, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ for i in range(3):
+ assert handler(_buy_req(f"buy-{i}")).payload["status"] == "admitted"
+ resp = handler(_buy_req("overflow"))
+ assert resp.payload["status"] == "rejected"
+ assert resp.payload["reason"] == "no_idle_slot"
+
+
+def test_sell_admission_from_holding():
+ repo, svc, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ sid = handler(_buy_req("buy-h")).payload["slot_id"]
+ from uuid import UUID
+ svc.transit_slot(UUID(sid), SlotState.PENDING_BUY, SlotState.HOLDING,
+ reason="filled", actor="t")
+ resp = handler(RpcRequest(
+ payload={"intent_type": "sell", "intent_id": "sell-h", "slot_id": sid},
+ correlation_id="sell-h",
+ ))
+ assert resp.payload["status"] == "admitted"
+ assert repo.fetch_slot(UUID(sid)).status is SlotState.PENDING_SELL
+
+
+def test_bad_payload_returns_rejected_not_exception():
+ """Handler must not raise — bad input ⇒ structured rejection."""
+ _, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ # missing slot_id for sell
+ resp = handler(RpcRequest(
+ payload={"intent_type": "sell", "intent_id": "bad"},
+ correlation_id="bad",
+ ))
+ assert resp.payload["status"] == "rejected"
+ assert resp.payload["reason"].startswith("bad_request:")
+
+
+def test_unknown_intent_type_rejected():
+ _, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ resp = handler(RpcRequest(
+ payload={"intent_type": "ping", "intent_id": "x"},
+ correlation_id="x",
+ ))
+ assert resp.payload["status"] == "rejected"
+ assert "unknown_intent_type" in resp.payload["reason"]
+
+
+def test_correlation_id_is_used_as_intent_id_when_missing_in_payload():
+ """The transport's correlation_id is the canonical idempotency key."""
+ repo, _, intents = _wire()
+ handler = make_intent_rpc_handler(intents)
+ req = RpcRequest(
+ payload={
+ "intent_type": "buy",
+ "trading_date": DAY.isoformat(),
+ "symbol": "005930",
+ "qty": 5,
+ },
+ correlation_id="cid-only",
+ )
+ r1 = handler(req)
+ r2 = handler(req)
+ assert r1.payload["status"] == "admitted"
+ assert r1.payload == r2.payload
+ pending = [s for s in repo.list_slots(DAY) if s.status is SlotState.PENDING_BUY]
+ assert len(pending) == 1
diff --git a/tests/application/test_messaging_snapshot_consumer.py b/tests/application/test_messaging_snapshot_consumer.py
new file mode 100644
index 0000000..15a2803
--- /dev/null
+++ b/tests/application/test_messaging_snapshot_consumer.py
@@ -0,0 +1,74 @@
+"""Snapshot RPC handler tests (REQ-021 AC-2, BAT-007 stub-shape)."""
+from __future__ import annotations
+
+from datetime import date
+
+from trex_core.adapters.persistence.in_memory_intent_store import InMemoryIntentStore
+from trex_core.application.intents import BuyIntent, IntentService
+from trex_core.application.messaging import RpcRequest
+from trex_core.application.messaging_handlers import make_snapshot_rpc_handler
+from trex_core.domain.slot import SlotService
+from trex_core.domain.slot.in_memory_repository import InMemorySlotRepository
+
+DAY = date(2026, 6, 5)
+
+
+def _wire():
+ repo = InMemorySlotRepository()
+ svc = SlotService(repo)
+ intents = IntentService(svc, repo, InMemoryIntentStore())
+ svc.preallocate_daily_slots(DAY, 3)
+ return repo, svc, intents
+
+
+def _req(view="all", strategy_id=None):
+ return RpcRequest(
+ payload={
+ "view": view,
+ "strategy_id": strategy_id,
+ "trading_date": DAY.isoformat(),
+ },
+ correlation_id="snap-cid",
+ )
+
+
+def test_snapshot_returns_all_slots_and_capacity():
+ repo, svc, intents = _wire()
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10,
+ strategy_id="A",
+ ))
+ handler = make_snapshot_rpc_handler(repo, svc)
+ resp = handler(_req())
+ assert resp.payload["trading_date"] == DAY.isoformat()
+ assert resp.payload["view"] == "all"
+ assert len(resp.payload["slots"]) == 3 # all 3 slots returned
+ cap = resp.payload["capacity"]
+ assert cap["pending_count"] == 1 and cap["idle_count"] == 2
+
+
+def test_snapshot_open_view_filters_to_active_slots():
+ repo, svc, intents = _wire()
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10, strategy_id="A",
+ ))
+ handler = make_snapshot_rpc_handler(repo, svc)
+ resp = handler(_req(view="open"))
+ statuses = {s["status"] for s in resp.payload["slots"]}
+ assert "idle" not in statuses
+ assert statuses == {"pending_buy"}
+
+
+def test_snapshot_strategy_id_filter():
+ repo, svc, intents = _wire()
+ intents.submit_buy(BuyIntent(
+ intent_id="b1", trading_date=DAY, symbol="005930", qty=10, strategy_id="A",
+ ))
+ intents.submit_buy(BuyIntent(
+ intent_id="b2", trading_date=DAY, symbol="000660", qty=5, strategy_id="B",
+ ))
+ handler = make_snapshot_rpc_handler(repo, svc)
+ resp = handler(_req(view="open", strategy_id="A"))
+ assert len(resp.payload["slots"]) == 1
+ assert resp.payload["slots"][0]["strategy_id"] == "A"
+ assert resp.payload["slots"][0]["symbol"] == "005930"
diff --git a/tests/conftest.py b/tests/conftest.py
index 7bf5993..1a685e7 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,7 +1,12 @@
"""Shared test fixtures.
-PostgreSQL integration tests are gated on TREX_POSTGRESQL_TEST_DSN; when it
-is unset they are skipped (unit/API tests still run via in-memory adapters).
+Infrastructure integration tests are gated on env vars:
+ - TREX_POSTGRESQL_TEST_DSN : PostgreSQL repository/outbox/migration tests
+ - TREX_RABBITMQ_TEST_URL : RabbitMQ transport + intent RPC E2E tests
+ - TREX_KIS_BROKER_* : KIS sandbox round-trip test
+
+When a gate is unset the corresponding tests are skipped; unit tests
+(in-memory adapters, stub transport) always run.
"""
from __future__ import annotations
diff --git a/tests/domain/test_domain_import_sweep.py b/tests/domain/test_domain_import_sweep.py
index b41751a..911f435 100644
--- a/tests/domain/test_domain_import_sweep.py
+++ b/tests/domain/test_domain_import_sweep.py
@@ -15,9 +15,11 @@ _FORBIDDEN_PREFIXES = (
"httpx",
"fastapi",
"uvicorn",
+ "starlette",
"psycopg",
"redis",
- "trex_core.adapters", # any adapter (broker, ledger, persistence, api)
+ "pika", # BAT-007: AMQP must not leak into domain (REQ-022 AC-5)
+ "trex_core.adapters", # any adapter (broker, ledger, messaging, persistence)
"trex_core.runtime", # daemon / config
"trex_core.application", # ports/services live one layer up
)
diff --git a/tests/runtime/test_daemon_no_http_surface.py b/tests/runtime/test_daemon_no_http_surface.py
new file mode 100644
index 0000000..ed98916
--- /dev/null
+++ b/tests/runtime/test_daemon_no_http_surface.py
@@ -0,0 +1,58 @@
+"""HTTP表면 0 회귀 가드 (REQ-025).
+
+본 테스트는 데몬 import 그래프에 fastapi/uvicorn/starlette 가 0건임을
+정적으로 가드한다. 또한 pyproject.toml 의 runtime 의존성에서 이들이
+제거되어 있는지 확인한다.
+"""
+from __future__ import annotations
+
+import importlib
+import sys
+from pathlib import Path
+
+
+_REPO_ROOT = Path(__file__).resolve().parents[2]
+
+
+def test_daemon_module_has_no_fastapi_or_uvicorn_import():
+ # Importing the daemon must not pull in FastAPI/uvicorn/starlette anywhere
+ # in the transitive trex_core graph.
+ for forbidden in ("fastapi", "uvicorn", "starlette"):
+ sys.modules.pop(forbidden, None)
+ importlib.invalidate_caches()
+ importlib.import_module("trex_core.runtime.daemon")
+ # Walk all loaded trex_core.* modules and assert none triggered a forbidden import.
+ leaked = [name for name in ("fastapi", "uvicorn", "starlette") if name in sys.modules]
+ assert leaked == [], f"forbidden HTTP framework imports leaked: {leaked}"
+
+
+def test_adapters_api_tree_does_not_exist():
+ assert not (_REPO_ROOT / "trex_core" / "adapters" / "api").exists(), (
+ "trex_core/adapters/api must be removed (REQ-025 AC-1)"
+ )
+
+
+def test_no_fastapi_or_uvicorn_in_trex_core_source():
+ """grep all .py under trex_core/ — must be 0 matches for fastapi/uvicorn."""
+ pattern_files: list[Path] = []
+ for py in (_REPO_ROOT / "trex_core").rglob("*.py"):
+ text = py.read_text()
+ if any(token in text for token in ("import fastapi", "from fastapi",
+ "import uvicorn", "from uvicorn",
+ "import starlette", "from starlette")):
+ pattern_files.append(py.relative_to(_REPO_ROOT))
+ assert pattern_files == [], f"fastapi/uvicorn imports leaked into: {pattern_files}"
+
+
+def test_pyproject_dependencies_have_no_fastapi_or_uvicorn():
+ pyproject = (_REPO_ROOT / "pyproject.toml").read_text()
+ # naive substring check is sufficient — we're guarding a removal, not parsing
+ assert "fastapi" not in pyproject, "fastapi must be removed from pyproject.toml"
+ assert "uvicorn" not in pyproject, "uvicorn must be removed from pyproject.toml"
+
+
+def test_config_env_no_longer_references_api_host_or_port():
+ """DaemonConfig must not read TREX_API_HOST/PORT (REQ-025 AC-3)."""
+ cfg_src = (_REPO_ROOT / "trex_core" / "runtime" / "config.py").read_text()
+ assert "TREX_API_HOST" not in cfg_src
+ assert "TREX_API_PORT" not in cfg_src
diff --git a/trex_core/adapters/api/__init__.py b/trex_core/adapters/api/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/trex_core/adapters/api/app.py b/trex_core/adapters/api/app.py
deleted file mode 100644
index 33b7bbd..0000000
--- a/trex_core/adapters/api/app.py
+++ /dev/null
@@ -1,114 +0,0 @@
-"""FastAPI app factory for the slot-core daemon (REQ-005/007/008).
-
-`create_app` wires the HTTP /v1 surface to injected services so the same app
-runs against the in-memory adapters (tests) or PostgreSQL adapters (daemon).
-All slot writes go through IntentService → SlotService (single writer).
-"""
-from __future__ import annotations
-
-from datetime import date as date_cls
-from typing import Optional
-
-from fastapi import FastAPI, HTTPException, Query
-
-from trex_core.adapters.api.schemas import (
- BuyIntentRequest,
- CapacityResponse,
- HealthResponse,
- IntentResponse,
- SellIntentRequest,
- SlotSnapshot,
-)
-from trex_core.application.intents import BuyIntent, IntentService, SellIntent
-from trex_core.domain.slot import SlotRepository, SlotService
-
-
-def create_app(
- *,
- slot_service: SlotService,
- slot_repo: SlotRepository,
- intent_service: IntentService,
- default_total_slots: int,
-) -> FastAPI:
- app = FastAPI(title="trex-core slot daemon", version="0.1.0")
-
- @app.get("/v1/healthz", response_model=HealthResponse)
- def healthz() -> HealthResponse:
- return HealthResponse()
-
- @app.post("/v1/intents/buy", response_model=IntentResponse)
- def submit_buy(req: BuyIntentRequest) -> IntentResponse:
- d = intent_service.submit_buy(
- BuyIntent(
- intent_id=req.intent_id,
- trading_date=req.trading_date,
- symbol=req.symbol,
- qty=req.qty,
- allocated_capital=req.allocated_capital,
- entry_price=req.entry_price,
- strategy_id=req.strategy_id,
- sell_strategy_id=req.sell_strategy_id,
- portfolio_id=req.portfolio_id,
- forced_close_at=req.forced_close_at,
- )
- )
- return IntentResponse(intent_id=d.intent_id, status=d.status, slot_id=d.slot_id, reason=d.reason)
-
- @app.post("/v1/intents/sell", response_model=IntentResponse)
- def submit_sell(req: SellIntentRequest) -> IntentResponse:
- d = intent_service.submit_sell(
- SellIntent(
- intent_id=req.intent_id,
- slot_id=req.slot_id,
- reason=req.reason,
- sell_strategy_id=req.sell_strategy_id,
- )
- )
- return IntentResponse(intent_id=d.intent_id, status=d.status, slot_id=d.slot_id, reason=d.reason)
-
- @app.get("/v1/intents/{intent_id}", response_model=IntentResponse)
- def get_intent(intent_id: str) -> IntentResponse:
- d = intent_service.lookup(intent_id)
- if d is None:
- raise HTTPException(status_code=404, detail="intent not found")
- return IntentResponse(intent_id=d.intent_id, status=d.status, slot_id=d.slot_id, reason=d.reason)
-
- @app.get("/v1/slots", response_model=list[SlotSnapshot])
- def list_slots(
- status: Optional[str] = Query(default=None),
- trading_date: Optional[date_cls] = Query(default=None),
- ) -> list[SlotSnapshot]:
- day = trading_date or _today()
- slots = slot_repo.list_slots(day)
- if status is not None:
- slots = [s for s in slots if s.status.value == status]
- return [
- SlotSnapshot(
- slot_id=s.slot_id, trading_date=s.trading_date, status=s.status.value,
- symbol=s.symbol, qty=s.qty, avg_price=s.avg_price, entry_price=s.entry_price,
- allocated_capital=s.allocated_capital, strategy_id=s.strategy_id,
- sell_strategy_id=s.sell_strategy_id, forced_close_at=s.forced_close_at,
- )
- for s in slots
- ]
-
- @app.get("/v1/capacity", response_model=CapacityResponse)
- def capacity(
- trading_date: Optional[date_cls] = Query(default=None),
- total_slots: Optional[int] = Query(default=None),
- ) -> CapacityResponse:
- day = trading_date or _today()
- cap = slot_service.compute_slot_capacity(day, total_slots or default_total_slots)
- return CapacityResponse(
- idle_count=cap.idle_count, holding_count=cap.holding_count,
- pending_count=cap.pending_count, total_slots=cap.total_slots,
- scarcity_ratio=cap.scarcity_ratio,
- )
-
- return app
-
-
-def _today() -> date_cls:
- from datetime import datetime, timezone
-
- return datetime.now(tz=timezone.utc).date()
diff --git a/trex_core/adapters/api/schemas.py b/trex_core/adapters/api/schemas.py
deleted file mode 100644
index 042a157..0000000
--- a/trex_core/adapters/api/schemas.py
+++ /dev/null
@@ -1,61 +0,0 @@
-"""Pydantic request/response schemas for the /v1 HTTP API (REQ-007/008)."""
-from __future__ import annotations
-
-from datetime import date, datetime
-from typing import Optional
-from uuid import UUID
-
-from pydantic import BaseModel
-
-
-class BuyIntentRequest(BaseModel):
- intent_id: str
- trading_date: date
- symbol: str
- qty: Optional[float] = None
- allocated_capital: Optional[float] = None
- entry_price: Optional[float] = None
- strategy_id: Optional[str] = None
- sell_strategy_id: Optional[str] = None
- portfolio_id: Optional[str] = None
- forced_close_at: Optional[datetime] = None
-
-
-class SellIntentRequest(BaseModel):
- intent_id: str
- slot_id: UUID
- reason: str = "discretionary_sell"
- sell_strategy_id: Optional[str] = None
-
-
-class IntentResponse(BaseModel):
- intent_id: str
- status: str
- slot_id: Optional[UUID] = None
- reason: Optional[str] = None
-
-
-class SlotSnapshot(BaseModel):
- slot_id: UUID
- trading_date: date
- status: str
- symbol: Optional[str] = None
- qty: Optional[float] = None
- avg_price: Optional[float] = None
- entry_price: Optional[float] = None
- allocated_capital: Optional[float] = None
- strategy_id: Optional[str] = None
- sell_strategy_id: Optional[str] = None
- forced_close_at: Optional[datetime] = None
-
-
-class CapacityResponse(BaseModel):
- idle_count: int
- holding_count: int
- pending_count: int
- total_slots: int
- scarcity_ratio: float
-
-
-class HealthResponse(BaseModel):
- status: str = "ok"
diff --git a/trex_core/adapters/messaging/__init__.py b/trex_core/adapters/messaging/__init__.py
new file mode 100644
index 0000000..0a37f85
--- /dev/null
+++ b/trex_core/adapters/messaging/__init__.py
@@ -0,0 +1,12 @@
+"""Messaging adapters (REQ-021, REQ-022, dcy-006).
+
+- InMemoryTransport: deterministic stub for tests (no broker).
+- RabbitMQTransport: pika BlockingConnection adapter for real RabbitMQ.
+
+Topology constants live in `topology` and are shared by both adapters.
+"""
+from trex_core.adapters.messaging.in_memory import InMemoryTransport
+from trex_core.adapters.messaging.rabbitmq import RabbitMQTransport
+from trex_core.adapters.messaging import topology
+
+__all__ = ["InMemoryTransport", "RabbitMQTransport", "topology"]
diff --git a/trex_core/adapters/messaging/in_memory.py b/trex_core/adapters/messaging/in_memory.py
new file mode 100644
index 0000000..a6440fa
--- /dev/null
+++ b/trex_core/adapters/messaging/in_memory.py
@@ -0,0 +1,177 @@
+"""In-memory messaging transport — deterministic stub for tests (REQ-022 AC-1).
+
+Implements `MessagingTransport` with process-local pub/sub + sync RPC.
+RPC handlers and event subscribers are registered in shared state; calls
+dispatch directly to the registered handler in the caller's thread for
+deterministic tests (no broker, no extra threads).
+
+`set_available(False)` simulates a broker outage so degrade-policy tests
+(REQ-024) can exercise the conservative-halt branch without RabbitMQ.
+"""
+from __future__ import annotations
+
+import threading
+import uuid
+
+from trex_core.application.messaging import (
+ EventHandler,
+ RpcHandler,
+ RpcRequest,
+ RpcTimeoutError,
+ TransportHealth,
+ TransportUnavailableError,
+)
+
+
+class InMemoryTransport:
+ def __init__(self) -> None:
+ self._lock = threading.Lock()
+ self._rpc_handlers: dict[str, RpcHandler] = {}
+ self._event_subscribers: list[tuple[str, EventHandler]] = [] # (pattern, handler)
+ self._dlq: list[tuple[str, dict]] = [] # (routing_key, payload)
+ self._available = True
+ self._health = TransportHealth.CONNECTED
+
+ # --- topology ---
+ def declare_topology(self) -> None:
+ """No-op: in-memory does not need broker declarations."""
+ return
+
+ # --- availability toggle (test affordance) ---
+ def set_available(self, available: bool) -> None:
+ with self._lock:
+ self._available = available
+ self._health = (
+ TransportHealth.CONNECTED if available else TransportHealth.DISCONNECTED
+ )
+
+ def health(self) -> TransportHealth:
+ with self._lock:
+ return self._health
+
+ def dlq_messages(self) -> list[tuple[str, dict]]:
+ with self._lock:
+ return list(self._dlq)
+
+ # --- events ---
+ def publish_event(
+ self,
+ routing_key: str,
+ payload: dict,
+ *,
+ mandatory: bool = True,
+ ) -> None:
+ with self._lock:
+ if not self._available:
+ # No buffering: unroutable goes to DLQ, caller may also reject (REQ-023/024).
+ self._dlq.append((routing_key, dict(payload)))
+ raise TransportUnavailableError(
+ "transport disconnected; event routed to DLQ collector"
+ )
+ subscribers = [
+ handler for pattern, handler in self._event_subscribers
+ if _routing_match(pattern, routing_key)
+ ]
+ if mandatory and not subscribers:
+ # Unroutable -> DLQ (REQ-023 AC-6)
+ self._dlq.append((routing_key, dict(payload)))
+ for handler in subscribers:
+ try:
+ handler(routing_key, dict(payload))
+ except Exception: # noqa: BLE001 - subscriber failures must not poison publisher
+ continue
+
+ # --- RPC client ---
+ def call_rpc(
+ self,
+ queue: str,
+ payload: dict,
+ *,
+ correlation_id: str,
+ timeout: float,
+ ) -> dict:
+ with self._lock:
+ if not self._available:
+ raise TransportUnavailableError(
+ "transport disconnected; cannot call RPC"
+ )
+ handler = self._rpc_handlers.get(queue)
+ if handler is None:
+ raise RpcTimeoutError(f"no consumer for queue {queue}")
+ # Direct synchronous dispatch (stub).
+ req = RpcRequest(
+ payload=dict(payload),
+ correlation_id=correlation_id,
+ reply_to=f"inmem-reply-{uuid.uuid4().hex[:8]}",
+ )
+ resp = handler(req)
+ return dict(resp.payload)
+
+ # --- RPC server ---
+ def consume_rpc_forever(
+ self,
+ queue: str,
+ handler: RpcHandler,
+ stop: threading.Event,
+ ) -> None:
+ with self._lock:
+ self._rpc_handlers[queue] = handler
+ try:
+ # Block until stop. Dispatch happens synchronously in call_rpc.
+ while not stop.is_set():
+ stop.wait(0.05)
+ finally:
+ with self._lock:
+ if self._rpc_handlers.get(queue) is handler:
+ del self._rpc_handlers[queue]
+
+ # --- Event subscriber ---
+ def consume_events_forever(
+ self,
+ queue: str,
+ binding_pattern: str,
+ handler: EventHandler,
+ stop: threading.Event,
+ ) -> None:
+ entry = (binding_pattern, handler)
+ with self._lock:
+ self._event_subscribers.append(entry)
+ try:
+ while not stop.is_set():
+ stop.wait(0.05)
+ finally:
+ with self._lock:
+ if entry in self._event_subscribers:
+ self._event_subscribers.remove(entry)
+
+ def close(self) -> None:
+ with self._lock:
+ self._available = False
+ self._health = TransportHealth.DISCONNECTED
+
+
+def _routing_match(pattern: str, routing_key: str) -> bool:
+ """AMQP topic match (`*` = one word, `#` = zero-or-more words). Stub
+ keeps it simple via fnmatch on word-aware translation."""
+ # Convert AMQP wildcards to fnmatch: `*` -> any single token (no dots),
+ # `#` -> any sequence including empty.
+ parts = pattern.split(".")
+ key_parts = routing_key.split(".")
+
+ def _match(p: list[str], k: list[str]) -> bool:
+ if not p:
+ return not k
+ head, *rest = p
+ if head == "#":
+ # match zero or more words
+ for i in range(len(k) + 1):
+ if _match(rest, k[i:]):
+ return True
+ return False
+ if not k:
+ return False
+ if head == "*" or head == k[0]:
+ return _match(rest, k[1:])
+ return False
+
+ return _match(parts, key_parts)
diff --git a/trex_core/adapters/messaging/rabbitmq.py b/trex_core/adapters/messaging/rabbitmq.py
new file mode 100644
index 0000000..95ef044
--- /dev/null
+++ b/trex_core/adapters/messaging/rabbitmq.py
@@ -0,0 +1,380 @@
+"""RabbitMQ (AMQP) transport adapter — pika BlockingConnection (REQ-022/023/024).
+
+pika is NOT thread-safe across channels/connections, so every consumer or
+publisher uses its own connection/channel. The adapter owns one connection
+for *its* thread; the daemon creates multiple adapter instances (one per
+consumer/publisher worker thread).
+
+Design highlights:
+ - Reconnect backoff (1s -> 2s -> 4s -> 8s -> 16s -> 30s cap), implemented
+ in the consume_*_forever loops. (pika has no built-in auto-reconnect.)
+ - Publisher confirms (`channel.confirm_delivery`) + mandatory=True so an
+ unroutable message NACKs via UnroutableError → DLQ.
+ - Manual ack only AFTER the handler returns its response. If the handler
+ raises, the message is NACKed with requeue=False so it goes to the DLQ
+ instead of poison-looping (REQ-023 AC-6).
+ - intent RPC consumer uses prefetch=1 (REQ-023 AC-3) for FIFO single-writer
+ alignment.
+"""
+from __future__ import annotations
+
+import json
+import logging
+import threading
+import time
+from typing import Optional
+
+import pika
+import pika.exceptions
+
+from trex_core.adapters.messaging.topology import (
+ EVENTS_DLQ_EXCHANGE,
+ EVENTS_DLQ_QUEUE,
+ EVENTS_EXCHANGE,
+ INTENT_REQ_QUEUE,
+ SNAPSHOT_REQ_QUEUE,
+ STRATEGY_QUEUE_ARGS,
+)
+from trex_core.application.messaging import (
+ EventHandler,
+ RpcHandler,
+ RpcRequest,
+ RpcTimeoutError,
+ TransportHealth,
+ TransportUnavailableError,
+)
+
+_log = logging.getLogger(__name__)
+
+_BACKOFF_SEQ = (1.0, 2.0, 4.0, 8.0, 16.0, 30.0)
+
+
+class RabbitMQTransport:
+ def __init__(
+ self,
+ url: str,
+ *,
+ timeout: float = 5.0,
+ intent_prefetch: int = 1,
+ snapshot_prefetch: int = 8,
+ ) -> None:
+ self._url = url
+ self._timeout = timeout
+ self._intent_prefetch = intent_prefetch
+ self._snapshot_prefetch = snapshot_prefetch
+ self._lock = threading.Lock()
+ self._conn: Optional[pika.BlockingConnection] = None
+ self._channel: Optional[pika.adapters.blocking_connection.BlockingChannel] = None
+ self._health = TransportHealth.DISCONNECTED
+
+ # ------------------------------------------------------------ lifecycle
+ def _connect(self) -> None:
+ params = pika.URLParameters(self._url)
+ params.socket_timeout = self._timeout
+ params.blocked_connection_timeout = self._timeout
+ params.heartbeat = 30
+ with self._lock:
+ self._health = TransportHealth.RECONNECTING
+ conn = pika.BlockingConnection(params)
+ ch = conn.channel()
+ ch.confirm_delivery() # publisher confirms (REQ-023 AC-6)
+ with self._lock:
+ self._conn = conn
+ self._channel = ch
+ self._health = TransportHealth.CONNECTED
+
+ def _ensure_connected(self) -> None:
+ with self._lock:
+ ok = (
+ self._conn is not None
+ and self._conn.is_open
+ and self._channel is not None
+ and self._channel.is_open
+ )
+ if not ok:
+ self._connect()
+
+ def close(self) -> None:
+ with self._lock:
+ ch, conn = self._channel, self._conn
+ self._channel = None
+ self._conn = None
+ self._health = TransportHealth.DISCONNECTED
+ try:
+ if ch is not None and ch.is_open:
+ ch.close()
+ except Exception: # noqa: BLE001
+ pass
+ try:
+ if conn is not None and conn.is_open:
+ conn.close()
+ except Exception: # noqa: BLE001
+ pass
+
+ def health(self) -> TransportHealth:
+ with self._lock:
+ return self._health
+
+ # ------------------------------------------------------------ topology
+ def declare_topology(self) -> None:
+ self._ensure_connected()
+ ch = self._channel
+ assert ch is not None
+ # Events topic + DLQ
+ ch.exchange_declare(EVENTS_EXCHANGE, exchange_type="topic", durable=True)
+ ch.exchange_declare(EVENTS_DLQ_EXCHANGE, exchange_type="fanout", durable=True)
+ ch.queue_declare(EVENTS_DLQ_QUEUE, durable=True)
+ ch.queue_bind(EVENTS_DLQ_QUEUE, EVENTS_DLQ_EXCHANGE)
+ # RPC queues (durable for intent + snapshot)
+ ch.queue_declare(
+ INTENT_REQ_QUEUE,
+ durable=True,
+ arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
+ )
+ ch.queue_declare(
+ SNAPSHOT_REQ_QUEUE,
+ durable=True,
+ arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
+ )
+
+ def declare_strategy_queue(self, queue: str, binding_pattern: str) -> None:
+ """Per-strategy durable queue (REQ-023 AC-4) bound to events exchange."""
+ self._ensure_connected()
+ ch = self._channel
+ assert ch is not None
+ ch.queue_declare(queue, durable=True, arguments=dict(STRATEGY_QUEUE_ARGS))
+ ch.queue_bind(queue, EVENTS_EXCHANGE, routing_key=binding_pattern)
+
+ # ------------------------------------------------------------ publish
+ def publish_event(
+ self,
+ routing_key: str,
+ payload: dict,
+ *,
+ mandatory: bool = True,
+ ) -> None:
+ body = json.dumps(payload).encode("utf-8")
+ try:
+ self._ensure_connected()
+ ch = self._channel
+ assert ch is not None
+ ch.basic_publish(
+ exchange=EVENTS_EXCHANGE,
+ routing_key=routing_key,
+ body=body,
+ properties=pika.BasicProperties(
+ content_type="application/json",
+ delivery_mode=2, # persistent
+ ),
+ mandatory=mandatory,
+ )
+ except pika.exceptions.UnroutableError:
+ # No matching queue subscribers → push to DLQ collector (REQ-023 AC-6).
+ self._publish_dlq(routing_key, payload, reason="unroutable")
+ except (pika.exceptions.AMQPError, OSError) as exc:
+ self._mark_disconnected()
+ raise TransportUnavailableError(
+ f"publish_event failed: {exc.__class__.__name__}: {exc}"
+ ) from exc
+
+ def _publish_dlq(self, routing_key: str, payload: dict, *, reason: str) -> None:
+ try:
+ self._ensure_connected()
+ ch = self._channel
+ assert ch is not None
+ dlq_body = json.dumps(
+ {"reason": reason, "original_routing_key": routing_key, "payload": payload}
+ ).encode("utf-8")
+ ch.basic_publish(
+ exchange=EVENTS_DLQ_EXCHANGE,
+ routing_key="",
+ body=dlq_body,
+ properties=pika.BasicProperties(
+ content_type="application/json", delivery_mode=2
+ ),
+ )
+ except Exception: # noqa: BLE001 - DLQ best-effort
+ _log.warning("DLQ publish failed", exc_info=True)
+
+ # ------------------------------------------------------------ RPC client
+ def call_rpc(
+ self,
+ queue: str,
+ payload: dict,
+ *,
+ correlation_id: str,
+ timeout: float,
+ ) -> dict:
+ try:
+ self._ensure_connected()
+ except (pika.exceptions.AMQPError, OSError) as exc:
+ self._mark_disconnected()
+ raise TransportUnavailableError(f"call_rpc connect failed: {exc}") from exc
+
+ # We open a dedicated short-lived channel for this RPC to keep the
+ # caller-thread reply isolated (pika BlockingConnection requires
+ # consume from same thread that owns the channel).
+ params = pika.URLParameters(self._url)
+ params.socket_timeout = self._timeout
+ try:
+ conn = pika.BlockingConnection(params)
+ except (pika.exceptions.AMQPError, OSError) as exc:
+ self._mark_disconnected()
+ raise TransportUnavailableError(f"call_rpc connect failed: {exc}") from exc
+
+ try:
+ ch = conn.channel()
+ reply_q = ch.queue_declare(queue="", exclusive=True, auto_delete=True).method.queue
+
+ holder: dict[str, dict] = {}
+
+ def on_reply(_ch, method, props, body):
+ if props.correlation_id == correlation_id:
+ holder["payload"] = json.loads(body)
+ _ch.basic_ack(delivery_tag=method.delivery_tag)
+ _ch.stop_consuming()
+
+ ch.basic_consume(queue=reply_q, on_message_callback=on_reply, auto_ack=False)
+ ch.basic_publish(
+ exchange="",
+ routing_key=queue,
+ body=json.dumps(payload).encode("utf-8"),
+ properties=pika.BasicProperties(
+ content_type="application/json",
+ delivery_mode=2,
+ correlation_id=correlation_id,
+ reply_to=reply_q,
+ ),
+ mandatory=True,
+ )
+ deadline = time.monotonic() + timeout
+ while "payload" not in holder and time.monotonic() < deadline:
+ conn.process_data_events(time_limit=min(0.2, deadline - time.monotonic()))
+ if "payload" not in holder:
+ raise RpcTimeoutError(
+ f"RPC to {queue} (correlation_id={correlation_id}) timed out after {timeout}s"
+ )
+ return holder["payload"]
+ finally:
+ try:
+ conn.close()
+ except Exception: # noqa: BLE001
+ pass
+
+ # ------------------------------------------------------------ RPC server
+ def consume_rpc_forever(
+ self,
+ queue: str,
+ handler: RpcHandler,
+ stop: threading.Event,
+ ) -> None:
+ prefetch = self._intent_prefetch if queue == INTENT_REQ_QUEUE else self._snapshot_prefetch
+ backoff_idx = 0
+ while not stop.is_set():
+ try:
+ self._ensure_connected()
+ ch = self._channel
+ assert ch is not None
+ ch.basic_qos(prefetch_count=prefetch)
+ # Declare in case adapter restarted before daemon-level declare.
+ ch.queue_declare(
+ queue,
+ durable=True,
+ arguments={"x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE},
+ )
+
+ def on_message(_ch, method, props, body):
+ try:
+ payload = json.loads(body) if body else {}
+ req = RpcRequest(
+ payload=payload,
+ correlation_id=props.correlation_id or "",
+ reply_to=props.reply_to,
+ properties={"headers": props.headers or {}},
+ )
+ resp = handler(req)
+ if props.reply_to:
+ _ch.basic_publish(
+ exchange="",
+ routing_key=props.reply_to,
+ body=json.dumps(resp.payload).encode("utf-8"),
+ properties=pika.BasicProperties(
+ content_type="application/json",
+ correlation_id=props.correlation_id,
+ ),
+ )
+ _ch.basic_ack(delivery_tag=method.delivery_tag)
+ except Exception: # noqa: BLE001
+ # Handler failure: NACK without requeue -> DLQ (REQ-023 AC-6)
+ _log.exception("RPC handler raised; routing to DLQ")
+ try:
+ _ch.basic_nack(delivery_tag=method.delivery_tag, requeue=False)
+ except Exception: # noqa: BLE001
+ pass
+
+ ch.basic_consume(queue=queue, on_message_callback=on_message, auto_ack=False)
+ backoff_idx = 0
+ while not stop.is_set() and ch.is_open:
+ self._conn.process_data_events(time_limit=0.2)
+ try:
+ ch.stop_consuming()
+ except Exception: # noqa: BLE001
+ pass
+ except (pika.exceptions.AMQPError, OSError) as exc:
+ _log.warning("RPC consumer reconnecting: %s", exc)
+ self._mark_disconnected()
+ self._sleep_backoff(stop, backoff_idx)
+ backoff_idx = min(backoff_idx + 1, len(_BACKOFF_SEQ) - 1)
+
+ # ------------------------------------------------------------ Events
+ def consume_events_forever(
+ self,
+ queue: str,
+ binding_pattern: str,
+ handler: EventHandler,
+ stop: threading.Event,
+ ) -> None:
+ backoff_idx = 0
+ while not stop.is_set():
+ try:
+ self._ensure_connected()
+ self.declare_strategy_queue(queue, binding_pattern)
+ ch = self._channel
+ assert ch is not None
+
+ def on_message(_ch, method, props, body):
+ try:
+ payload = json.loads(body) if body else {}
+ handler(method.routing_key, payload)
+ _ch.basic_ack(delivery_tag=method.delivery_tag)
+ except Exception: # noqa: BLE001
+ _log.exception("event handler raised; routing to DLQ")
+ try:
+ _ch.basic_nack(delivery_tag=method.delivery_tag, requeue=False)
+ except Exception: # noqa: BLE001
+ pass
+
+ ch.basic_consume(queue=queue, on_message_callback=on_message, auto_ack=False)
+ backoff_idx = 0
+ while not stop.is_set() and ch.is_open:
+ self._conn.process_data_events(time_limit=0.2)
+ try:
+ ch.stop_consuming()
+ except Exception: # noqa: BLE001
+ pass
+ except (pika.exceptions.AMQPError, OSError) as exc:
+ _log.warning("event consumer reconnecting: %s", exc)
+ self._mark_disconnected()
+ self._sleep_backoff(stop, backoff_idx)
+ backoff_idx = min(backoff_idx + 1, len(_BACKOFF_SEQ) - 1)
+
+ # ------------------------------------------------------------ helpers
+ def _mark_disconnected(self) -> None:
+ with self._lock:
+ self._health = TransportHealth.DISCONNECTED
+ self._conn = None
+ self._channel = None
+
+ def _sleep_backoff(self, stop: threading.Event, idx: int) -> None:
+ delay = _BACKOFF_SEQ[min(idx, len(_BACKOFF_SEQ) - 1)]
+ stop.wait(delay)
diff --git a/trex_core/adapters/messaging/topology.py b/trex_core/adapters/messaging/topology.py
new file mode 100644
index 0000000..6d00b71
--- /dev/null
+++ b/trex_core/adapters/messaging/topology.py
@@ -0,0 +1,51 @@
+"""Messaging topology constants + builders (REQ-021, dcy-006 OQ-2).
+
+Three patterns:
+ 1. snapshot RPC — direct queue `trex.snapshot.req`, reply via amq.rabbitmq.reply-to
+ 2. intent RPC — direct queue `trex.intent.req`, reply via amq.rabbitmq.reply-to
+ 3. events — topic exchange `trex.events`, routing key {event_type}.{strategy_id}.{symbol}
+
+Mapping principle: requests carry view/strategy_id in *payload*; events carry
+strategy_id/symbol in the *routing key* so brokers can filter per-strategy
+queues with patterns like `*.{strategy_id}.#`.
+"""
+from __future__ import annotations
+
+# --- RPC queues (durable for intent; transient-ish for snapshot but kept
+# durable for simplicity since the queue itself is shared) ---
+SNAPSHOT_REQ_QUEUE = "trex.snapshot.req"
+INTENT_REQ_QUEUE = "trex.intent.req"
+
+# --- Events ---
+EVENTS_EXCHANGE = "trex.events" # topic, durable
+EVENTS_DLQ_EXCHANGE = "trex.events.dlq" # fanout, durable; receives unroutable/NACKed
+EVENTS_DLQ_QUEUE = "trex.events.dlq" # one collector queue bound to DLQ exchange
+
+
+def event_routing_key(event_type: str, strategy_id: str, symbol: str) -> str:
+ """Build the routing key for an event (dcy-006 OQ-2 mapping)."""
+ # Sanitize tokens — AMQP routing keys cannot contain '.', '*', '#'.
+ safe = lambda s: str(s or "_").replace(".", "_").replace("*", "_").replace("#", "_") # noqa: E731
+ return f"{safe(event_type)}.{safe(strategy_id)}.{safe(symbol)}"
+
+
+def strategy_event_queue_name(strategy_id: str) -> str:
+ """Per-strategy durable queue name (catch-up + last-wins)."""
+ return f"trex.events.strategy.{strategy_id}"
+
+
+def strategy_event_binding_pattern(strategy_id: str) -> str:
+ """Bind pattern for a strategy queue — all event types, all symbols.
+
+ Wildcards: `*` matches one word, `#` matches zero-or-more words.
+ """
+ return f"*.{strategy_id}.#"
+
+
+# --- per-queue arguments (REQ-023 TTL / max-length / drop-oldest) ---
+STRATEGY_QUEUE_ARGS: dict = {
+ "x-message-ttl": 3_600_000, # 1h
+ "x-max-length": 10_000,
+ "x-overflow": "drop-head", # drop-oldest, then accept new (REQ-023 AC-7)
+ "x-dead-letter-exchange": EVENTS_DLQ_EXCHANGE,
+}
diff --git a/trex_core/application/execution.py b/trex_core/application/execution.py
index b376de0..e815d6a 100644
--- a/trex_core/application/execution.py
+++ b/trex_core/application/execution.py
@@ -20,13 +20,19 @@ from __future__ import annotations
from dataclasses import dataclass
from datetime import datetime, timezone
-from typing import Optional
+from typing import Callable, Optional
from trex_core.application.broker_port import BrokerPort, OrderRequest
from trex_core.application.ledger_outbox import LedgerOutbox
from trex_core.application.ledger_port import LedgerTrade
from trex_core.domain.slot import SlotService, SlotState, SlotStateMismatchError
+# REQ-021/023: event emission hook. Runtime wires a callable that publishes
+# slot transition events through MessagingTransport. Application layer stays
+# transport-agnostic (NFR-1). Slot type is duck-typed to keep the application
+# layer free of domain re-imports (the slot is just used for attribute access).
+SlotEventEmitter = Callable[[str, object], None] # (event_type, slot) -> None
+
_MAX_DISPATCH_PER_TICK = 64
@@ -46,11 +52,13 @@ class ExecutionService:
repo,
broker: BrokerPort,
ledger_outbox: Optional[LedgerOutbox] = None,
+ event_emitter: Optional[SlotEventEmitter] = None,
) -> None:
self._svc = slot_service
self._repo = repo
self._broker = broker
self._ledger_outbox = ledger_outbox
+ self._event_emitter = event_emitter
# ------------------------------------------------------------
def run_once(self) -> ExecutionResult:
@@ -112,23 +120,36 @@ class ExecutionService:
broker_order_id = slot.broker_order_id # captured BEFORE clear_dispatch
try:
if slot.status is SlotState.PENDING_BUY:
- self._svc.transit_slot(
+ updated = self._svc.transit_slot(
slot.slot_id, SlotState.PENDING_BUY, SlotState.HOLDING,
reason="buy_filled", actor="execution_loop",
avg_price=fs.avg_price, qty=float(fs.filled_qty) or slot.qty,
)
+ event_type = "slot_filled_buy"
else: # PENDING_SELL
- self._svc.transit_slot(
+ updated = self._svc.transit_slot(
slot.slot_id, SlotState.PENDING_SELL, SlotState.CLOSED,
reason="sell_filled", actor="execution_loop",
)
+ event_type = "slot_filled_sell"
except SlotStateMismatchError:
return # slot moved concurrently; next tick reconciles
# REQ-018: enqueue ledger work item AFTER the slot transition is durable.
# Slot transition is the critical path; ledger write is async (REQ-019).
self._record_ledger(slot, fs, side, broker_order_id, r)
+ # REQ-021/023: emit event AFTER transition + ledger enqueue (single
+ # record subject). Best-effort: a publish failure must not roll back.
+ self._emit_event(event_type, updated)
self._repo.clear_dispatch(slot.slot_id) # done with this order
+ def _emit_event(self, event_type: str, slot) -> None:
+ if self._event_emitter is None:
+ return
+ try:
+ self._event_emitter(event_type, slot)
+ except Exception: # noqa: BLE001 - event publish failure is non-critical
+ return
+
def _record_ledger(self, slot, fs, side: str, broker_order_id: str, r: ExecutionResult) -> None:
"""Append a LedgerWorkItem for the just-filled trade (REQ-018 + REQ-019)."""
if self._ledger_outbox is None:
diff --git a/trex_core/application/messaging.py b/trex_core/application/messaging.py
new file mode 100644
index 0000000..6debcab
--- /dev/null
+++ b/trex_core/application/messaging.py
@@ -0,0 +1,121 @@
+"""Messaging transport port + DTOs (REQ-021, REQ-022, dcy-006).
+
+Application-layer contract for trex-core ↔ 전략 모듈 통신. Domain stays
+free of AMQP / pika dependencies (NFR-1); concrete adapters live in
+trex_core.adapters.messaging.
+
+Three patterns (dcy-006 OQ-2):
+ 1. snapshot RPC (request-reply) — read-only, transient.
+ 2. intent admission RPC (request-reply) — durable, correlation_id dedup.
+ 3. event pub/sub — topic exchange, per-strategy queue, last-wins.
+
+Request payloads carry view/strategy_id in the message body; events carry
+strategy_id/symbol in the routing key (REQ-021 mapping principle).
+"""
+from __future__ import annotations
+
+import threading
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import Any, Callable, Optional, Protocol
+
+
+class TransportHealth(str, Enum):
+ """Connection state exposed to application for degrade branches (REQ-024)."""
+ CONNECTED = "connected"
+ DISCONNECTED = "disconnected"
+ RECONNECTING = "reconnecting"
+
+
+@dataclass(frozen=True)
+class RpcRequest:
+ """Inbound RPC message handed to a consumer handler."""
+ payload: dict
+ correlation_id: str
+ reply_to: Optional[str] = None
+ properties: dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass(frozen=True)
+class RpcResponse:
+ """Outbound RPC response returned from a consumer handler."""
+ payload: dict
+
+
+class TransportError(Exception):
+ """Base class for messaging transport failures."""
+
+
+class TransportUnavailableError(TransportError):
+ """Raised when transport.health() is not CONNECTED and the caller
+ cannot proceed (REQ-024: no local buffering, conservative halt)."""
+
+
+class RpcTimeoutError(TransportError):
+ """RPC reply not received within the configured timeout."""
+
+
+# Type aliases for handlers
+RpcHandler = Callable[[RpcRequest], RpcResponse]
+EventHandler = Callable[[str, dict], None] # (routing_key, payload)
+
+
+class MessagingTransport(Protocol):
+ """Transport boundary for messaging-based communication (REQ-022)."""
+
+ def declare_topology(self) -> None:
+ """Declare exchanges, queues, bindings (REQ-021)."""
+ ...
+
+ def publish_event(
+ self,
+ routing_key: str,
+ payload: dict,
+ *,
+ mandatory: bool = True,
+ ) -> None:
+ """Publish to the events topic exchange. Uses publisher confirms;
+ unroutable or NACKed messages are routed to the DLQ (REQ-023).
+ Raises TransportUnavailableError if not connected."""
+ ...
+
+ def call_rpc(
+ self,
+ queue: str,
+ payload: dict,
+ *,
+ correlation_id: str,
+ timeout: float,
+ ) -> dict:
+ """Client-side RPC: publish to `queue`, wait for reply.
+ Raises RpcTimeoutError on timeout, TransportUnavailableError on outage."""
+ ...
+
+ def consume_rpc_forever(
+ self,
+ queue: str,
+ handler: RpcHandler,
+ stop: threading.Event,
+ ) -> None:
+ """Server-side RPC consumption. Blocks until `stop` is set.
+ Auto-reconnects on connection drop (REQ-022 AC-4)."""
+ ...
+
+ def consume_events_forever(
+ self,
+ queue: str,
+ binding_pattern: str,
+ handler: EventHandler,
+ stop: threading.Event,
+ ) -> None:
+ """Subscribe to events matching `binding_pattern` on the events
+ exchange, dispatch to handler. Blocks until `stop` is set."""
+ ...
+
+ def health(self) -> TransportHealth:
+ """Current connection state (REQ-024)."""
+ ...
+
+ def close(self) -> None:
+ """Release connection resources."""
+ ...
diff --git a/trex_core/application/messaging_handlers.py b/trex_core/application/messaging_handlers.py
new file mode 100644
index 0000000..7717b48
--- /dev/null
+++ b/trex_core/application/messaging_handlers.py
@@ -0,0 +1,201 @@
+"""RPC handlers + event payload builders for messaging transport (REQ-021/022).
+
+Handlers are transport-agnostic: they accept a parsed `RpcRequest` payload
+and return an `RpcResponse`. Wiring them onto `MessagingTransport.consume_*`
+happens in the runtime layer.
+"""
+from __future__ import annotations
+
+import logging
+from datetime import date as date_cls
+from datetime import datetime, timezone
+from typing import Optional
+from uuid import UUID
+
+from trex_core.application.intents import BuyIntent, IntentService, SellIntent
+from trex_core.application.messaging import RpcRequest, RpcResponse
+from trex_core.domain.slot import SlotRepository, SlotService
+
+_log = logging.getLogger(__name__)
+
+
+# ---- intent RPC handler -----------------------------------------------------
+
+def make_intent_rpc_handler(intent_service: IntentService):
+ """Build the RPC handler for `trex.intent.req`.
+
+ Payload shape:
+ {
+ "intent_type": "buy" | "sell",
+ "intent_id": "",
+ ... fields per BuyIntent / SellIntent ...
+ }
+
+ Response shape:
+ {"intent_id": str, "status": "admitted"|"rejected", "slot_id": str|None, "reason": str|None}
+
+ Dedup uses `intent_log.try_insert(intent_id, ...)` (REQ-007 gate). The
+ request's `correlation_id` is reused as `intent_id` so the messaging
+ layer and the application share a single idempotency source of truth
+ (REQ-023 AC-1).
+ """
+
+ def handler(req: RpcRequest) -> RpcResponse:
+ body = req.payload or {}
+ intent_id = str(body.get("intent_id") or req.correlation_id)
+ intent_type = str(body.get("intent_type") or "").lower()
+ try:
+ if intent_type == "buy":
+ buy = BuyIntent(
+ intent_id=intent_id,
+ trading_date=_parse_date(body.get("trading_date")),
+ symbol=str(body.get("symbol") or ""),
+ qty=_opt_float(body.get("qty")),
+ allocated_capital=_opt_float(body.get("allocated_capital")),
+ entry_price=_opt_float(body.get("entry_price")),
+ strategy_id=_opt_str(body.get("strategy_id")),
+ sell_strategy_id=_opt_str(body.get("sell_strategy_id")),
+ portfolio_id=_opt_str(body.get("portfolio_id")),
+ forced_close_at=_opt_dt(body.get("forced_close_at")),
+ )
+ d = intent_service.submit_buy(buy)
+ elif intent_type == "sell":
+ sell = SellIntent(
+ intent_id=intent_id,
+ slot_id=UUID(str(body["slot_id"])),
+ reason=str(body.get("reason") or "discretionary_sell"),
+ sell_strategy_id=_opt_str(body.get("sell_strategy_id")),
+ )
+ d = intent_service.submit_sell(sell)
+ else:
+ return RpcResponse(payload={
+ "intent_id": intent_id, "status": "rejected",
+ "slot_id": None, "reason": f"unknown_intent_type:{intent_type}",
+ })
+ except (KeyError, ValueError) as exc:
+ return RpcResponse(payload={
+ "intent_id": intent_id, "status": "rejected",
+ "slot_id": None, "reason": f"bad_request:{exc}",
+ })
+ return RpcResponse(payload={
+ "intent_id": d.intent_id,
+ "status": d.status,
+ "slot_id": (str(d.slot_id) if d.slot_id else None),
+ "reason": d.reason,
+ })
+
+ return handler
+
+
+# ---- snapshot RPC handler ---------------------------------------------------
+
+def make_snapshot_rpc_handler(slot_repo: SlotRepository, slot_service: SlotService):
+ """Build the RPC handler for `trex.snapshot.req`.
+
+ Payload shape (stub for BAT-007 — dcy-005 logical contract is not yet
+ REQ-normalized; this returns a transport-shape evidence equivalent of
+ `GET /v1/slots` + `GET /v1/capacity`):
+ {
+ "strategy_id": "",
+ "view": "open" | "all" (default "all"),
+ "trading_date": "YYYY-MM-DD" (optional, default today UTC)
+ }
+ """
+
+ def handler(req: RpcRequest) -> RpcResponse:
+ body = req.payload or {}
+ view = str(body.get("view") or "all")
+ strategy_filter = _opt_str(body.get("strategy_id"))
+ day = _parse_date(body.get("trading_date")) if body.get("trading_date") else _today()
+ slots = slot_repo.list_slots(day)
+ if view == "open":
+ slots = [s for s in slots if s.status.value in ("pending_buy", "holding", "pending_sell")]
+ if strategy_filter is not None:
+ slots = [s for s in slots if s.strategy_id == strategy_filter]
+ cap = slot_service.compute_slot_capacity(day, max(1, len(slot_repo.list_slots(day))))
+ return RpcResponse(payload={
+ "view": view,
+ "strategy_id": strategy_filter,
+ "trading_date": day.isoformat(),
+ "slots": [_slot_to_dict(s) for s in slots],
+ "capacity": {
+ "idle_count": cap.idle_count,
+ "holding_count": cap.holding_count,
+ "pending_count": cap.pending_count,
+ "total_slots": cap.total_slots,
+ "scarcity_ratio": cap.scarcity_ratio,
+ },
+ })
+
+ return handler
+
+
+# ---- event payload builder --------------------------------------------------
+
+def slot_transition_event_payload(slot, *, event_type: str) -> dict:
+ """Build the event payload for a slot transition (REQ-023 AC-5).
+
+ Carries the *current state* + a monotonic sequence (`updated_at` iso) so
+ receivers can apply last-wins without ordering guarantees.
+ """
+ return {
+ "event_type": event_type,
+ "slot_id": str(slot.slot_id),
+ "strategy_id": slot.strategy_id,
+ "symbol": slot.symbol,
+ "status": slot.status.value,
+ "qty": float(slot.qty) if slot.qty is not None else None,
+ "avg_price": float(slot.avg_price) if slot.avg_price is not None else None,
+ "portfolio_id": slot.portfolio_id,
+ "trading_date": slot.trading_date.isoformat(),
+ "sequence_at": (slot.updated_at or datetime.now(tz=timezone.utc)).isoformat(),
+ }
+
+
+# ---- helpers ----------------------------------------------------------------
+
+def _opt_str(v) -> Optional[str]:
+ if v is None or v == "":
+ return None
+ return str(v)
+
+
+def _opt_float(v) -> Optional[float]:
+ if v is None:
+ return None
+ return float(v)
+
+
+def _opt_dt(v) -> Optional[datetime]:
+ if v is None:
+ return None
+ if isinstance(v, datetime):
+ return v
+ return datetime.fromisoformat(str(v))
+
+
+def _parse_date(v) -> date_cls:
+ if isinstance(v, date_cls):
+ return v
+ return date_cls.fromisoformat(str(v))
+
+
+def _today() -> date_cls:
+ return datetime.now(tz=timezone.utc).date()
+
+
+def _slot_to_dict(s) -> dict:
+ return {
+ "slot_id": str(s.slot_id),
+ "trading_date": s.trading_date.isoformat(),
+ "status": s.status.value,
+ "symbol": s.symbol,
+ "qty": float(s.qty) if s.qty is not None else None,
+ "avg_price": float(s.avg_price) if s.avg_price is not None else None,
+ "entry_price": float(s.entry_price) if s.entry_price is not None else None,
+ "allocated_capital": float(s.allocated_capital) if s.allocated_capital is not None else None,
+ "strategy_id": s.strategy_id,
+ "sell_strategy_id": s.sell_strategy_id,
+ "portfolio_id": s.portfolio_id,
+ "forced_close_at": s.forced_close_at.isoformat() if s.forced_close_at else None,
+ }
diff --git a/trex_core/runtime/config.py b/trex_core/runtime/config.py
index 18a088f..dae0e68 100644
--- a/trex_core/runtime/config.py
+++ b/trex_core/runtime/config.py
@@ -40,12 +40,18 @@ class PortfolioHubConfig:
timeout: float = 5.0
+@dataclass(frozen=True)
+class RabbitMQConfig:
+ """RabbitMQ transport adapter config (REQ-022, dcy-006 OQ-6)."""
+
+ url: str
+ timeout: float = 5.0
+
+
@dataclass(frozen=True)
class DaemonConfig:
dsn: str
total_slots: int
- host: str
- port: int
broker: str # 'paper' | 'kis'
execution_interval_sec: float
kis: Optional[KISConfig] = None
@@ -53,6 +59,9 @@ class DaemonConfig:
# appropriate for slice-1 paper-broker integration tests).
portfolio_hub: Optional[PortfolioHubConfig] = None
ledger_interval_sec: float = 1.0
+ # REQ-022 (BAT-007): RabbitMQ transport config. Required by the new
+ # sync+thread daemon — HTTP API has been removed (REQ-025).
+ rabbitmq: Optional[RabbitMQConfig] = None
@staticmethod
def from_env() -> "DaemonConfig":
@@ -82,14 +91,20 @@ class DaemonConfig:
token=os.environ.get("TREX_PORTFOLIO_HUB_TOKEN", "").strip(),
timeout=float(os.environ.get("TREX_PORTFOLIO_HUB_TIMEOUT", "5")),
)
+ rabbitmq: Optional[RabbitMQConfig] = None
+ mq_url = os.environ.get("TREX_RABBITMQ_URL", "").strip()
+ if mq_url:
+ rabbitmq = RabbitMQConfig(
+ url=mq_url,
+ timeout=float(os.environ.get("TREX_RABBITMQ_TIMEOUT", "5")),
+ )
return DaemonConfig(
dsn=dsn,
total_slots=int(os.environ.get("TREX_TOTAL_SLOTS", "10")),
- host=os.environ.get("TREX_API_HOST", "127.0.0.1"),
- port=int(os.environ.get("TREX_API_PORT", "8080")),
broker=broker,
execution_interval_sec=float(os.environ.get("TREX_EXECUTION_INTERVAL_SEC", "1.0")),
kis=kis,
portfolio_hub=portfolio_hub,
ledger_interval_sec=float(os.environ.get("TREX_LEDGER_INTERVAL_SEC", "1.0")),
+ rabbitmq=rabbitmq,
)
diff --git a/trex_core/runtime/daemon.py b/trex_core/runtime/daemon.py
index 3b9bd50..fa73707 100644
--- a/trex_core/runtime/daemon.py
+++ b/trex_core/runtime/daemon.py
@@ -1,22 +1,32 @@
-"""Slot-core daemon entrypoint (REQ-005, REQ-012/013/014).
+"""Slot-core daemon entrypoint (REQ-005, REQ-012/013/014, BAT-007).
-Builds the FastAPI app wired to PostgreSQL adapters + a broker (paper|KIS),
-applies migrations and preallocates slots on startup, runs a background
-execution loop (claim -> submit -> poll -> transition, with restart
-reconciliation), and serves the /v1 API via uvicorn.
+Sync + threaded runtime. HTTP `/v1` API has been removed (REQ-025); all
+strategy-facing communication runs over RabbitMQ (REQ-021/022/023).
+
+Threads (started in `run()`):
+ - intent RPC consumer — `trex.intent.req`, prefetch=1, FIFO, dedup via intent_log
+ - snapshot RPC consumer — `trex.snapshot.req`
+ - execution loop — broker dispatch + poll + slot transitions + event emit
+ - ledger writer — ledger outbox drain (REQ-019)
+
+Each consumer/publisher uses its OWN RabbitMQTransport instance because
+pika BlockingConnection is not thread-safe across channels.
Console script: `trex-core-daemon`.
"""
from __future__ import annotations
+import logging
+import signal
import threading
-from contextlib import asynccontextmanager
from datetime import datetime, timezone
-from fastapi import FastAPI
-
-from trex_core.adapters.api.app import create_app
from trex_core.adapters.broker.paper import PaperBroker
from trex_core.adapters.ledger import InMemoryLedger, PortfolioHubLedger
+from trex_core.adapters.messaging import (
+ InMemoryTransport,
+ RabbitMQTransport,
+ topology,
+)
from trex_core.adapters.persistence.migrate import apply_migrations
from trex_core.adapters.persistence.postgresql import (
PostgreSQLIntentStore,
@@ -28,9 +38,17 @@ from trex_core.application.execution import ExecutionService
from trex_core.application.intents import IntentService
from trex_core.application.ledger_outbox import LedgerWriter
from trex_core.application.ledger_port import LedgerPort
+from trex_core.application.messaging import MessagingTransport
+from trex_core.application.messaging_handlers import (
+ make_intent_rpc_handler,
+ make_snapshot_rpc_handler,
+ slot_transition_event_payload,
+)
from trex_core.domain.slot import SlotService
from trex_core.runtime.config import DaemonConfig
+_log = logging.getLogger(__name__)
+
def _build_broker(config: DaemonConfig) -> BrokerPort:
if config.broker == "kis":
@@ -58,67 +76,145 @@ def _build_ledger(config: DaemonConfig) -> LedgerPort:
return PortfolioHubLedger(pf.base_url, token=pf.token or None, timeout=pf.timeout)
-def build_app(config: DaemonConfig) -> FastAPI:
- slot_repo = PostgreSQLSlotRepository(config.dsn)
- intent_store = PostgreSQLIntentStore(config.dsn)
- slot_service = SlotService(slot_repo)
- intent_service = IntentService(slot_service, slot_repo, intent_store)
- broker = _build_broker(config)
- outbox = PostgreSQLLedgerOutbox(config.dsn)
- execution = ExecutionService(slot_service, slot_repo, broker, ledger_outbox=outbox)
- ledger_writer = LedgerWriter(outbox, _build_ledger(config))
+def _build_transport(config: DaemonConfig) -> MessagingTransport:
+ """RabbitMQ when configured; otherwise in-memory stub (REQ-022)."""
+ mq = config.rabbitmq
+ if mq is None:
+ # Stub: lets the daemon boot in environments without a broker (CI,
+ # local dev). REQ-024 degrade policy still applies — call_rpc raises.
+ return InMemoryTransport()
+ return RabbitMQTransport(mq.url, timeout=mq.timeout)
- base = create_app(
- slot_service=slot_service,
- slot_repo=slot_repo,
- intent_service=intent_service,
- default_total_slots=config.total_slots,
- )
- stop = threading.Event()
+class Daemon:
+ """Thread-orchestrating daemon (no HTTP)."""
- def _execution_loop() -> None:
- while not stop.wait(config.execution_interval_sec):
- try:
- execution.run_once()
- except Exception: # noqa: BLE001 - loop must survive transient errors
- continue
+ def __init__(self, config: DaemonConfig) -> None:
+ self.config = config
+ self.stop = threading.Event()
+ self._threads: list[threading.Thread] = []
+ self._transports: list[MessagingTransport] = []
- def _ledger_loop() -> None:
- while not stop.wait(config.ledger_interval_sec):
- try:
- ledger_writer.run_once()
- except Exception: # noqa: BLE001 - loop must survive transient errors
- continue
+ # Persistence + services
+ self.slot_repo = PostgreSQLSlotRepository(config.dsn)
+ self.intent_store = PostgreSQLIntentStore(config.dsn)
+ self.slot_service = SlotService(self.slot_repo)
+ self.intent_service = IntentService(self.slot_service, self.slot_repo, self.intent_store)
+ self.broker = _build_broker(config)
+ self.outbox = PostgreSQLLedgerOutbox(config.dsn)
+ self.ledger_writer = LedgerWriter(self.outbox, _build_ledger(config))
- @asynccontextmanager
- async def lifespan(_: FastAPI):
- apply_migrations(config.dsn)
- slot_service.preallocate_daily_slots(
- datetime.now(tz=timezone.utc).date(), config.total_slots
+ # Event publisher transport — one dedicated instance for the
+ # execution-loop thread (pika is not thread-safe).
+ self.event_publisher: MessagingTransport = _build_transport(config)
+ self._transports.append(self.event_publisher)
+
+ self.execution = ExecutionService(
+ self.slot_service, self.slot_repo, self.broker,
+ ledger_outbox=self.outbox,
+ event_emitter=self._make_event_emitter(),
)
- execution.reconcile() # restart recovery before serving (REQ-014)
- exec_worker = threading.Thread(target=_execution_loop, name="trex-execution", daemon=True)
- ledger_worker = threading.Thread(target=_ledger_loop, name="trex-ledger", daemon=True)
- exec_worker.start()
- ledger_worker.start()
- try:
- yield
- finally:
- stop.set()
- exec_worker.join(timeout=config.execution_interval_sec * 3)
- ledger_worker.join(timeout=config.ledger_interval_sec * 3)
- base.router.lifespan_context = lifespan
- return base
+ # ------------------------------------------------------------ event hook
+ def _make_event_emitter(self):
+ def emit(event_type: str, slot) -> None:
+ payload = slot_transition_event_payload(slot, event_type=event_type)
+ rk = topology.event_routing_key(
+ event_type, slot.strategy_id or "_", slot.symbol or "_",
+ )
+ try:
+ self.event_publisher.publish_event(rk, payload)
+ except Exception: # noqa: BLE001 - publish failure must not roll back
+ _log.warning("event publish failed (rk=%s)", rk, exc_info=True)
+ return emit
+
+ # ------------------------------------------------------------ workers
+ def _execution_loop(self) -> None:
+ while not self.stop.wait(self.config.execution_interval_sec):
+ try:
+ self.execution.run_once()
+ except Exception: # noqa: BLE001 - loop must survive transient errors
+ continue
+
+ def _ledger_loop(self) -> None:
+ while not self.stop.wait(self.config.ledger_interval_sec):
+ try:
+ self.ledger_writer.run_once()
+ except Exception: # noqa: BLE001
+ continue
+
+ def _intent_rpc_loop(self) -> None:
+ transport = _build_transport(self.config)
+ self._transports.append(transport)
+ try:
+ transport.declare_topology()
+ except Exception: # noqa: BLE001
+ pass
+ handler = make_intent_rpc_handler(self.intent_service)
+ transport.consume_rpc_forever(topology.INTENT_REQ_QUEUE, handler, self.stop)
+
+ def _snapshot_rpc_loop(self) -> None:
+ transport = _build_transport(self.config)
+ self._transports.append(transport)
+ try:
+ transport.declare_topology()
+ except Exception: # noqa: BLE001
+ pass
+ handler = make_snapshot_rpc_handler(self.slot_repo, self.slot_service)
+ transport.consume_rpc_forever(topology.SNAPSHOT_REQ_QUEUE, handler, self.stop)
+
+ # ------------------------------------------------------------ lifecycle
+ def setup(self) -> None:
+ apply_migrations(self.config.dsn)
+ self.slot_service.preallocate_daily_slots(
+ datetime.now(tz=timezone.utc).date(), self.config.total_slots
+ )
+ self.execution.reconcile() # REQ-014 restart recovery
+ try:
+ self.event_publisher.declare_topology()
+ except Exception: # noqa: BLE001
+ _log.warning("event publisher topology declare failed", exc_info=True)
+
+ def start(self) -> None:
+ workers = [
+ ("trex-execution", self._execution_loop),
+ ("trex-ledger", self._ledger_loop),
+ ("trex-intent-rpc", self._intent_rpc_loop),
+ ("trex-snapshot-rpc", self._snapshot_rpc_loop),
+ ]
+ for name, target in workers:
+ t = threading.Thread(target=target, name=name, daemon=True)
+ t.start()
+ self._threads.append(t)
+
+ def shutdown(self) -> None:
+ self.stop.set()
+ for t in self._threads:
+ t.join(
+ timeout=max(self.config.execution_interval_sec, self.config.ledger_interval_sec) * 3
+ )
+ for tr in self._transports:
+ try:
+ tr.close()
+ except Exception: # noqa: BLE001
+ pass
+
+ def run(self) -> None: # pragma: no cover - process entrypoint
+ self.setup()
+ self.start()
+ signal.signal(signal.SIGINT, lambda *_: self.stop.set())
+ signal.signal(signal.SIGTERM, lambda *_: self.stop.set())
+ try:
+ while not self.stop.is_set():
+ self.stop.wait(1.0)
+ finally:
+ self.shutdown()
def main() -> None: # pragma: no cover - process entrypoint
- import uvicorn
-
+ logging.basicConfig(level=logging.INFO)
config = DaemonConfig.from_env()
- app = build_app(config)
- uvicorn.run(app, host=config.host, port=config.port)
+ Daemon(config).run()
if __name__ == "__main__": # pragma: no cover