मुख्य सामग्री पर जाएँ

एजेंट्स के लिए खुला

GADUIN एक Model Context Protocol सर्वर चलाता है, जिससे LLM एजेंट और ट्रेडिंग बॉट आपकी ओर से लाइव मार्केट, पोज़िशन और बैलेंस पढ़ सकते हैं।

MCP क्या है?

Model Context Protocol LLM क्लाइंट्स को बाहरी डेटा और टूल्स से जोड़ने के लिए एक ओपन स्टैंडर्ड है। GADUIN एक MCP एंडपॉइंट उपलब्ध कराता है, जिससे कोई भी MCP-कम्पैटिबल क्लाइंट — Claude Desktop, Claude.ai, कस्टम एजेंट — उपयोगकर्ता द्वारा जारी की गई API कुंजी के साथ कनेक्ट कर सकता है। हर कॉल प्रमाणित होती है और उसी उपयोगकर्ता तक सीमित होती है जिसने कुंजी जारी की है।

उपलब्ध टूल्स

v1 टूल कैटलॉग केवल-पढ़ने योग्य है। हर टूल अपना इनपुट स्कीमा खुद प्रकाशित करता है और LLM क्लाइंट उसे स्वचालित रूप से वायर कर लेता है — आपको हाथ से JSON लिखने की ज़रूरत नहीं।

  • list_markets

    वास्तविक परिवहन परिणामों (उड़ान देरी, ट्रेन रद्दीकरण, समुद्री चोकपॉइंट थ्रूपुट) पर खुले प्रेडिक्शन मार्केट्स सूचीबद्ध करता है। वैकल्पिक इनपुट: category (FLIGHT, TRAIN, SHIP), status (डिफ़ॉल्ट OPEN), limit (1–100)। मार्केट id, श्रेणी, सवाल, मौजूदा कीमतों के साथ परिणाम, कुल वॉल्यूम और क्लोज़ टाइम लौटाता है।

  • get_market

    id से एक मार्केट लाता है, मौजूदा भाव और परिणामों सहित। इनपुट: id (मार्केट UUID)।

  • get_my_positions

    सभी मार्केट्स में प्रमाणित उपयोगकर्ता की खुली पोज़िशन्स सूचीबद्ध करता है। कोई इनपुट नहीं। market_id, outcome_idx, धारित शेयर्स और कुल कॉस्ट बेसिस लौटाता है।

  • get_balance

    प्रमाणित उपयोगकर्ता का मौजूदा डॉलर बैलेंस string के रूप में लौटाता है। कोई इनपुट नहीं।

ट्रेडिंग फ़िलहाल केवल REST के माध्यम से

ट्रेड करना, जमा करना और निकासी जानबूझकर अभी MCP से उपलब्ध नहीं हैं — MCP-संचालित ट्रेड का जोखिम पढ़ने से अधिक है, और हम चाहते हैं कि UX सिद्ध होने तक मनुष्य लूप में रहे। प्रोग्रामेटिक ट्रेडिंग सीमित स्कोप वाली API कुंजी के साथ REST API के माध्यम से उपलब्ध है।

क्लाइंट कनेक्ट करें

  1. 1.साइन अप करें और अपना खाता सत्यापित करें।
  2. 2.अपनी खाता सेटिंग्स से एक API कुंजी जनरेट करें — MCP के लिए read स्कोप पर्याप्त है।
  3. 3.नीचे दिया गया स्निपेट अपने MCP-कम्पैटिबल क्लाइंट में पेस्ट करें और अपनी कुंजी डालें।
एंडपॉइंट
https://gaduin.com/mcp
Authorization
Bearer YOUR_API_KEY
Claude Desktop कॉन्फ़िग
{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

macOS पर ~/Library/Application Support/Claude/claude_desktop_config.json में पेस्ट करें, अपनी API कुंजी डालें, फिर Claude रीस्टार्ट करें।

Endpoint reference

सीधे खुद इंटीग्रेट करना चाहते हैं? नीचे Model Context Protocol एंडपॉइंट और अनाम, केवल-पढ़ने वाला REST API दिया गया है — वही मार्केट, ऑर्डर बुक और कीमतें जो साइट और MCP सर्वर देते हैं।

MCP endpoint
https://gaduin.com/mcp
REST read API (base URL)
https://gaduin.com/api/v1
  • GET /markets

    खुले मार्केट की सूची। श्रेणी (FLIGHT, TRAIN, SHIP) और स्टेटस के हिसाब से फ़िल्टर करें, और limit तथा cursor से नतीजों के पेज देखें।

  • GET /markets/{id}

    किसी एक मार्केट को id से लाएँ, उसके सेटलमेंट नियम और साक्ष्य समेत।

  • GET /markets/{id}/book

    किसी मार्केट का ऑर्डर-बुक स्नैपशॉट।

  • GET /markets/{id}/trades

    किसी मार्केट के हालिया ट्रेड।

  • GET /markets/{id}/price-history

    किसी मार्केट के ऐतिहासिक कीमत स्नैपशॉट।

  • GET /markets/positions

    हर मार्केट में लाइव कुल पोज़िशन।

  • GET /markets/config

    ट्रेडिंग की सीमाएँ — न्यूनतम और अधिकतम ट्रेड राशि।

  • GET /healthz

    Liveness probe.

मशीन-पठनीय डिस्कवरी

एजेंट को यह पेज स्क्रैप करने की ज़रूरत नहीं है। ऊपर बताई गई हर क्षमता साइट रूट से दिए जाने वाले एक मानक-आधारित दस्तावेज़ में भी वर्णित है, ताकि MCP या OpenAPI समझने वाला क्लाइंट मार्केट, API और ऑथेंटिकेशन का तरीका खुद खोज सके।

  • /.well-known/mcp/server-card.json

    MCP Server Card (SEP-1649) — Model Context Protocol एंडपॉइंट, उसका ट्रांसपोर्ट, और ऑथेंटिकेशन का तरीका।

  • /.well-known/openapi.json

    अनाम, केवल-पढ़ने वाले REST API का OpenAPI 3.1 विवरण।

  • /.well-known/api-catalog

    API Catalog (RFC 9727) — वह लिंकसेट जो हर मशीन-पठनीय सतह को आपस में जोड़ता है।

  • /.well-known/oauth-protected-resource

    OAuth 2.0 Protected Resource Metadata (RFC 9728) — कौन-सा ऑथराइज़ेशन सर्वर API टोकन जारी करता है, और उन पर कौन-से स्कोप होते हैं।

  • /.well-known/oauth-authorization-server

    OAuth 2.0 Authorization Server Metadata (RFC 8414) — इशुअर, टोकन एंडपॉइंट, और API-key से टोकन वाला ग्रांट।

  • /.well-known/agent-skills/index.json

    Agent Skills इंडेक्स — वे SKILL.md गाइड जिन्हें कोई एजेंट लाकर सीख सकता है कि प्लेटफ़ॉर्म के साथ कैसे काम करना है, हर एक डाइजेस्ट से पिन किया हुआ।

  • /api/md

    कंटेंट नेगोशिएशन के ज़रिए किसी भी सार्वजनिक पेज का Markdown रेंडरिंग (Accept: text/markdown भेजें)।

  • /auth.md

    ऑथेंटिकेशन करने और स्कोप वाला API key बनाने की, इंसान और एजेंट दोनों के पढ़ने लायक, चरण-दर-चरण जानकारी।

शुरू करेंAPI कुंजियाँ प्रबंधित करें