PULSE Developer Center
GuidesAPI Reference
GuidesAPI Reference
  1. Invest_Limit
  • Invest_Limit
    • 투자 한도 생성
      POST
    • 투자 금액 변경
      PUT
    • 투자자격 한도 일괄 변경
      PUT
    • 투자 한도 조회
      POST
    • 총 투자 한도 변경
      PUT
    • 투자 한도 변경
      PUT
    • 투자 금액 감소
      POST
    • 투자 금액 증가
      POST
  • KYC
    • 지갑 주소 KYC 등록
      POST
    • 지갑 주소 KYC 해제
      DELETE
    • KYC 지갑 주소 확인
      GET
  • Operator-Transaction
    • 트랜잭션 전송
      POST
  • Operator-Transfer
    • 토큰 전송 가능 여부 확인
      GET
    • 토큰 전송 트랜잭션 데이터 생성
      POST
    • 토큰 파티션간 전송 트랜잭션 데이터 생성
      POST
  • Operator
    • 오퍼레이터 키 목록 조회
      GET
    • 오퍼레이터 키 확인
      GET
  • Operator-Redeem
    • 토큰 환수 트랜잭션 데이터 생성
      POST
  • Token
    • 토큰 기본 파티션 목록 조회
      GET
    • 토큰 기본 파티션 설정
      PUT
    • 토큰 정보 조회
      GET
    • 토큰 발행 가능여부 확인
      GET
    • 토큰 발행
      POST
    • 토큰 파티션 목록 조회
      GET
    • 토큰 파티션 수정
      PUT
    • 토큰 파티션 생성
      POST
    • 토큰 환수
      POST
    • 토큰 추가 발행 제한
      PUT
    • 토큰 파티션 총 공급량 조회
      GET
  • Token Document
    • 토큰 문서 목록 조회
    • 토큰 문서 등록
    • 토큰 문서 조회
    • 토큰 문서 삭제
  • Token Holder
    • 토큰 보유자 토큰 잔액 조회
    • 토큰 보유자 파티션 목록 조회
    • 토큰 보유자 특정 파티션 잔액 조회
    • 토큰 보유자 특정 파티션 잠긴 잔액 조회
  • Operator-Swap
    • DT 토큰 전송 주문 트랜잭션 데이터 생성
    • ST 토큰 전송 주문 트랜잭션 데이터 생성
  • Token Lock
    • 토큰 잠금 트랜잭션 데이터 생성
    • 토큰 잠금 해제 트랜잭션 데이터 생성
  1. Invest_Limit

투자 금액 감소

POST
/main/v1/invest-limits/invest-amount/decrement

📋 개요#

고객의 특정 발행사 신탁수익증권에 대한 투자 금액을 지정된 금액만큼 감소시키는 API입니다.

⚙️ 기능#

현재 투자 금액에서 요청된 금액을 차감
투자 금액 부족 여부 자동 검증
잔여 투자 가능 금액 자동 재계산 (한도 복원)
투자 취소/환매와 연동된 실시간 한도 복원

🎯 사용 시나리오#

고객의 신탁수익증권 투자 취소 시
부분 환매 시 해당 금액만큼 투자 금액 감소
투자 오류 정정 시 잘못 증가된 금액 롤백
투자 한도 복원이 필요한 경우

⚠️ 주의사항#

현재 투자 금액보다 큰 금액으로는 감소 불가
음수 금액으로는 감소 불가 (증가 API 사용 필요)
투자 금액이 0 미만으로 떨어질 수 없음

Header Parameters#

Name설명타입
Authorization*액세스 토큰string

Request Body#

필드설명타입
ci*고객 CIstring
issuerCd*발행사 코드string
amount*감소시킬 투자 금액number

Success Response#

필드설명타입
id*투자 한도 IDnumber
ci*고객 CIstring
totalInvestLimitAmt*총 투자 한도 금액number
investAmt*투자 금액number
remainInvestLimitAmt*잔여 투자 한도 금액number

Error Response#

코드상태메시지설명
I0001404투자한도를 찾을 수 없습니다.투자한도 정보를 찾을 수 없습니다. CI를 확인해주세요.
I0012400투자 금액이 부족하여 감소할 수 없습니다.현재 투자 금액이 부족하여 감소할 수 없습니다. 감소할 금액을 확인해주세요.

요청

헤더 파라미터

본문 파라미터application/json;charset=UTF-8

예시

응답

🟢200OK
application/json;charset=UTF-8
200
본문application/json;charset=UTF-8

🟠400Bad Request
🟠404Record Not Found
요청요청 예시
Shell
JavaScript
Java
Swift
cURL
curl --location '/main/v1/invest-limits/invest-amount/decrement' \
--header 'Authorization: Bearer access-token' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data '{
  "ci" : "CI00000001",
  "issuerCd" : "ISSUER0001",
  "amount" : 50000
}'
응답응답 예시
200 - invest-limit-decrement-invest-amount
{
  "id" : 1,
  "ci" : "CI00000001",
  "totalInvestLimitAmt" : 1000000,
  "investAmt" : 150000,
  "remainInvestLimitAmt" : 850000
}
수정일 2025-07-11 05:59:26
이전
투자 한도 변경
다음
투자 금액 증가
Built with