암호화폐 API 레퍼런스

개요

암호화폐 페어의 가격과 가격 이력입니다. 모든 요청에 Bearer 키가 필요하며 REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.

페어 id는 코인, 하이픈, 기준 통화 순으로 쓰며 BTC-USD, ETH-EUR가 그 예입니다. 대소문자는 구분하지 않고 하이픈 대신 슬래시도 허용됩니다. 모든 응답에는 표준 페어가 담깁니다. 기준 통화는 USD, EUR, GBP입니다. 가격은 유효숫자 최대 8자리의 십진수 문자열입니다.

암호화폐는 하루 종일 거래되므로 장 세션이 없습니다. 가격이 5분을 넘으면 stale로 표시됩니다.

기본 URL: https://api.narwhalapi.com. MCP 도구: crypto, with one action 를 아래 각 라우트에 대응해 둡니다.

모든 계정에 제공되는 것

확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.

• 암호화폐에는 거래량이 없습니다. 가격과 봉에는 거래량 필드가 없습니다.
• 일봉은 UTC 기준 하루이며 00:00 UTC에 나타납니다. 오늘의 미완성 봉은 표시되지 않습니다.
• 페어 목록에는 가격을 제공하는 페어가 담깁니다. 페어는 30초에 한 번 이상 거래되는 동안 목록에 있고, 2분에 한 번 미만으로 떨어지면 제외됩니다.

엔드포인트

모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.

가격을 제공하는 암호화폐 페어

GET /v1/crypto/pairs

가격을 제공하는 모든 페어를 페어(BTC-USD 형식)별로 반환합니다. 선택 파라미터 quote(USD, EUR 또는 GBP)를 쓸 수 있습니다. 페어는 30초에 한 번 이상 거래되는 동안 목록에 있고, 2분에 한 번 미만으로 떨어지면 제외됩니다. 자체 페어 목록에서 읽으므로 모든 계정에서 사용할 수 있고 호출 1회로 계산됩니다.

MCP: 도구 crypto, action pairs.

매개변수

응답 필드

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/pairs?quote=USD"

{
  "pairs": [
    {
      "pair": "BTC-USD",
      "base": "BTC",
      "quote": "USD",
      "name": "Bitcoin"
    },
    {
      "pair": "ETH-EUR",
      "base": "ETH",
      "quote": "EUR",
      "name": "Ethereum"
    }
  ]
}

암호화폐 페어 하나의 최신 가격

GET /v1/crypto/{pair}/price

페어의 최신 종합 가격과 24시간 변동을 반환합니다(알 수 없으면 생략). 암호화폐는 하루 종일 거래되므로 장 세션이 없으며, 가격이 5분을 넘으면 stale이 true입니다. change_24h_percent는 퍼센트 단위입니다.

MCP: 도구 crypto, action price.

매개변수

응답 필드

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/BTC-USD/price"

{
  "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
}

최대 50개 암호화폐 페어의 최신 가격

GET /v1/crypto/prices

나열된 각 페어의 최신 가격입니다. 가격이 반환된 페어마다 호출 1회로 계산하며 한 번에 차감합니다. 조회에 성공한 페어의 비용을 잔액으로 감당할 수 없으면 요청 전체가 402 insufficient_credits로 거부됩니다. 가격이 반환되지 않은 페어는 errors에 (id로) 나열되며 비용이 들지 않습니다. change_24h_percent는 퍼센트 단위입니다.

최대 50개의 페어를 보낼 수 있습니다. 배치는 한 번에 차감됩니다. 조회에 성공한 페어의 비용을 잔액으로 감당할 수 없으면 요청 전체가 402 insufficient_credits를 반환합니다.

MCP: 도구 crypto, action prices.

매개변수

응답 필드

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/prices?pairs=BTC-USD,ETH-USD"

{
  "prices": [
    {
      "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
    }
  ],
  "errors": [
    {
      "id": "XYZ-USD",
      "code": "not_found"
    }
  ]
}

암호화폐 페어 하나의 가격 봉

GET /v1/crypto/{pair}/bars

일봉(1d, UTC 기준 하루이며 00:00 UTC에 마감) 또는 1분봉(1m)을 오래된 순으로 반환합니다. 하루치 봉은 00:00 UTC에 나오며 오늘의 미완성 봉은 표시되지 않습니다. 이력은 모든 계정에 전체 기간이 제공됩니다. 한 페이지에 최대 5,000개의 봉이 담기며 next_cursor가 함께 반환됩니다. 가격과 더 이상 맞지 않는 커서는 409 cursor_expired입니다. 페이지당 호출 1회입니다.

커서가 가리키는 가격이 바뀌면 커서가 더 이상 동작하지 않고 409 cursor_expired가 반환됩니다.

MCP: 도구 crypto, action bars.

매개변수

응답 필드

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/crypto/BTC-USD/bars?interval=1d&start=2026-10-01"

{
  "pair": "BTC-USD",
  "bars": [
    {
      "timestamp": "2026-10-25T00:00:00Z",
      "open": "67210.3",
      "high": "68540.9",
      "low": "66980.1",
      "close": "68100.2"
    }
  ],
  "next_cursor": null
}

오류

오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_id. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.