एपीआई डॉक्युमेंटेशन

एपीआई टेस्टिंग और सैंडबॉक्स एनवायरनमेंट गाइड

स्मार्ट मनी एपीआई के व्यापक सैंडबॉक्स एनवायरनमेंट के साथ टेस्टिंग में महारत हासिल करें। यथार्थवादी टेस्ट डेटा, निर्धारित प्रतिक्रियाएं और प्रयोग के लिए उदार रेट लिमिट का उपयोग करके जोखिम-मुक्त विकास करें।

21 मार्च, 2026 को प्रकाशित • 14 मिनट का पठन • डेवलपमेंट

सैंडबॉक्स एनवायरनमेंट अवलोकन

स्मार्ट मनी एपीआई डेवलपमेंट और टेस्टिंग के लिए एक पूर्ण-विशेषताओं वाला सैंडबॉक्स एनवायरनमेंट प्रदान करता है। सैंडबॉक्स प्रोडक्शन एपीआई संरचना को दर्शाता है लेकिन सिंथेटिक डेटा और उदार रेट लिमिट का उपयोग करता है, जिससे आप लाइव जाने से पहले आत्मविश्वास से विकास कर सकते हैं।

मुख्य विशेषताएँ:

  • प्रोडक्शन के समान — समान एंडपॉइंट्स, प्रमाणीकरण, प्रतिक्रिया प्रारूप
  • केवल टेस्ट डेटा — वास्तविक खातों या लाइव मार्केट को प्रभावित नहीं करता
  • उच्च रेट लिमिट्स — 10,000 अनुरोध/घंटा बनाम प्रोडक्शन में 1,000
  • निर्धारित प्रतिक्रियाएं — पुनरुत्पादन योग्य टेस्टिंग के लिए सुसंगत टेस्ट फिक्स्चर
  • अलग-थलग खाते — प्रोडक्शन यूजर डेटा से अलग

सर्वोत्तम अभ्यास: सभी डेवलपमेंट, टेस्टिंग और स्टेजिंग के लिए सैंडबॉक्स एनवायरनमेंट का उपयोग करें। केवल पूर्ण सैंडबॉक्स वैलिडेशन के बाद ही प्रोडक्शन का उपयोग करें।

सैंडबॉक्स फीचर्स

यथार्थवादी टेस्ट डेटा

सैंडबॉक्स में यथार्थवादी क्रिप्टोकरेंसी मार्केट डेटा शामिल है जो यादृच्छिक रूप से नहीं बदलता:

  • ऐतिहासिक मार्केट डेटा (6 महीने का यथार्थवादी OHLCV)
  • स्थिर व्हेल वॉलेट पते जिनमें सुसंगत गति पैटर्न हैं
  • स्थिर फंडिंग रेट्स जो प्रति घंटे रीसेट होते हैं
  • एज केस टेस्टिंग के लिए निर्धारित लिक्विडेशन पैटर्न

टेस्ट-विशिष्ट फीचर्स

टेस्ट फीचर्स
// निर्धारित टेस्ट सिंबल्स
// सभी टेस्ट सिंबल्स TEST_ से शुरू होते हैं
TEST_BTC, TEST_ETH, TEST_SOL, आदि।
// परिदृश्यों को सिम्युलेट करने के लिए मैजिक टाइमस्टैम्प्स
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // निश्चित टेस्ट डेटा लौटाता है
// एक्सेप्शन हैंडलिंग टेस्टिंग के लिए त्रुटियों को फोर्स करें
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

टेस्ट यूटिलिटीज

  • डेटा रीसेट — सभी टेस्ट खातों को प्रारंभिक स्थिति में रीसेट करें
  • समय नियंत्रण — विभिन्न मार्केट स्थितियों को सिम्युलेट करें
  • त्रुटि इंजेक्शन — विशिष्ट त्रुटि प्रतिक्रियाओं को फोर्स करें
  • रेट लिमिट टेस्टिंग — रेट लिमिट प्रतिक्रियाओं को ट्रिगर करें
30 सेकंड में अपना एपीआई कुंजी प्राप्त करें

बिल्ड करने के लिए तैयार हैं? एक मुफ्त एपीआई कुंजी प्राप्त करें (50 कॉल/दिन, कोई कार्ड नहीं) और लाइव व्हेल, फंडिंग और ऑन-चेन डेटा खींचना शुरू करें।

अपना एपीआई कुंजी प्राप्त करें →

टेस्ट क्रेडेंशियल्स

टेस्ट एपीआई कुंजी प्राप्त करना

डैशबोर्ड के माध्यम से एक टेस्ट खाता बनाकर सैंडबॉक्स एपीआई कुंजी जनरेट करें:

टेस्ट कुंजी प्रारूप
// टेस्ट कुंजियों में अलग प्रीफिक्स होता है
sk_test_1234567890abcdef // टेस्ट एपीआई कुंजी
sk_live_1234567890abcdef // प्रोडक्शन एपीआई कुंजी
// स्वचालित रूप से उपयुक्त वातावरण पर रूट करता है
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# स्वचालित रूप से सैंडबॉक्स पर रूट करता है

पूर्व-कॉन्फ़िगर टेस्ट कुंजी

त्वरित प्रयोग के लिए इन सार्वजनिक टेस्ट कुंजियों का उपयोग करें (रेट लिमिटेड):

कुंजी अनुमतियाँ लिमिट
sk_test_demo सभी पढ़ें 100/घंटा
sk_test_trader पढ़ें + अलर्ट्स 500/घंटा
sk_test_pro पूर्ण पहुंच 5000/घंटा

प्रोडक्शन में टेस्ट कुंजियों का उपयोग कभी न करें। उनकी कार्यक्षमता और रेट लिमिट सीमित हैं।

टेस्ट डेटा और फिक्स्चर्स

उपलब्ध टेस्ट सिंबल्स

सैंडबॉक्स में यथार्थवादी ऐतिहासिक डेटा के साथ ये टेस्ट ट्रेडिंग पेयर्स शामिल हैं:

टेस्ट सिंबल्स
// क्रिप्टोकरेंसी पेयर्स
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// टेस्ट सिंबल्स को क्वेरी करें
GET /v1/symbols?test_only=true

टेस्ट व्हेल वॉलेट्स

निर्धारित व्यवहार के साथ पूर्व-कॉन्फ़िगर टेस्ट वॉलेट्स:

  • एक्यूमुलेटर वॉलेट — लगातार खरीदता है, बुलिश टेस्टिंग के लिए अच्छा
  • डिस्ट्रीब्यूटर वॉलेट — लगातार बेचता है, बेयरिश टेस्टिंग के लिए अच्छा
  • ऑसिलेटर वॉलेट — खरीद/बिक्री बारी-बारी से करता है, रेंज-बाउंड टेस्टिंग के लिए अच्छा
  • वोलैटिलिटी वॉलेट — स्ट्रेस टेस्टिंग के लिए यादृच्छिक बड़े लेन-देन

टेस्ट डेटा रीसेट करना

टेस्ट डेटा रीसेट करें
// सभी टेस्ट खातों को प्रारंभिक स्थिति में रीसेट करें
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// विशिष्ट संसाधन को रीसेट करें
POST /v1/test/reset?resource=whales
// प्रतिक्रिया
{
"status": "reset_complete",
"timestamp": 1709980800000
}

सैंडबॉक्स एंडपॉइंट्स

बेस URL

एनवायरनमेंट URL
// सैंडबॉक्स (टेस्ट मोड)
https://api-test.smartmoney.io/v1
// या क्वेरी पैरामीटर का उपयोग करें
https://api.smartmoneyapi.com/v1?environment=sandbox
// प्रोडक्शन (लाइव मोड)
https://api.smartmoneyapi.com/v1

केवल सैंडबॉक्स के लिए एंडपॉइंट्स

एंडपॉइंट उद्देश्य
POST /test/reset टेस्ट डेटा को प्रारंभिक स्थिति में रीसेट करें
POST /test/inject-error परीक्षण के लिए विशिष्ट त्रुटि इंजेक्ट करें
POST /test/simulate-time विभिन्न बाजार स्थितियों का अनुकरण करें
GET /test/status सैंडबॉक्स पर्यावरण की स्वास्थ्य जांच करें

प्रतिक्रिया मॉकिंग

टेस्ट त्रुटियों को इंजेक्ट करना

एक्सेप्शन हैंडलिंग परीक्षण के लिए विशिष्ट त्रुटि प्रतिक्रियाएं बाधित करें:

त्रुटि इंजेक्शन
// टेस्ट रेट लिमिट हैंडलिंग
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// सेवा अनुपलब्धता का परीक्षण
GET /v1/whales?X-Test-Error=service_unavailable
// प्रमाणीकरण विफलता का परीक्षण
GET /v1/whales?X-Test-Error=invalid_key
// टाइमआउट का परीक्षण
GET /v1/whales?X-Test-Error=timeout

उपलब्ध टेस्ट त्रुटियां

त्रुटि कोड HTTP स्थिति उपयोग मामला
invalid_key 401 प्रमाणीकरण त्रुटि हैंडलिंग
rate_limit_exceeded 429 बैकऑफ लॉजिक परीक्षण
not_found 404 लापता संसाधन हैंडलिंग
service_unavailable 503 पुनः प्रयास लॉजिक परीक्षण
timeout 504 टाइमआउट हैंडलिंग

सैंडबॉक्स रेट लिमिट्स

रेट लिमिट टियर्स

एनवायरनमेंट लिमिट/घंटा बर्स्ट उद्देश्य
सैंडबॉक्स 10,000 500/मिनट विकास और परीक्षण
प्रोडक्शन फ्री 1,000 50/मिनट हॉबी प्रोजेक्ट्स
प्रोडक्शन ट्रेडर 10,000 400/मिनट पेशेवर ट्रेडिंग
प्रोडक्शन प्रो 50,000 1000/मिनट हाई-फ्रीक्वेंसी सिस्टम्स

रेट लिमिट हैंडलिंग का परीक्षण

रेट लिमिट टेस्टिंग
// सैंडबॉक्स में रेट लिमिट प्रतिक्रिया ट्रिगर करें
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// प्रतिक्रिया में रिट्राई हेडर्स शामिल हैं
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

परीक्षण रणनीतियां

फिक्स्चर के साथ यूनिट टेस्टिंग

पायथन यूनिट टेस्ट
import unittest
import requests
class TestSmartMoneyAPI(unittest.TestCase):
def setUp(self):
self.api_key = 'sk_test_demo'
self.base_url = 'https://api-test.smartmoney.io/v1'
def test_whale_tracking(self):
response = requests.get(
f'{self.base_url}/whales/TEST_BTC',
headers={'Authorization': f'Bearer {self.api_key}'}
)
self.assertEqual(response.status_code, 200)
self.assertIn('whales', response.json())

इंटीग्रेशन टेस्टिंग

प्रोडक्शन डिप्लॉयमेंट से पहले सैंडबॉक्स में पूर्ण वर्कफ्लो का परीक्षण करें:

  1. सैंडबॉक्स क्रेडेंशियल्स के साथ स्टेजिंग पर डिप्लॉय करें
  2. सैंडबॉक्स के खिलाफ पूर्ण टेस्ट सूट चलाएं
  3. त्रुटि इंजेक्शन के साथ त्रुटि हैंडलिंग का परीक्षण करें
  4. रेट लिमिटिंग व्यवहार सत्यापित करें
  5. प्रतिक्रिया समय और विलंबता की जांच करें
  6. तभी प्रोडक्शन में प्रमोट करें

लोड टेस्टिंग

अपाचे बेंच के साथ लोड टेस्ट
// सैंडबॉक्स हाई लोड टेस्टिंग की अनुमति देता है
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD इंटीग्रेशन

GitHub Actions उदाहरण

.github/workflows/test.yml
name: API Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- run: pip install requests pytest
- env:
SMARTMONEY_API_KEY: ${{ secrets.TEST_API_KEY }}
SMARTMONEY_ENV: sandbox
run: pytest tests/

एनवायरनमेंट कॉन्फ़िगरेशन

सैंडबॉक्स और प्रोडक्शन के बीच स्विच करने के लिए पर्यावरण चर का उपयोग करें:

पर्यावरण सेटअप
// .env.sandbox
SMARTMONEY_API_KEY=sk_test_demo
SMARTMONEY_API_URL=https://api-test.smartmoney.io/v1
SMARTMONEY_ENV=sandbox
// .env.production
SMARTMONEY_API_KEY=sk_live_xxxx
SMARTMONEY_API_URL=https://api.smartmoneyapi.com/v1
SMARTMONEY_ENV=production

समस्या निवारण

सामान्य समस्याएं

टेस्ट कुंजी काम नहीं कर रही

समस्या: टेस्ट कुंजी के साथ 401 अनधिकृत प्राप्त हो रहा है

समाधान:

  • सुनिश्चित करें कि कुंजी sk_test_ से शुरू होती है (sk_live_ नहीं)
  • प्राधिकरण हेडर प्रारूप की जांच करें: "Bearer sk_test_xxx"
  • सुनिश्चित करें कि टेस्ट एंडपॉइंट का उपयोग कर रहे हैं: api-test.smartmoney.io
  • टेस्ट कुंजी की दर सीमा पार हो सकती है

डेटा रीसेट नहीं हो रहा

समस्या: POST /test/reset के बाद टेस्ट डेटा रीसेट नहीं हो रहा

समाधान:

  • रीसेट को प्रसारित होने में 30 सेकंड तक का समय लग सकता है
  • GET /test/status के साथ सैंडबॉक्स स्थिति की जांच करें
  • सुनिश्चित करें कि सही टेस्ट API कुंजी का उपयोग कर रहे हैं
  • यदि समस्या बनी रहती है तो समर्थन से संपर्क करें

सैंडबॉक्स में दर सीमाएं

समस्या: सैंडबॉक्स में दर सीमाएं पार हो रही हैं (ऐसा नहीं होना चाहिए)

समाधान:

  • सुनिश्चित करें कि sk_test_pro कुंजी का उपयोग कर रहे हैं (10,000/घंटा)
  • X-RateLimit-Remaining हेडर की जांच करें
  • घंटे की सीमा तक प्रतीक्षा करें या अलग टेस्ट खाते का उपयोग करें
  • अस्थायी दर सीमा बढ़ाने के लिए समर्थन से संपर्क करें

आज ही टेस्टिंग शुरू करें

सुरक्षित, अलग विकास के लिए हमारे व्यापक सैंडबॉक्स पर्यावरण का उपयोग करें। निर्धारक टेस्ट डेटा, उच्च दर सीमाएं, और प्रोडक्शन के साथ पूर्ण सुविधा समानता।

टेस्ट क्रेडेंशियल्स प्राप्त करें
सभी योजनाओं में सैंडबॉक्स एक्सेस शामिल है। कोई अतिरिक्त लागत नहीं।

संबंधित संसाधन

प्रमाणीकरण गाइड →

API प्रमाणीकरण और कुंजी प्रबंधन

REST API संदर्भ →

पूर्ण API एंडपॉइंट दस्तावेज़ीकरण

त्रुटि कोड →

त्रुटि हैंडलिंग और प्रतिक्रिया कोड
मुफ्त में शुरू करें — 50 कॉल/दिन, कोई कार्ड नहीं

एक API से 3 एक्सचेंजों पर लाइव व्हेल फ्लो, फंडिंग, ओपन इंटरेस्ट और ऑन-चेन डेटा प्राप्त करें। मुफ्त टियर, कोई क्रेडिट कार्ड नहीं, किसी भी समय अपग्रेड करें।

मुफ्त में शुरू करें →
लाइव API कंसोल आज़माएं → (खाते की आवश्यकता नहीं)