전체 이력 백필
이력 전체를 페이지 단위로 가져와 파일에 저장하고, 중단되면 이어서 받습니다.
가이드 읽기 →모든 API
실시간과 과거 시세를 제공하는 암호화폐 API
REST 또는 MCP로 암호화폐 페어의 가격과 가격 이력을 받을 수 있으며, 계정 잔액은 하나이고 모든 요청에 Bearer 키를 씁니다. 가격은 유효숫자 최대 8자리의 십진수 문자열입니다.
첫 요청
최신 가격 가져오기
curl --request GET \
--url "https://api.narwhalapi.com/v1/crypto/BTC-USD/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"응답 예시
{
"pair": "BTC-USD",
"base": "BTC",
"quote": "USD",
"price": "68250.5",
"change_24h": "812.4",
"change_24h_percent": "1.2",
"timestamp": "2026-10-26T15:42:00Z",
"stale": false
}엔드포인트
GET가격을 제공하는 암호화폐 페어/v1/crypto/pairs
가격을 제공하는 모든 페어를 페어별로 보여줍니다(BTC-USD 형식).
매개변수
quote선택이 통화(USD, EUR 또는 GBP)로 표시되는 페어만 반환합니다.
응답 필드
pairs객체 목록가격을 제공하는 모든 페어를 페어별로 반환합니다. 페어는 30초에 한 번 이상 거래되는 동안 목록에 있고, 2분에 한 번 미만으로 떨어지면 제외됩니다.
전체 레퍼런스 →
GET암호화폐 페어 하나의 최신 가격/v1/crypto/{pair}/price
페어의 최신 종합 가격과 24시간 변동을 조회합니다(알 수 없는 경우 생략).
매개변수
pair필수암호화폐 페어로, 코인, 하이픈, 기준 통화 순입니다. 예: BTC-USD, ETH-EUR. 대소문자는 구분하지 않으며 하이픈 대신 슬래시도 허용됩니다. 응답에는 표준 페어가 담깁니다.
응답 필드
pair문자열코인과 기준 통화로 구성되어 반환되는 정규 페어입니다.
base문자열요청한 암호화폐 페어에서 코인의 티커입니다.
quote문자열응답의 모든 가격에 쓰이는 기준 통화입니다.
price문자열최대 8자리 유효숫자의 십진 문자열로 표시한 마지막 가격입니다.
change_24h문자열24시간 동안의 가격 변동으로, 변동률에서 계산하며 알 수 없으면 생략됩니다.
change_24h_percent문자열24시간 동안의 변동률(%)입니다. 1.5는 1.5%를 뜻합니다. change_24h와 함께 생략됩니다.
timestamp날짜·시간가격이 유효했던 시각이며, UTC 기준 초 단위로 표시됩니다.
stale불리언가격이 5분 넘게 지났거나 갱신하지 못했을 때 true입니다.
delayed항상 true반환되지 않습니다. 가격이 모든 계정에서 실시간이기 때문입니다.
전체 레퍼런스 →
GET최대 50개 암호화폐 페어의 최신 가격/v1/crypto/prices
등록된 각 페어의 최신 가격입니다.
매개변수
pairs필수쉼표로 구분한 페어이며 중복을 제거한 뒤 최대 50개입니다. 각 페어는 단건 가격 경로와 같은 규칙을 따릅니다. 가격이 반환된 페어마다 호출 1회로 계산됩니다.
응답 필드
prices객체 목록조회에 성공한 페어마다 가격 하나를 페어별로 반환합니다.
errors객체 목록가격이 반환되지 않은 페어입니다. 요금이 부과되지 않습니다.
전체 레퍼런스 →
GET암호화폐 페어 하나의 가격 봉/v1/crypto/{pair}/bars
일간(1d, UTC 하루 단위, 00:00 UTC 마감) 또는 1분(1m) 막대이며, 오래된 순으로 정렬됩니다.
매개변수
pair필수암호화폐 페어로, 코인, 하이픈, 기준 통화 순입니다. 예: BTC-USD, ETH-EUR. 대소문자는 구분하지 않으며 하이픈 대신 슬래시도 허용됩니다. 응답에는 표준 페어가 담깁니다.
interval선택UTC day, closing at 00:00 UTC) or 1m (one-minute bars).당 1d (one bar Anything else is 400 invalid_interval.
start선택첫 번째 막대입니다. 1d: 날짜(YYYY-MM-DD), 해당 날짜 포함이며, 생략하면 가장 오래된 막대부터입니다. 1m: UTC 시각(YYYY-MM-DDTHH:MM:SSZ, 또는 00:00 UTC를 뜻하는 날짜), 해당 시각 포함이며, 생략하면 end의 하루 전입니다.
end선택마지막 막대입니다. 1d: 날짜, 해당 날짜 포함이며, 생략하면 마감된 가장 최근 거래일입니다. 1m: UTC 시각, 해당 시각 미포함이며, 생략하면 현재 시각 또는 start로부터 5일 뒤입니다. 1m에서 start와 end의 간격은 최대 5일입니다(400 range_too_large).
cursor선택이전 페이지의 next_cursor이며, 매개변수는 동일하게 사용합니다.
응답 필드
pair문자열표준 페어입니다.
start문자열전송되지 않으며, start는 이동하지 않습니다.
end문자열전송되지 않음: 일봉은 잘리지 않습니다.
bars객체 목록한 페이지에 최대 5,000개의 봉.
next_cursor문자열다음 페이지를 읽으려면 이 값을 다시 전달합니다. 마지막 페이지에서는 null입니다.
전체 레퍼런스 →
활용 사례
관련 API
자주 묻는 질문
어떤 통화쌍을 가져올 수 있나요?
약 40개 페어가 USD, EUR, GBP 기준으로 가격이 매겨집니다. BTC-USD나 ETH-EUR처럼 사용하세요. id는 대소문자와 슬래시를 허용하며, 응답은 정규 페어를 반환합니다.
가격은 실시간인가요, 지연되나요?
주식, ETF, 암호화폐 가격은 모든 계정에서 실시간이며, 암호화폐 응답에는 24시간 변동이 포함됩니다.
암호화폐 가격은 얼마나 최신인가요?
암호화폐는 하루 종일 거래되며 장 세션이 없습니다. 가격이 5분 넘게 지났거나 갱신에 실패하면 지연으로 표시되며, 가격과 바에는 거래량 필드가 없습니다.
비용은 얼마인가요?
호출은 1,000건당 $2이며 선불 크레딧에서 차감됩니다. 모든 계정은 가입 후 첫 12개월 동안 매월 $10의 무료 크레딧을 받으며, 상업적 이용도 허용됩니다.
API는 무엇을 다루나요?
페어 목록은 모든 계정에 열려 있으며 Narwhal이 가격을 제공하는 페어를 담고 있습니다. 페어는 최소 30초에 한 번 거래되는 동안 목록에 있고, 2분에 한 번 미만으로 떨어지면 제외됩니다. 일봉과 1분봉은 전체 이력을 다룹니다. 일괄 가격 호출은 ID를 최대 50개까지 받습니다.
일별 암호화폐 바는 어떻게 작동하나요?
일봉 하나는 UTC 하루를 다루며 00:00 UTC에 나타납니다. 오늘의 미완성 봉은 표시되지 않습니다.
암호화폐 가격 이력은 얼마나 요청할 수 있나요?
모든 계정이 일봉과 1분봉의 전체 이력을 받습니다. 더 오래된 행이 없으면 start가 처음 제공한 날짜를 반환합니다.
24시간 변동은 무엇을 나타내나요?
change_24h는 가격에서 24시간 전 가격을 뺀 값이며, 24시간 변동률에서 계산합니다. 변동률 필드의 1.5는 1.5%를 뜻합니다. 변동을 알 수 없으면 두 변동 필드 모두 생략됩니다.
페어 id와 일괄 호출은 어떻게 작동하나요?
페어 id는 코인과 기준 통화를 대시로 연결한 형태이며, 예를 들어 BTC-USD입니다. 대소문자는 구분하지 않고 슬래시도 허용됩니다. 일괄 호출은 최대 50개 id를 받으며, 가격이 반환되는 id마다 1회로 계산됩니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.