CryptoStruct
공식원격 MCP 서버로, 암호화폐 및 예측 시장의 과거 데이터를 제공합니다: 약 50만 개 상품 검색, 실시간 시장 통계(OHLC, 거래량, 스프레드, 시장 깊이, 슬리피지) 및 틱 데이터 구매를 지원합니다. 카탈로그와 통계는 키 없이 이용 가능하며, 계정 도구는 선택적으로 OAuth를 사용합니다. 엔드포인트: https://cryptostruct.com/mcp
CryptoStruct MCP(으)로 무엇을 할 수 있나요?
- 악기 카탈로그 검색 —
search_instruments를 사용해 예측 시장을 포함한 35개 거래소의 악기를class=prediction같은 필터로 검색하세요. - 실시간 시장 스냅샷 확인 —
get_market_snapshot을 통해 모든 악기의 현재 OHLC, VWAP, 스프레드, 최상위 호가를 요청하세요. - 과거 집계 데이터 분석 — 일별, 시간별, 분별 통계(예:
get_daily_stats,get_hourly_stats)를 가져와 이벤트 연구나 추세 분석에 활용하세요. - 아카이브 범위 확인 —
get_coverage를 사용해 2021년까지의 악기 일별 데이터 가용성을 검증하세요. - 구매 미리보기 및 시작 —
preview_checkout으로 데이터 구매를 시뮬레이션한 후,create_checkout으로 Stripe URL을 받거나 신용 승인을 트리거하세요. - 계정 관리 —
list_my_orders와get_my_subscription으로 과거 주문을 확인하고, 구매한 파일 다운로드를 검색하며, 구독 또는 크레딧 잔액을 확인하세요.
문서
CryptoStruct MCP 서버
cryptostruct.com을 위한 퍼스트파티 원격 MCP 서버 — 역사적 암호화폐 및 예측 시장 데이터(Kalshi와 Polymarket을 포함한 35개 거래소의 틱 수준 일별 파일)와 실시간 시장 통계를 제공하며, 트레이더, 퀀트, AI 에이전트를 위해 구축되었습니다.
이 저장소는 호스팅된 서버를 문서화합니다. 여기서 설치하거나 실행할 것은 없습니다 — 서버는 CryptoStruct가 운영합니다.
- 엔드포인트:
https://cryptostruct.com/mcp(Streamable HTTP, 무상태, JSON 모드) - OAuth 엔드포인트:
https://cryptostruct.com/mcp/auth(동일한 도구; 표준 OAuth 흐름 — Dynamic Client Registration + PKCE — 을 트리거하기 위해401+WWW-Authenticate에 응답) - 서버 카드:
/.well-known/mcp/server-card.json - 문서: https://cryptostruct.com/docs/mcp · 제품 문서: https://docs.cryptostruct.com
API 키가 필요 없습니다 — 카탈로그, 시장 통계, 게스트 구매 흐름은 키 없이 작동합니다. OAuth를 통한 로그인(선택 사항)은 주문 내역, 구매 파일 다운로드, 크레딧 결제를 위해 CryptoStruct 계정을 연결합니다 — 항상 사용자 동의 하에 이루어집니다(데이터 구매 참조).
빠른 시작
Claude Code
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth
Cursor / 일반 JSON 구성
{
"mcpServers": {
"cryptostruct": {
"url": "https://cryptostruct.com/mcp"
}
}
}
claude.ai — 설정 → 커넥터 → 사용자 지정 커넥터 추가 → https://cryptostruct.com/mcp/auth
할 수 있는 작업
- 카탈로그 및 검색: 35개 거래소(현물, 무기한, 선물, 옵션, 예측 시장)에서 약 50만 개 상품 검색, 2021-02-08까지의 일별 아카이브 범위.
- 예측 시장: Kalshi와 Polymarket 이벤트 계약은 일급 상품입니다 — 카탈로그에서 검색 가능하며(
class=prediction), 범위, 실시간 스냅샷, 분/일 집계를 다른 암호화폐 상품과 동일하게 제공합니다. 계약은 0..1(USD)로 호가되며, 회전율은 USD로 정규화됩니다. - 시장 통계: 실시간 스냅샷 및 분/시간/일 집계 — OHLC, VWAP, 거래, 회전율, 스프레드, 최상위 호가 깊이; 슬리피지 / 시장 영향 곡선.
- 데이터 구매: 원시 틱 파일 — 암호화폐 및 예측 시장 상품 모두 — 상품-일당 €1입니다. 카드 결제: 서버는 Stripe 체크아웃 URL을 전달합니다 — 결제는 사용자 브라우저에서 이루어지며, 서버는 카드 정보를 다루지 않습니다. 무료 전체 일별 샘플 파일은 구매 없이 제공됩니다.
- 크레딧 및 에이전트 동의(OAuth 로그인): 계정 크레딧은 사용자 동의 없이 에이전트가 사용할 수 없습니다. 기본적으로
create_checkout는approval_required에 승인 페이지로 응답하며, 사용자가 (크레딧 또는 카드로 결제) 확인하거나 주문을 폐기합니다; 승인되지 않은 주문은 24시간 후 아무것도 청구되지 않고 만료됩니다. 사용자는 https://cryptostruct.com/account/agents 에서 한도 내 자율 구매(주문당 및 24시간 롤링 상한)를 선택할 수 있습니다 — 그러면 크레딧으로 완전히 충당되는 주문은 즉시 완료됩니다; 상한을 초과하는 것은 승인을 위해 다시 돌아옵니다. 에이전트는 추가로 자체max_credit_cents를 전달할 수 있습니다.preview_checkout는 에이전트에게 세 가지 결과 중 어떤 것이 발생할지 미리 알려줍니다. 이러한 설정은 웹사이트에서만 변경할 수 있으며, 에이전트의 토큰을 통해서는 절대 변경할 수 없습니다. - 계정 도구(OAuth 로그인): 주문 목록, 구매 파일 다운로드 URL, 구독, 크레딧 잔액 및 에이전트 지출 설정 확인.
도구
| 도구 | 설명 | 등급 |
|---|---|---|
get_data_dictionary | 데이터 사전 및 제품 참조(파일 형식, 단위, 가격) | 무료 |
search_instruments | 상품 카탈로그 검색 | 무료 |
list_venues | 지원 거래소 목록 | 무료 |
get_instrument | 상품 세부 정보 | 무료 |
get_coverage | 상품의 일별 아카이브 범위 | 무료 |
list_sample_files | 무료 전체 일별 샘플 파일 | 무료 |
get_price_quote | 데이터 파일 세트에 대한 가격 견적 | 무료 |
get_market_snapshot | 실시간 시장 스냅샷(60분 + 24시간) | 무료 |
get_daily_stats | 일별 집계(30일–180일 무료; 365일/최대 프리미엄) | 무료 |
get_hourly_stats | 시간별 집계(7일–90일 무료; 180일 프리미엄) | 무료 |
get_slippage | 슬리피지 / 시장 영향 곡선(1시간 무료; 24시간/7일 프리미엄) | 무료 |
get_top_instruments | 실시간 24시간 회전율 기준 상위 상품 | 무료 |
get_movers | 24시간 변동 상품(상승 및 하락) | 무료 |
get_minutes_range | 이벤트 연구를 위한 역사적 분 단위 시계열 | 프리미엄 |
create_checkout | 구매 시작 — Stripe URL(카드) 또는 approval_required / born-paid(크레딧, 사용자 동의 설정에 따름) | 상거래 |
get_checkout_status | session_id (카드) 또는 order_id (로그인; 크레딧/승인 주문)로 체크아웃 폴링 | 상거래 |
get_order_files | 유료 주문의 파일 및 다운로드 URL 목록 | 상거래 |
request_file_restore | 보관(콜드 스토리지) 파일 복원 | 상거래 |
list_my_orders | 내 주문 | 로그인 |
get_my_files | 내 구매 파일 | 로그인 |
get_my_subscription | 내 구독, 크레딧 잔액 및 에이전트 지출 설정 | 로그인 |
preview_checkout | 구매 드라이 런: 소유/사용 불가 파일, 크레딧 충당, create_checkout 가 완료될지, 승인을 요청할지, Stripe로 전환할지 여부 | 로그인 |
등급: free/commerce 는 키 없이 작동합니다. sign-in 는 검증된 OAuth 로그인(모든 계정)이 필요합니다. premium 도구/매개변수는 CryptoStruct 프리미엄(월 €20)이 필요합니다 — 이는 더 긴 통계 기간(일별 365일/최대, 시간별 180일, 슬리피지 24시간/7일), 더 큰 검색 한도, get_market_snapshot 의 데이터 품질 블록, 5배 호출 예산을 제공합니다. 등급을 초과하는 호출은 업그레이드 URL과 함께 정적 AUTH_REQUIRED / PREMIUM_REQUIRED 오류를 반환합니다 — 하드 실패는 없습니다.
속도 제한
호출자별 가중 예산: 키 없음(IP당) 또는 로그인 사용자당 분당 120단위, 프리미엄은 분당 600단위. 저렴한 카탈로그 읽기는 1단위, 업스트림 부하가 큰 통계는 3–5, 체크아웃은 10입니다. RATE_LIMITED 오류 발생 시 표시된 초 수만큼 백오프하십시오.
규칙
- 모든 파일 크기는 압축(zstd) 바이트입니다; 시장 가치는 USD, 판매 가격은 EUR입니다.
- 분 단위 데이터는 업스트림에서 약 30일 동안 보관됩니다; 시간/일별 집계는 더 오래 거슬러 올라갑니다.
- 틱 파일은 전체 일별 JSON-lines 캡처입니다(오더북 스냅샷 및 업데이트, 거래, 청산, 자금 조달, 마크/인덱스 포함 옵션 그릭스). 형식 참조: 시장 데이터 프로토콜.
관련 자료
- 틱 파일 파싱을 위한 에이전트 스킬:
cryptostruct-market-data(zip) - 스킬 검색 인덱스:
/.well-known/agent-skills/index.json - API 카탈로그(RFC 9727):
/.well-known/api-catalog llms.txt: https://cryptostruct.com/llms.txt
지원
질문 또는 문제: https://cryptostruct.com/contact