{"openapi":"3.0.3","info":{"title":"APICK 월평균·연평균 환율 조회","version":"1.0.0","description":"원화(KRW) 기준 주요 통화(미국 달러·엔·유로 등 50여 종)의 월평균 환율과 연평균 환율을 월 단위로 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/exchange_rate":{"post":{"summary":"월평균·연평균 환율 조회","description":"원화(KRW) 기준 주요 통화(미국 달러·엔·유로 등 50여 종)의 월평균 환율과 연평균 환율을 월 단위로 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"month":{"type":"string","description":"조회된 달 YYYY-MM입니다."},"base_currency":{"type":"string","description":"기준통화입니다. 항상 KRW입니다."},"count":{"type":"integer","description":"rates에 담긴 통화 수입니다."},"rates":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"통화 코드입니다. 예: USD, JPY."},"unit":{"type":"integer","description":"값이 나타내는 외화 단위입니다. JPY·IDR·VND는 100, 나머지는 1입니다."},"monthly_average":{"type":"number","description":"그 달의 월평균 환율(외화 unit단위당 원화)입니다."},"yearly_average":{"type":"number","description":"그 해의 연평균 환율입니다. 올해는 1월부터 조회 월까지의 평균이고, 지난 해는 연간 평균입니다. 값이 없으면 null입니다.","nullable":true}}},"description":"통화별 환율 목록입니다."},"missing_currencies":{"type":"array","items":{},"description":"currency를 보냈을 때만 옵니다. 보낸 코드 가운데 정보가 없는 통화입니다."},"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":{"month":{"type":"string","description":"조회 월 YYYYMM (예: 202609). 생략하면 지난달. 이번 달 이후는 조회 불가 (string)","example":"202609"},"currency":{"type":"string","description":"통화 코드를 쉼표로 구분 (예: USD,JPY,EUR). 생략하면 전체 통화 (string)","example":"USD,JPY,EUR"}}}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["조회 월(month)은 YYYYMM 형식입니다. 예: 202609","month 형식이 틀렸거나 1990년 이전입니다.","형식을 고쳐 다시 요청합니다."],["이번 달과 이후 달은 아직 월평균이 집계되지 않았습니다. 지난달까지 조회할 수 있습니다.","이번 달이나 미래 달을 보냈습니다.","지난달 이전으로 요청합니다."],["통화 코드(currency)가 올바르지 않습니다. …","영문 3자리가 아닌 코드가 있습니다.","USD,JPY처럼 고쳐 보냅니다."],["통화 코드는 한 번에 60개까지 보낼 수 있습니다.","통화 코드가 60개를 넘었습니다.","나눠서 요청하거나 currency를 생략해 전체를 받습니다."],["해당 월의 환율 정보가 없습니다.","그 달의 환율이 없습니다.","다른 달로 요청합니다. 과금되지 않습니다."],["요청한 통화의 환율 정보가 없습니다.","보낸 통화가 모두 목록에 없습니다.","currency를 생략해 지원 통화를 확인합니다. 과금되지 않습니다."],["환율 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}