무료 요금제에는 시간당 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 헤더를 반환합니다. 다음 시간이 시작되면 요청이 다시 작동합니다.
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"| 상태 | 오류 | 발생 조건 |
|---|---|---|
| 429 | rate_limit_exceeded | 요금제의 시간당 요청 초과 |
| 401 | api_key_required | 요청에 키가 없음 |
| 401 | invalid_api_key | 키가 유효하지 않음 |
| 403 | feature_requires_basic | 요금제에 이 엔드포인트가 없음 |
{ "error": "rate_limit_exceeded" }유료 요금제 제한
유료 요금제에는 더 많은 요청과 데이터가 포함됩니다.
Basic 요금제
| Basic | 제한 |
|---|---|
| 월 요금 | $8 |
| 시간당 요청 | 2,000 |
| 현물 가격 | 실시간 |
| 금속 | 5 |
| 환율과 다른 통화 | 예 |
| 일별 내역 | 예 |
| 일별 OHLC 캔들 | 아니요 |
| 전일 종가와 일일 변동 | 아니요 |
| 상업적 사용 | 예, 링크 불필요 |
Pro 요금제
| Pro | 제한 |
|---|---|
| 월 요금 | $15 |
| 시간당 요청 | 무제한 |
| 현물 가격 | 실시간 |
| 금속 | 5 |
| 환율과 다른 통화 | 예 |
| 일별 내역 | 예 |
| 일별 OHLC 캔들 | 예 |
| 전일 종가와 일일 변동 | 예 |
| 상업적 사용 | 예, 링크 불필요 |
요금제 선택
무료 요금제는 프로토타입, 내부 대시보드, 개인 사이트에 적합합니다. 시간당 100회를 넘는 요청, 일별 내역, 일별 캔들이 필요하면 유료 요금제를 선택하세요.