본문으로 건너뛰기
OtterIndex

오픈 API · MCP

오터 점수, 김치 프리미엄, 근거 달린 가격 설명, 오터 심리 지수를 내 서비스와 AI 에이전트에 붙이세요. 키 하나로 REST 와 MCP 를 같이 씁니다.

API 키 받기OpenAPI

다른 시세 사이트 API 에는 없는 것

  • 코인 목록 (오터 순위) /coins

    오터 점수 순 코인 목록. 점수·순위·김치 프리미엄을 함께 준다.

  • 코인 상세 /coins/{id}

    오터 점수 항목별 값, 김치 프리미엄, OtterChart 종합 종목 링크.

  • 왜 움직였나 /coins/{id}/explain

    최근 24시간 가격 움직임을 근거 번호가 달린 문장으로 설명한다. 문장마다 cites 가 evidence 의 id 를 가리킨다.

  • 김치 프리미엄 레이더 /kimchi

    국내 4개 거래소(업비트·빗썸·코인원·코빗) 원화 시세와 해외 기준가의 차이. 가장 비싼·가장 싼 코인과 입출금이 막힌 코인.

  • 오터 심리 지수 /sentiment

    변동성·시장 폭·추세·김프 등을 묶은 우리 시장 심리 지수(0~100)와 하루 기록.

  • 오늘 시장 요약 /market/brief

    시장 전체 움직임을 근거 번호가 달린 문장으로 요약.

1분 만에 첫 호출

  1. 1. 로그인 후 설정 › 개발자에서 사용 목적을 적어 신청
  2. 2. 승인되면 키 만들기 (원문은 만들 때 한 번만 보입니다)
  3. 3. 헤더 X-Api-Key 에 넣어 호출
curl -H "X-Api-Key: 여기에_API_키" \
  "https://otterindex.com/api/open/v1/coins?size=5"

응답은 늘 { data, meta } 모양이고, meta.credits 에 쓴 크레딧이 나옵니다.

한도

키는 한 사람당 3개까지. 호출마다 크레딧을 쓰고, 0 크레딧 문서·사용량 조회는 월 한도와 상관없습니다.

무료

지금 신청

0원

분당 요청
30회
월 크레딧
30,000

프로

준비 중

문의

분당 요청
120회
월 크레딧
500,000

AI 에이전트에 연결 (MCP)

MCP 는 Claude·Cursor 같은 AI 도구가 외부 기능을 직접 불러 쓰는 표준입니다. 연결하면 AI 가 “오늘 김프 제일 높은 코인”이나 “이더리움 왜 올랐어”에 우리 데이터로 답합니다. REST 와 같은 키, 같은 크레딧을 씁니다.

주소

https://otterindex.com/api/open/mcp

도구 11개 · 프롬프트 2개 (오늘 한국 코인 시장 브리핑, 이 코인 왜 움직였나)

터미널에 한 줄

claude mcp add --transport http otterindex https://otterindex.com/api/open/mcp \
  --header "X-Api-Key: 여기에_API_키"

엔드포인트

기본 주소 https://otterindex.com/api/open/v1 · 모두 GET · 이름 옆은 같은 기능의 MCP 도구

오터인덱스 고유 데이터

GET/coins

코인 목록 (오터 순위)

오터 점수 순 코인 목록. 점수·순위·김치 프리미엄을 함께 준다.

크레딧 1MCP list_coins

  • page · 쪽 번호 (1부터) (기본 1)
  • size · 한 쪽 개수 (최대 100) (기본 50)

예: GET /coins?size=5

GET/coins/{id}

코인 상세

오터 점수 항목별 값, 김치 프리미엄, OtterChart 종합 종목 링크.

크레딧 1MCP get_coin

  • id필수 · 코인 id (/search 로 찾는다)

예: GET /coins/bitcoin

GET/coins/{id}/explain

왜 움직였나

최근 24시간 가격 움직임을 근거 번호가 달린 문장으로 설명한다. 문장마다 cites 가 evidence 의 id 를 가리킨다.

크레딧 5MCP explain_price_move

  • id필수 · 코인 id (/search 로 찾는다)

예: GET /coins/bitcoin/explain

GET/kimchi

김치 프리미엄 레이더

국내 4개 거래소(업비트·빗썸·코인원·코빗) 원화 시세와 해외 기준가의 차이. 가장 비싼·가장 싼 코인과 입출금이 막힌 코인.

크레딧 2MCP kimchi_premium

예: GET /kimchi

GET/sentiment

오터 심리 지수

변동성·시장 폭·추세·김프 등을 묶은 우리 시장 심리 지수(0~100)와 하루 기록.

크레딧 1MCP market_sentiment

  • days · 기록 기간(일) (기본 90)

예: GET /sentiment?days=30

GET/market/brief

오늘 시장 요약

시장 전체 움직임을 근거 번호가 달린 문장으로 요약.

크레딧 5MCP market_brief

예: GET /market/brief

찾기·지표·계정

GET/search

코인 찾기

이름·한글 이름·티커로 코인 id 를 찾는다.

크레딧 1MCP search_coins

  • q필수 · 찾을 말 (예: 비트코인, BTC)

예: GET /search?q=btc

GET/coins/{id}/indicators

기술 지표

RSI(14)·MACD·20/50/200일 이동평균·골든/데드크로스. 끝난 일봉 기준 6시간마다 다시 계산.

크레딧 1MCP get_indicators

  • id필수 · 코인 id (/search 로 찾는다)

예: GET /coins/ethereum/indicators

GET/indicators

지표로 훑어보기

상위 100·300 코인의 지표를 한 번에. 과매수·과매도·크로스 코인 찾기에 쓴다.

크레딧 2MCP screen_indicators

  • top · 상위 몇 개 (기본 100)
  • excludeStable · 스테이블코인 빼기 (기본 true)

예: GET /indicators?top=100

GET/methodology

오터 점수 계산 기준

가중치·기준값 등 점수 계산식 전체 공개.

크레딧 0MCP otter_score_methodology

예: GET /methodology

GET/usage

내 사용량

이 키의 분당·월간 남은 한도와 최근 30일 사용량. 크레딧을 쓰지 않는다.

크레딧 0MCP my_usage

예: GET /usage

응답 헤더

X-RateLimit-Limit / Remaining / Reset
분당 한도, 이번 1분 남은 요청, 풀리기까지 초
X-Credits-Limit / Remaining
이번 달 크레딧 한도와 남은 양 (매달 1일 UTC 에 다시 채움)
X-Credits-Cost
이 호출이 쓴 크레딧

오류

모양은 { error: { code, message } }, 메시지는 한국어입니다.

400
INVALID · 입력값이 틀렸습니다. 크레딧은 쓰지 않습니다
401
NO_KEY · BAD_KEY · 키가 없거나 모르는 키입니다
403
REVOKED · BLOCKED · 폐기했거나 막힌 키입니다
404
NOT_FOUND · 없는 코인입니다. /search 로 id 를 찾으세요
429
RATE_LIMIT · QUOTA · 분당 한도 또는 월 크레딧을 넘었습니다. Retry-After 초 뒤에 다시
503
DISABLED · 점검으로 잠시 멈췄습니다

이용 조건

2026-10-20 판 · 신청할 때 이 내용에 동의합니다

  1. 키는 본인만 씁니다. 다른 사람에게 넘기거나 공개 저장소·앱 코드에 넣지 마세요. 새어 나갔다면 바로 폐기하고 새로 만드세요.
  2. 응답을 내 서비스에 보여 줄 때는 OtterIndex 에서 받은 값임을 밝혀 주세요.
  3. 받은 데이터를 그대로 묶어 되팔거나 다른 데이터 API 로 다시 내보내는 용도는 허용하지 않습니다.
  4. 점수·설명·지수는 참고 정보이며 투자 권유가 아닙니다. 투자 판단과 그 결과의 책임은 이용자에게 있습니다.
  5. 한도를 넘기거나 서비스에 무리를 주는 호출, 이 조건을 어긴 사용이 확인되면 키를 막을 수 있습니다.
  6. v1 안에서 응답 항목은 늘어날 수 있습니다. 항목을 없애거나 뜻을 바꿀 때는 이 페이지에 미리 알립니다.