{"openapi":"3.0.3","info":{"title":"APICK 국제금리 조회","version":"1.0.0","description":"SOFR·ESTR·TONA 등 국제금리를 통화·기간별로 일자별로 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/intl_interest_rate":{"post":{"summary":"국제금리 조회","description":"SOFR·ESTR·TONA 등 국제금리를 통화·기간별로 일자별로 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"date":{"type":"string","description":"요청한 날짜 YYYY-MM-DD입니다."},"as_of_date":{"type":"string","description":"실제 고시일 YYYY-MM-DD입니다. 요청일이 주말·공휴일이면 직전 영업일입니다."},"count":{"type":"integer","description":"rates에 담긴 금리 개수입니다."},"rates":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"통화 코드입니다. 예: USD, EUR, JPY."},"term":{"type":"string","description":"기간 또는 금리 종류입니다. 예: SOFR 익일물, EURIBOR1개월, 3년."},"rate":{"type":"number","description":"그 기간의 금리(%)입니다."}}},"description":"통화·기간별 금리 목록입니다."},"success":{"type":"integer","description":"1이면 정상 조회입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0 입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"조회 일자 YYYYMMDD (예: 20261114). 생략하면 오늘 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"20261114"}}}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["조회 일자(date)는 YYYYMMDD 형식입니다. 예: 20261114","date 형식이 틀렸거나 1990년 이전입니다.","형식을 고쳐 다시 요청합니다."],["미래 날짜는 조회할 수 없습니다. …","오늘 이후 날짜를 보냈습니다.","오늘 또는 그 이전 날짜로 요청합니다."],["해당 일자의 국제금리 정보가 없습니다. …","그 날짜와 직전 영업일까지 금리가 없습니다.","영업일 기준으로 다시 요청합니다. 과금되지 않습니다."],["국제금리 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}