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

투자자격 한도 일괄 변경

PUT
/main/v1/invest-limits/qualification

📋 개요#

동일한 투자자격을 가진 여러 고객의 특정 발행사 신탁수익증권 투자 한도를 일괄적으로 변경하는 API입니다.

⚙️ 기능#

여러 고객 CI에 대해 동일한 투자자격 한도를 한 번에 적용
투자자격별 표준 한도 정책을 다수 고객에게 일괄 적용
변경된 고객 수와 개별 투자 한도 정보를 응답으로 반환
트랜잭션 기반 일괄 처리로 데이터 일관성 보장

🎯 사용 시나리오#

투자자격 정책 변경 시 해당 등급 고객들의 한도 일괄 조정
신규 발행사 상품 출시 시 고객 등급별 한도 설정
리스크 관리 정책 변경에 따른 대량 한도 조정
규제 변경에 따른 투자자격별 한도 재설정

⚠️ 주의사항#

요청된 CI 중 존재하지 않는 경우 전체 처리 실패
대량 처리이므로 시스템 부하 고려 필요
현재 투자 금액을 고려한 한도 설정 권장

Header Parameters#

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

Request Body#

필드설명타입
ciList*고객 CI 목록array
issuerCd*발행사 코드string
qualificationInvestLimitAmt*자격별 투자 한도 금액number

Success Response#

필드설명타입
updatedCount*업데이트된 건수number
updatedInvestLimits*업데이트된 투자 한도 목록array
↳ id*투자 한도 IDnumber
↳ ci*고객 CIstring
↳ totalInvestLimitAmt*총 투자 한도 금액number
↳ investAmt*투자 금액number
↳ remainInvestLimitAmt*잔여 투자 한도 금액number

Error Response#

코드상태메시지설명
I0010404요청된 CI 중 존재하지 않는 투자한도가 있습니다.요청된 CI 중 존재하지 않는 투자한도가 있습니다. CI 목록을 확인해주세요.

요청

헤더 파라미터

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

예시

응답

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

🟠404Record Not Found
요청요청 예시
Shell
JavaScript
Java
Swift
cURL
curl --location --request PUT '/main/v1/invest-limits/qualification' \
--header 'Authorization: Bearer access-token' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data '{
  "ciList" : [ "CI00000001", "CI00000002", "CI00000003" ],
  "issuerCd" : "ISSUER0001",
  "qualificationInvestLimitAmt" : 5000000
}'
응답응답 예시
200 - invest-limit-update-qualification
{
  "updatedCount" : 3,
  "updatedInvestLimits" : [ {
    "id" : 1,
    "ci" : "CI00000001",
    "totalInvestLimitAmt" : 5000000,
    "investAmt" : 2000000,
    "remainInvestLimitAmt" : 3000000
  }, {
    "id" : 2,
    "ci" : "CI00000002",
    "totalInvestLimitAmt" : 5000000,
    "investAmt" : 2000000,
    "remainInvestLimitAmt" : 3000000
  }, {
    "id" : 3,
    "ci" : "CI00000003",
    "totalInvestLimitAmt" : 5000000,
    "investAmt" : 2000000,
    "remainInvestLimitAmt" : 3000000
  } ]
}
수정일 2025-07-11 05:59:26
이전
투자 금액 변경
다음
투자 한도 조회
Built with