API 레퍼런스
로그인
본문으로 건너뛰기

오늘 환율

오늘의 고정 원화 환율과 프리셋 결제 금액(부가세 포함)을 돌려줍니다

GET /v1/fx-rates/today

인증

방식허용조건
API 키 (Authorization: Bearer xci_live_…)불가콘솔 세션 전용, 키로 부르면 403 console_only
콘솔 세션 쿠키가능조직 역할 owner, admin, developer

참고 서버 구현(2026-10-12 dev 기준)이 계약 초안과 다른 점

  • 핸들러는 server/ci/runner2-topup-routes.js에 있지만 아직 앱에 마운트되지 않았습니다, 지금 호출하면 404 not_found입니다, 콘솔의 크레딧 구매 모달이 이 라우터를 기다립니다

응답

200

필드타입항상설명
daydate항상환율이 고정된 KST 영업일
base_krw_per_usdstring항상고시 매매기준율, 형식 ^[0-9]+\.[0-9]{2}$
fixed_krw_per_usdstring항상적용 환율, base × 1.02, 형식 ^[0-9]+\.[0-9]{2}$
buffer_bp200항상가산 폭(bp), 200
vat_bp1000항상부가세율(bp), 1000, 모든 amount_krw에 이미 포함
vat_includedtrue가격이 부가세 포함인지, supplykrw + vatkrw = amount_krw
sourcestring환율 출처
published_attimestamp고시 시각
presetsarray<object>항상프리셋 금액별 결제 원화와 부가세
presets[].usd5 | 20 | 50 | 100항상USD 정수
presets[].amount_krwinteger항상원화(원)
presets[].vat_krwinteger원화(원)
custom_min_usd5항상직접 입력 최소 USD
custom_max_usdinteger항상직접 입력 최대 USD
{
  "day": "2026-10-12",
  "base_krw_per_usd": "1410.50",
  "fixed_krw_per_usd": "1438.71",
  "buffer_bp": 200,
  "vat_bp": 1000,
  "vat_included": true,
  "source": "published",
  "published_at": "2026-10-12T03:11:05Z",
  "presets": [
    {
      "usd": 20,
      "amount_krw": 28775,
      "vat_krw": 2616
    }
  ],
  "custom_min_usd": 5,
  "custom_max_usd": 1000
}

오류

HTTP코드다시 시도뜻
400invalid_request아니오본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401session_required아니오콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403console_only아니오콘솔 세션 전용 엔드포인트입니다, API 키로는 결제, 키, 멤버 관리를 할 수 없습니다
403insufficient_permission아니오역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
429rate_limited가능이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500internal_error가능예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요
503fx_rate_unavailable가능오늘의 고정 원화 환율이 아직 없습니다, 환율이 올라올 때까지 충전이 닫힙니다

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl "https://xenoci.com/api/runner/v1/fx-rates/today" \
  --cookie "xci_console=$SESSION" \
  -H "Origin: https://xenoci.com"

다음 단계