요금 가이드

무료 요금제 제한

API 요금제 표에 따른 무료·유료 제한

무료 요금제에는 시간당 100회 요청, 금속 5종의 실시간 가격과 환율이 포함됩니다. 모든 요청에는 API 키가 필요합니다.

무료 요금제 포함 내용

제한은 계정의 모든 키를 합산해 계산합니다. 가격을 표시하는 페이지에 goldApi.dev로 가는 보이는 링크가 있으면 무료 요금제도 상업적으로 사용할 수 있습니다.

Free제한
월 요금$0
시간당 요청100
현물 가격실시간
금속5
환율과 다른 통화예
일별 내역아니요
일별 OHLC 캔들아니요
전일 종가와 일일 변동아니요
상업적 사용예, 가격 근처에 goldApi.dev로 가는 보이는 링크 필요

제한에 도달하면

응답 헤더 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 을 사용해 제한에 도달하기 전에 요청을 줄이세요. 초과하면 API는 429, 짧은 JSON, 초 단위 Retry-After 헤더를 반환합니다. 다음 시간이 시작되면 요청이 다시 작동합니다.

Shell
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"
상태오류발생 조건
429rate_limit_exceeded요금제의 시간당 요청 초과
401api_key_required요청에 키가 없음
401invalid_api_key키가 유효하지 않음
403feature_requires_basic요금제에 이 엔드포인트가 없음
응답
{ "error": "rate_limit_exceeded" }

유료 요금제에는 더 많은 요청과 데이터가 포함됩니다.

Basic 요금제

Basic제한
월 요금$8
시간당 요청2,000
현물 가격실시간
금속5
환율과 다른 통화예
일별 내역예
일별 OHLC 캔들아니요
전일 종가와 일일 변동아니요
상업적 사용예, 링크 불필요

Pro 요금제

Pro제한
월 요금$15
시간당 요청무제한
현물 가격실시간
금속5
환율과 다른 통화예
일별 내역예
일별 OHLC 캔들예
전일 종가와 일일 변동예
상업적 사용예, 링크 불필요

요금제 선택

무료 요금제는 프로토타입, 내부 대시보드, 개인 사이트에 적합합니다. 시간당 100회를 넘는 요청, 일별 내역, 일별 캔들이 필요하면 유료 요금제를 선택하세요.

질문

무료 요금제의 요청 제한은 얼마인가요?

계정의 모든 키를 합산해 시간당 100회입니다.

키 없이 API를 사용할 수 있나요?

아니요. 모든 요청에 X-API-Key 헤더의 키가 필요합니다. 무료 키에는 신용카드가 필요 없습니다.

제한에 도달하면 어떤 응답을 받나요?

오류 rate_limit_exceeded 와 초 단위 Retry-After 헤더가 포함된 429입니다.

제한은 언제 초기화되나요?

다음 시간이 시작될 때입니다. 정확한 시간은 X-RateLimit-Reset 헤더에 있습니다.

무료 요금제에서 상업적 사용이 가능한가요?

예. 가격을 표시하는 페이지에 goldApi.dev로 가는 보이는 링크가 있어야 합니다. 유료 요금제는 링크가 필요 없습니다.

더 읽기

무료 API 키로 시작하기

무료 플랜으로 시간당 100회 요청할 수 있습니다. 신용카드는 필요하지 않습니다.

무료 키 받기