인증

API에 대한 모든 요청은 키를 전달해야 합니다. 별도의 OAuth 플로우는 없으며, 키 생성을 위한 로그인 외에 별도의 가입 절차도 없습니다.

키 발급받기

대시보드를 열고 GitHub 또는 Google로 로그인한 다음 키를 생성하세요. 키는 한 번만 표시되므로 안전한 곳에 복사해두세요. 이후로 대시보드에는 프리픽스만 저장됩니다. 새로 생성한 키는 모두 Free로 시작합니다.

키 전송하기

REST와 MCP 서버 모두 키를 베어러 토큰으로 받습니다.

Authorization: Bearer sk_live_...

MCP 서버는 이 방식으로 헤더를 보내는 클라이언트를 위해 동일한 키를 raw 헤더로도 받습니다.

X-API-Key: sk_live_...

두 헤더 중 어느 쪽을 사용하든 같은 티어의 같은 키로 인증됩니다. MCP와 REST용으로 별도의 키 타입은 없습니다.

키 없이 사용 가능한 티어는 없음

Free를 포함해 모든 요청에는 키가 필요합니다. api.dino.markets에 대한 익명 접근이나 인증 없는 접근은 존재하지 않습니다. 마케팅 사이트의 라이브 게임 페이지는 예외로, 5분 지연된 동일한 매칭 데이터를 키 없이 보여줍니다. 이는 프로그래밍 방식 사용이 아니라 둘러보기 용도입니다.

Free 티어와 제한

키 생성은 무료이며 결제 수단도 요구하지 않습니다. Free에서 사용할 수 있는 범위는 다음과 같습니다.

• REST를 통한 매칭 피드와 arb 뷰 (GET /v2/markets, GET /v2/pairs/{market_id}, GET /v2/leagues, GET /v2/coverage)
• 분당 60회 요청
• MCP 서버의 툴 목록과 모든 읽기 전용 툴 (list_markets, find_arbitrage, get_market, list_leagues, get_coverage, report_bad_arb)

실시간 WebSocket 스트림(POST /v1/stream/token과 watch_markets MCP 툴)은 Basic 또는 Pro가 필요하며, Free 키는 티켓 발급 엔드포인트에서 402를 받습니다. 전체 플랜 비교는 가격을, 플랜별 속도 제한은 REST API를 참고하세요.

오류

키가 없거나 유효하지 않으면 401이 반환됩니다. 유효한 키가 플랜의 속도 제한을 초과하면 429가 반환됩니다. 유효한 Free 키로 Basic/Pro 전용 경로(스트림 티켓)를 호출하면 402가 반환됩니다.