변경 이력
Data API와 그 계약의 모든 변경 사항을 최신순으로 정리했습니다. 버전 번호는 버전 관리 및 지원 종료 정책을 따릅니다.
Smithery처럼 Authorization 헤더를 자체 로그인 전용으로 사용하는 클라이언트와 게이트웨이를 위해, 이제 /mcp에서는 MCP 키를 X-API-Key: YOUR_API_KEY 헤더로도 받습니다. Authorization: Bearer는 계속 동작하며 문서상 기본 방식으로 유지됩니다. 두 헤더를 모두 보내면 확인하는 것은 X-API-Key의 키입니다. /api/v1의 Data API는 여전히 Bearer 키만 허용합니다. 이제 인증 실패에 대한 요청 제한이 IP 단위뿐 아니라 키 단위로도 적용되므로, 한 클라이언트의 유효하지 않은 키 때문에 같은 IP를 공유하는 다른 클라이언트까지 차단되는 일이 더 이상 없습니다.
GET /calculators/compound-interest는 기간을 복리 기간의 정수배로 반올림했기 때문에, 복리 기간 중간에 끝나는 기간이 너무 길거나 짧게 시뮬레이션되었습니다. annually 복리로 6개월을 계산하면 꼬박 1년(입금 12회와 1년 치 이자)이 계산되었고, 5개월이면 복리 기간이 하나도 계산되지 않았습니다(입금도 이자도 없음). 이제 온전한 기간은 이전과 같이 계산하고, 마지막으로 일부만 지난 기간에는 비례해서 이자를 붙이며(해당 부분은 단리), 기간 안의 모든 입금을 반영합니다. 기간이 복리 기간의 정수배이면 결과는 그대로이며, 파라미터와 응답 필드도 바뀌지 않았습니다.
API와 문서는 rate 값을 복리 주기당 이율로 취급했지만, 웹사이트 계산기와 사용 가이드는 연 이율을 사용했습니다. GET /calculators/compound-interest는 각 복리 주기에 rate 값을 그대로 적용했기 때문에 월 복리 5%가 매월 5%씩 불어났습니다. 이제 rate 값은 연 명목 이율이며, 각 주기에는 rate 값을 연간 주기 수로 나눈 이율이 적용됩니다(연 5%를 월 복리로 계산하면 월 5/12%). 이 내용은 이제 meta.note에도 표시됩니다. 매개변수와 응답 필드는 바뀌지 않으며, annually를 제외한 모든 복리 주기에서 결과가 달라집니다. 또한 contribution_frequency 값과 compound_frequency 값이 모두 daily이거나 모두 weekly인 경우, 부동소수점 반올림 오차로 납입이 늦어지거나 누락되는 일이 더 이상 없으므로 duration_unit=months에서는 total_contributions 값이 납입 1회분만큼 커질 수 있습니다. 기존 파라미터의 의미가 바뀝니다. 이전 결과를 재현하려면 rate에 연간 복리 기간 수를 곱하세요.
모든 Fear & Greed 값에 이제 score 옆에 index가 포함됩니다. Bitculator에 표시되는 것과 똑같은 0–100 Fear & Greed 지수입니다(0–19 극단적 공포, 20–39 공포, 40–59 중립, 60–79 탐욕, 80–100 극단적 탐욕). 표시할 때는 이 값을 사용하세요. score는 변경되지 않았으며, index의 기반이 되는 −100…+100 원시 종합값입니다. 적용 대상: GET /sentiment/fear-greed(대표 값과 intervals의 모든 항목), GET /global의 fear_greed, GET /global/heatmap의 meta.fear_greed. 추가만 이루어졌으며 기존 필드는 변경되지 않았습니다.
GET /coins/{slug}는 최대 공급량이 없는 코인(예: 공급량 상한이 없는 Solana, Ethereum)에 대해 fully_diluted_valuation를 0으로 반환했습니다. 이제 총 공급량으로 대체하며, 둘 다 알 수 없으면 null을 반환합니다. OpenAPI 계약에 이미 문서화된 동작입니다.
유통 공급량이 없는 코인은 marketcap과 dominance가 null일 수 있고, 순위가 매겨지지 않은 거래소는 신뢰도 점수의 score와 breakdown이 null입니다. 선택한 지표에 대한 현재 값이 코인에 없으면 POST /alarms는 422를 반환합니다. 이제 /coins/recently-added와 /wallets/timeline이 sort를 적용합니다. /coins/gainers와 /coins/losers는 변동률 자체를 기준으로 정렬되며(이전에는 사실상 시가총액 기준이었습니다), 하락 목록에서는 0.00인 코인을 제외합니다. 오름차순 정렬에서는 null 값이 마지막에 놓입니다. /prices는 모호한 심볼을 순위가 가장 높은 활성 코인으로 해석합니다. OpenAPI 계약에는 null이 될 수 있는 마켓 필드가 표시되고 24시간 거래량이 숫자 타입으로 지정됩니다.
공개된 계약에는 이제 미디어 타입 수준의 예시, 모든 4xx/5xx 응답에서 참조하는 공통 오류 스키마 하나, 키를 사용하는 모든 호출이 반환할 수 있는 401·429·500 응답, 모든 성공 응답에 포함되는 X-RateLimit-* 및 X-Quota-* 헤더, alarm.triggered 전송을 POST /webhooks의 콜백으로 기술한 정의, 그리고 연락처·라이선스·약관 메타데이터가 담깁니다. 요청이나 응답은 바뀌지 않았고 - 기술 방식만 달라졌습니다.
신규: /apis.json, /.well-known/api-catalog(RFC 9727), /.well-known/security.txt(RFC 9116), 공통 응답 형태를 담은 JSON Schema 번들, JSON 버전을 함께 제공하는 공개 상태 페이지, 이 변경 이력, 그리고 버전 관리 및 지원 종료 정책.
MCP 서버가 MCP 콘솔에서 발급하는 전용 키와 요금제로 옮겨 갔습니다. /mcp에서는 더 이상 Data API 키가 허용되지 않으며, 도구 호출 한 번은 여전히 요청 1건으로 계산됩니다.
Bitculator MCP 서버가 /mcp에서 가동을 시작했습니다. Claude, Cursor, VS Code를 비롯한 모든 MCP 클라이언트를 위해 Streamable HTTP로 제공되는 읽기 전용 도구 19개이며, REST API와 동일한 소수 문자열 데이터를 반환합니다.
TypeScript, Python, PHP, Go, Rust, Java, C#, C++ 클라이언트로, 모두 동일한 전송 코어 위에서 전체 엔드포인트를 지원합니다. Bearer 인증, 응답 형식 해제, X-Quota-* 수집, 429 및 5xx 재시도, 타입이 지정된 오류와 페이징을 제공합니다.
이제 일부 엔드포인트와 더 긴 지표 기간에는 Starter 또는 Pro가 필요합니다. 요금제 범위를 벗어난 호출은 403 plan_required를 반환하고, details.required_plan에 잠금을 해제하는 요금제가 명시되며, 쿼터는 소모되지 않습니다.
출시: 15개 그룹에 걸친 85개 오퍼레이션 - coins, prices, markets, exchanges, wallets, global, sentiment, indicators, liquidations, conversion, calculators, editorial, alarms, webhooks, meta. data-api 권한을 가진 Bearer 키, { data, meta } 응답 형식, 소수 문자열 정밀도, X-Quota-* 헤더, 서명된 웹훅, 그리고 각각 월간 쿼터를 갖는 Free, Starter, Pro 요금제.
지원 중단은 제거 최소 6개월 전에 이곳과 모든 키 소유자에게 보내는 이메일로 공지됩니다 - 다음 지원 종료 정책을 참고하세요. /apis.json의 기계 판독용 인덱스는 가장 최신 항목의 날짜를 modified 표기로 제공합니다.