API-Dokumentation

API-Test- und Sandbox-Umgebungsleitfaden

Meistern Sie das Testen mit der umfassenden Sandbox-Umgebung von Smart Money API. Entwickeln Sie risikofrei mit realistischen Testdaten, deterministischen Antworten und großzügigen Rate Limits für Experimente.

Veröffentlicht am 21. März 2026 • 14 Min. Lesezeit • Entwicklung

Übersicht über die Sandbox-Umgebung

Smart Money API bietet eine voll ausgestattete Sandbox-Umgebung für Entwicklung und Tests. Die Sandbox spiegelt die Produktions-API-Struktur wider, verwendet jedoch synthetische Daten und großzügige Rate Limits, sodass Sie sicher entwickeln können, bevor Sie live gehen.

Wesentliche Merkmale:

  • Identisch zur Produktion — Dieselben Endpunkte, Authentifizierung, Antwortformat
  • Nur Testdaten — Beeinflusst keine echten Konten oder Live-Märkte
  • Hohe Rate Limits — 10.000 Anfragen/Stunde gegenüber 1.000 in der Produktion
  • Deterministische Antworten — Konsistente Testdaten für reproduzierbare Tests
  • Isolierte Konten — Getrennt von Produktionsbenutzerdaten

Beste Praxis: Alle Entwicklungs-, Test- und Staging-Aktivitäten sollten die Sandbox-Umgebung nutzen. Verwenden Sie die Produktion erst nach gründlicher Sandbox-Validierung.

Sandbox-Funktionen

Realistische Testdaten

Die Sandbox enthält realistische Kryptowährungs-Marktdaten, die sich nicht zufällig ändern:

  • Historische Marktdaten (6 Monate realistische OHLCV-Daten)
  • Feste Whale-Wallet-Adressen mit konsistenten Bewegungsmustern
  • Stabile Funding-Rates, die stündlich zurückgesetzt werden
  • Deterministische Liquidationsmuster zum Testen von Edge Cases

Testspezifische Funktionen

Testfunktionen
// Deterministische Testsymbole
// Alle Testsymbole beginnen mit TEST_
TEST_BTC, TEST_ETH, TEST_SOL usw.
// Magische Zeitstempel zur Simulation von Szenarien
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Gibt feste Testdaten zurück
// Erzwinge Fehler zum Testen der Fehlerbehandlung
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Test-Hilfsmittel

  • Daten zurücksetzen — Setzt alle Testkonten auf den Ausgangszustand zurück
  • Zeitsteuerung — Simuliert verschiedene Marktbedingungen
  • Fehlerinjektion — Erzwingt spezifische Fehlerantworten
  • Rate-Limit-Tests — Löst Rate-Limit-Antworten aus
Holen Sie sich Ihren API-Schlüssel in 30 Sekunden

Bereit zum Entwickeln? Holen Sie sich einen kostenlosen API-Schlüssel (200 Aufrufe/Tag, keine Karte) und beginnen Sie mit dem Abruf von Live-Daten zu Whales, Funding und On-Chain.

API-Schlüssel anfordern →

Test-Zugangsdaten

Test-API-Schlüssel erhalten

Erstellen Sie ein Testkonto über das Dashboard, um Sandbox-API-Schlüssel zu generieren:

Testschlüssel-Format
// Testschlüssel haben ein anderes Präfix
sk_test_1234567890abcdef // Test-API-Schlüssel
sk_live_1234567890abcdef // Produktions-API-Schlüssel
// Leitet automatisch zur entsprechenden Umgebung weiter
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Leitet automatisch zur Sandbox weiter

Vorkonfigurierte Testschlüssel

Verwenden Sie diese öffentlichen Testschlüssel für schnelle Experimente (Rate-Limit):

Schlüssel Berechtigungen Limit
sk_test_demo Nur Lesen 100/Stunde
sk_test_trader Lesen + Alarme 500/Stunde
sk_test_pro Voller Zugriff 5000/Stunde

Verwenden Sie Testschlüssel niemals in der Produktion. Sie haben eingeschränkte Funktionalität und Rate Limits.

Testdaten und Fixtures

Verfügbare Testsymbole

Die Sandbox enthält diese Test-Trading-Paare mit realistischen historischen Daten:

Testsymbole
// Kryptowährungspaare
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Testsymbole abfragen
GET /v1/symbols?test_only=true

Test-Whale-Wallets

Vorkonfigurierte Test-Wallets mit deterministischem Verhalten:

  • Akkumulator-Wallet — Kauft konsequent, gut für bullische Tests
  • Distributor-Wallet — Verkauft konsequent, gut für bärische Tests
  • Oszillator-Wallet — Wechselt zwischen Kauf/Verkauf, gut für Range-Bound-Tests
  • Volatilitäts-Wallet — Zufällige große Transaktionen für Stresstests

Testdaten zurücksetzen

Testdaten zurücksetzen
// Setzt alle Testkonten auf den Ausgangszustand zurück
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Bestimmte Ressource zurücksetzen
POST /v1/test/reset?resource=whales
// Antwort
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox-Endpunkte

Basis-URLs

Umgebungs-URLs
// Sandbox (Testmodus)
https://api-test.smartmoney.io/v1
// Oder Query-Parameter verwenden
https://api.smartmoneyapi.com/v1?environment=sandbox
// Produktion (Live-Modus)
https://api.smartmoneyapi.com/v1

Nur-Sandbox-Endpunkte

Endpunkt Zweck
POST /test/reset Testdaten auf Ausgangszustand zurücksetzen
POST /test/inject-error Spezifischen Fehler zum Testen einspielen
POST /test/simulate-time Verschiedene Marktbedingungen simulieren
GET /test/status Sandbox-Umgebungsstatus prüfen

Antwort-Simulation

Testfehler einspielen

Erzwinge spezifische Fehlerantworten zum Testen der Ausnahmebehandlung:

Fehlerinjektion
// Teste Ratenlimit-Behandlung
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Teste Dienstverfügbarkeit
GET /v1/whales?X-Test-Error=service_unavailable
// Teste Authentifizierungsfehler
GET /v1/whales?X-Test-Error=invalid_key
// Teste Timeout
GET /v1/whales?X-Test-Error=timeout

Verfügbare Testfehler

Fehlercode HTTP-Status Anwendungsfall
invalid_key 401 Auth-Fehlerbehandlung
rate_limit_exceeded 429 Backoff-Logik-Test
not_found 404 Fehlende-Ressourcen-Behandlung
service_unavailable 503 Wiederholungslogik-Test
timeout 504 Timeout-Behandlung

Sandbox-Ratenlimits

Ratenlimit-Stufen

Umgebung Limit/Stunde Burst Zweck
Sandbox 10,000 500/min Entwicklung & Tests
Produktion Free 1,000 50/min Hobbyprojekte
Produktion Trader 10,000 400/min Professioneller Handel
Produktion Pro 50,000 1000/min Hochfrequenzsysteme

Testen der Ratenlimit-Behandlung

Ratenlimit-Tests
// Ratenlimit-Antwort in Sandbox auslösen
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Antwort enthält Wiederholungs-Header
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Teststrategien

Unit-Tests mit Fixtures

Python-Unit-Test
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())

Integrationstests

Teste vollständigen Workflow in Sandbox vor Produktionsbereitstellung:

  1. Bereitstellung in Staging mit Sandbox-Zugangsdaten
  2. Führe vollständigen Testlauf gegen Sandbox durch
  3. Teste Fehlerbehandlung mit Fehlerinjektion
  4. Überprüfe Ratenlimit-Verhalten
  5. Prüfe Antwortzeit und Latenz
  6. Erst dann in Produktion bereitstellen

Lasttests

Lasttest mit Apache Bench
// Sandbox erlaubt Hochlasttests
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD-Integration

GitHub-Actions-Beispiel

.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/

Umgebungskonfiguration

Verwenden Sie Umgebungsvariablen, um zwischen Sandbox und Produktion zu wechseln:

Umgebungseinrichtung
// .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

Fehlerbehebung

Häufige Probleme

Testschlüssel funktioniert nicht

Problem: Erhalte 401 Unauthorized mit Testschlüssel

Lösungen:

  • Überprüfen Sie, ob der Schlüssel mit sk_test_ beginnt (nicht sk_live_)
  • Überprüfen Sie das Format des Authorization-Headers: "Bearer sk_test_xxx"
  • Stellen Sie sicher, dass Sie den Test-Endpunkt verwenden: api-test.smartmoney.io
  • Der Testschlüssel könnte das Rate-Limit überschritten haben

Daten werden nicht zurückgesetzt

Problem: Testdaten werden nach POST /test/reset nicht zurückgesetzt

Lösungen:

  • Der Reset kann bis zu 30 Sekunden dauern
  • Überprüfen Sie den Sandbox-Status mit GET /test/status
  • Stellen Sie sicher, dass Sie den richtigen Test-API-Schlüssel verwenden
  • Kontaktieren Sie den Support, falls das Problem bestehen bleibt

Rate-Limits in der Sandbox

Problem: Rate-Limits in der Sandbox werden erreicht (sollte nicht passieren)

Lösungen:

  • Überprüfen Sie, ob Sie den sk_test_pro-Schlüssel verwenden (10.000/Stunde)
  • Überprüfen Sie den X-RateLimit-Remaining-Header
  • Warten Sie auf die Stundengrenze oder verwenden Sie ein anderes Testkonto
  • Kontaktieren Sie den Support für eine temporäre Erhöhung des Rate-Limits

Starten Sie noch heute mit dem Testen

Nutzen Sie unsere umfassende Sandbox-Umgebung für sichere, isolierte Entwicklung. Deterministische Testdaten, hohe Rate-Limits und vollständige Feature-Parität mit der Produktion.

Testzugangsdaten erhalten
Alle Pläne beinhalten Sandbox-Zugang. Keine zusätzlichen Kosten.

Verwandte Ressourcen

Authentifizierungsleitfaden →

API-Authentifizierung und Schlüsselverwaltung

REST-API-Referenz →

Vollständige API-Endpunkt-Dokumentation

Fehlercodes →

Fehlerbehandlung und Antwortcodes
Kostenlos starten — 200 Aufrufe/Tag, keine Karte

Erhalten Sie Live-Whale-Flow, Funding, Open Interest und On-Chain-Daten von 3 Börsen über eine API. Kostenlose Stufe, keine Kreditkarte, jederzeit upgraden.

Kostenlos starten →
Probieren Sie die Live-API-Konsole → (kein Konto erforderlich)