CryptoStruct

Server MCP CryptoStruct

Server MCP jarak jauh pihak pertama untuk cryptostruct.com — data historis kripto dan pasar prediksi (file harian tingkat tick dari 35 venue termasuk Kalshi dan Polymarket) serta statistik pasar langsung, dibangun untuk trader, quant, dan agen AI.

Repositori ini mendokumentasikan server yang dihosting. Tidak ada yang perlu diinstal atau dijalankan dari sini — server dioperasikan oleh CryptoStruct.

• Endpoint: https://cryptostruct.com/mcp (Streamable HTTP, tanpa status, mode JSON)
• Endpoint OAuth: https://cryptostruct.com/mcp/auth (alat yang sama; merespons 401 + WWW-Authenticate untuk memicu alur OAuth standar — Dynamic Client Registration + PKCE)
• Kartu server: /.well-known/mcp/server-card.json
• Dokumentasi: https://cryptostruct.com/docs/mcp · Dokumentasi produk: https://docs.cryptostruct.com

Tidak diperlukan API key — katalog, statistik pasar, dan alur pembelian tamu berfungsi tanpa kunci. Masuk melalui OAuth (opsional) menautkan akun CryptoStruct Anda untuk riwayat pesanan, unduhan file yang dibeli, dan penukaran kredit otomatis.

Memulai dengan cepat

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 / konfigurasi JSON generik

{
  "mcpServers": {
    "cryptostruct": {
      "url": "https://cryptostruct.com/mcp"
    }
  }
}

claude.ai — Pengaturan → Konektor → Tambahkan konektor kustom → https://cryptostruct.com/mcp/auth

Yang dapat Anda lakukan

• Katalog & penemuan: cari ~500 ribu instrumen di 35 venue (spot, perpetual, futures, opsi, pasar prediksi), cakupan arsip tingkat hari hingga 2021-02-08.
• Pasar prediksi: kontrak acara Kalshi dan Polymarket adalah instrumen kelas satu — dapat dicari di katalog (class=prediction), dengan cakupan, snapshot langsung, dan agregat menit/harian seperti instrumen kripto lainnya. Kontrak dikutip 0..1 (USD); turnover dinormalisasi ke USD.
• Statistik pasar: snapshot langsung dan agregat menit/jam/harian — OHLC, VWAP, perdagangan, turnover, spread, kedalaman top-of-book; kurva selip / dampak pasar.
• Membeli data: file tick mentah — instrumen kripto dan pasar prediksi — berharga €1 per instrumen-hari. Server menyerahkan URL checkout Stripe — pembayaran selalu terjadi di browser pengguna, server tidak pernah menyentuh kredensial pembayaran. File sampel gratis satu hari penuh tersedia tanpa pembelian apa pun.
• Alat akun (masuk OAuth): daftar pesanan, dapatkan URL unduhan untuk file yang dibeli, periksa langganan & saldo kredit. Checkout menerapkan kredit Premium secara otomatis.

Alat

Alat	Deskripsi	Tingkat
get_data_dictionary	Kamus data & referensi produk (format file, satuan, harga)	gratis
search_instruments	Cari katalog instrumen	gratis
list_venues	Daftar venue yang tercakup	gratis
get_instrument	Detail instrumen	gratis
get_coverage	Cakupan arsip tingkat hari untuk sebuah instrumen	gratis
list_sample_files	File sampel gratis satu hari penuh	gratis
get_price_quote	Kutipan harga untuk sekumpulan file data	gratis
get_market_snapshot	Snapshot pasar langsung (60 menit + 24 jam)	gratis
get_daily_stats	Agregat harian (30h–180h gratis; 365h/maks Premium)	gratis
get_hourly_stats	Agregat per jam (7h–90h gratis; 180h Premium)	gratis
get_slippage	Kurva selip / dampak pasar (1 jam gratis; 24 jam/7h Premium)	gratis
get_top_instruments	Instrumen teratas berdasarkan turnover 24 jam langsung	gratis
get_movers	Pergerakan 24 jam (naik & turun)	gratis
get_minutes_range	Seri menit historis untuk studi peristiwa	premium
create_checkout	Buat checkout Stripe untuk file data (serah URL)	commerce
get_checkout_status	Poll session checkout	commerce
get_order_files	Daftar file pesanan berbayar dengan URL unduhan	commerce
request_file_restore	Pulihkan file yang diarsipkan (cold-storage)	commerce
list_my_orders	Pesanan saya	masuk
get_my_files	File yang saya beli	masuk
get_my_subscription	Langganan & saldo kredit saya	masuk

Tingkat: free/commerce berfungsi tanpa kunci. sign-in memerlukan masuk OAuth terverifikasi (akun apa pun). Alat/parameter premium memerlukan CryptoStruct Premium (€20/bulan) — yang juga membuka jendela statistik lebih lama (harian 365h/maks, per jam 180h, selip 24 jam/7h), batas pencarian lebih besar, blok kualitas data di get_market_snapshot, dan anggaran panggilan 5×. Panggilan di luar tingkat Anda mengembalikan error statis AUTH_REQUIRED / PREMIUM_REQUIRED dengan URL upgrade — tidak pernah menjadi kegagalan keras.

Batas kecepatan

Anggaran per pemanggil berbobot: 120 unit/menit tanpa kunci (per IP) atau per pengguna yang masuk, 600 unit/menit untuk Premium. Pembacaan katalog murah berbiaya 1 unit, statistik berat upstream 3–5, checkout 10. Pada error RATE_LIMITED, mundur selama jumlah detik yang ditunjukkan.

Konvensi

• Semua ukuran file adalah byte terkompresi (zstd); nilai pasar dalam USD; harga jual dalam EUR.
• Data granularitas menit disimpan ~30 hari di upstream; agregat per jam/harian menjangkau lebih jauh ke belakang.
• File tick adalah tangkapan JSON-lines satu hari penuh (snapshot & pembaruan orderbook, perdagangan, likuidasi, funding, mark/index termasuk greeks opsi). Referensi format: Market Data Protocol.

Terkait

• Agent Skill untuk mengurai file tick: cryptostruct-market-data (zip)
• Indeks penemuan skills: /.well-known/agent-skills/index.json
• Katalog API (RFC 9727): /.well-known/api-catalog
• llms.txt: https://cryptostruct.com/llms.txt

Dukungan

Pertanyaan atau masalah: https://cryptostruct.com/contact