Bank

은행, 증권사, 금융결제원 관련 서비스를 제공합니다.

금융결제원 은행 표준코드/명 조회 서비스
금융결제원의 은행,증권사 등 금융기관의 표준코드와 기관명 리스트를 리턴합니다.
End Point Method Parameter
/v1/bank/inquiry/standard-info GET Query

Response
필드 설명 타입
bank_code 은행코드 String
bank_name 은행명 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": [
    {
      "bank_code": "001",
      "bank_name": "한국은행"
    },
    {
      "bank_code": "002",
      "bank_name": "산업은행"
    },
    {
      "bank_code": "003",
      "bank_name": "기업은행"
    },
# ...
  ]
}
                    
예금주 조회 서비스
은행코드와 은행계좌번호가 존재할 경우 계좌의 예금주를 리턴합니다
End Point Method Parameter
/v1/bank/inquiry/holder POST Json

Request Parameters
필드 설명 타입
bank_code 은행코드 String
bank_account_number 계좌번호 String

Response
필드 설명 타입
bank_account_holder 예금주명 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body" : {
    "bank_account_holder": "홍길동"
  }
}
                    
통화코드 조회 서비스
환전조회를 위한 통화코드를 제공합니다.
End Point Method Parameter
/v1/bank/inquiry/currency-codes GET Query

Response
필드 설명 타입
code 통화코드 String
name 통화명 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "total_count": 184,
  "body": [
    {
      "code": "KRW",
      "name": "South Korean Won"
    },
    {
      "code": "USD",
      "name": "US Dollar"
    },
    {
      "code": "EUR",
      "name": "Euro"
    },
    {
      "code": "GBP",
      "name": "British Pound"
    },
    {
      "code": "CAD",
      "name": "Canadian Dollor"
    },
#...
   }
}
                    
환전 조회 서비스
두 통화간 최신 환전정보를 제공합니다.(xe.com)
End Point Method Parameter
/v1/bank/inquiry/currency-convert GET Query

Request Parameters
필드 설명 타입
amount 금액 String
from_currency from통화코드 String
to_currency to통화코드 String

Response
필드 설명 타입
amount 요청금액 String
calculated_amount 계산된금액 String
one_from_currency 1 from통화 대한 to통화 금액 String
one_to_currency 1 to통화 대한 from통화 금액 String
last_updated 제공처에서 계산한 시각(UTC) String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body" : {
    "amount": "1500",
    "calculated_amount": "1.5027094 Singapore Dollars",
    "one_from_currency": "1 KRW = 0.00100181 SGD",
    "one_to_currency_": "1 SGD = 998.197 KRW",
    "last_updated": "May 11, 2023, 04:24 UTC"
  }
}
                    
환율 조회 서비스
환율정보를 제공합니다.(한국수출입은행)
End Point Method Parameter
/v1/bank/inquiry/exchange-rate GET Query

Request Parameters
필드 설명 타입
search_date 조회일 String
lang 필드언어(en : 영어, ko : 한국어) String

Response
필드 설명 타입
result 조회결과 NumberString
tts 전신환(송금)보내실때 String
ttb 전신환(송금)받으실때 String
ten_dd_efee_r 10일환가료율 String
cur_unit 제공처에서 계산한 시각(UTC) String
cur_unit 통화코드 String
bkpr 장부가격 String
deal_bas_r 매매기준율 String
cur_nm 국가/통화명 String
kftc_bkpr 서울외국환중개장부가격 String
yy_efee_r 년환가료율 String
kftc_deal_bas_r 서울외국환중개매매기준율 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 23,
    "list": [
      {
        "result": 1,
        "tts": "358.82",
        "ttb": "351.71",
        "ten_dd_efee_r": "0",
        "cur_unit": "AED",
        "bkpr": "355",
        "deal_bas_r": "355.27",
        "cur_nm": "아랍에미리트 디르함",
        "kftc_bkpr": "355",
        "yy_efee_r": "0",
        "kftc_deal_bas_r": "355.27"
      },
      {
        "result": 1,
        "tts": "881.9",
        "ttb": "864.43",
        "ten_dd_efee_r": "0",
        "cur_unit": "AUD",
        "bkpr": "873",
        "deal_bas_r": "873.17",
        "cur_nm": "호주 달러",
        "kftc_bkpr": "873",
        "yy_efee_r": "0",
        "kftc_deal_bas_r": "873.17"
      },
      #...
    ]
  }
}