API Documentatie

API Testing en Sandbox Omgeving Gids

Beheers testing met de uitgebreide sandbox omgeving van Smart Money API. Ontwikkel zonder risico met realistische testgegevens, deterministische reacties en royale rate limits voor experimenten.

Gepubliceerd op 21 maart 2026 • 14 min leestijd • Ontwikkeling

Sandbox Omgeving Overzicht

Smart Money API biedt een volwaardige sandbox omgeving voor ontwikkeling en testing. De sandbox spiegelt de productie-API-structuur maar gebruikt synthetische gegevens en royale rate limits, zodat je met vertrouwen kunt ontwikkelen voordat je live gaat.

Belangrijke kenmerken:

  • Identiek aan Productie — Dezelfde endpoints, authenticatie, reactieformaat
  • Alleen Testgegevens — Heeft geen invloed op echte accounts of live markten
  • Hoge Rate Limits — 10.000 requests/uur versus 1.000 in productie
  • Deterministische Reacties — Consistente testgegevens voor reproduceerbare testing
  • Geïsoleerde Accounts — Gescheiden van productiegebruikersgegevens

Beste Praktijk: Alle ontwikkeling, testing en staging moeten de sandbox omgeving gebruiken. Gebruik productie alleen na grondige sandbox-validatie.

Sandbox Functies

Realistische Testgegevens

Sandbox bevat realistische cryptocurrency marktgegevens die niet willekeurig veranderen:

  • Historische marktgegevens (6 maanden realistische OHLCV)
  • Vaste whale wallet-adressen met consistente bewegingen
  • Stabiele funding rates die elk uur resetten
  • Deterministische liquidatiepatronen voor het testen van edge cases

Test-Specifieke Functies

Testfuncties
// Deterministische testsymbolen
// Alle testsymbolen beginnen met TEST_
TEST_BTC, TEST_ETH, TEST_SOL, etc.
// Magische timestamps voor het simuleren van scenario's
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Retourneert vaste testgegevens
// Forceer fouten voor exception handling testing
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Test Utilities

  • Data Reset — Reset alle testaccounts naar initiële staat
  • Tijdcontrole — Simuleer verschillende marktomstandigheden
  • Error Injection — Forceer specifieke foutreacties
  • Rate Limit Testing — Activeer rate limit-reacties
Krijg je API-sleutel in 30 seconden

Klaar om te bouwen? Vraag een gratis API-sleutel aan (200 calls/dag, geen kaart nodig) en begin met het ophalen van live whale, funding en on-chain gegevens.

Vraag je API-sleutel aan →

Test Credentials

Test API-sleutels Aanmaken

Maak een testaccount aan via het dashboard om sandbox API-sleutels te genereren:

Test Key Formaat
// Testkeys hebben een ander voorvoegsel
sk_test_1234567890abcdef // Test API-sleutel
sk_live_1234567890abcdef // Productie API-sleutel
// Routeert automatisch naar de juiste omgeving
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Routeert automatisch naar sandbox

Vooraf Geconfigureerde Test Keys

Gebruik deze openbare testkeys voor snelle experimenten (rate limited):

Key Permissions Limit
sk_test_demo Lees alles 100/uur
sk_test_trader Lezen + alerts 500/uur
sk_test_pro Volledige toegang 5000/uur

Gebruik nooit testkeys in productie. Ze hebben beperkte functionaliteit en rate limits.

Testgegevens en Fixtures

Beschikbare Test Symbols

Sandbox bevat deze test trading pairs met realistische historische gegevens:

Test Symbols
// Cryptocurrency pairs
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Vraag testsymbolen op
GET /v1/symbols?test_only=true

Test Whale Wallets

Vooraf geconfigureerde testwallets met deterministisch gedrag:

  • Accumulator Wallet — Koopt consistent, goed voor bullish testing
  • Distributor Wallet — Verkoopt consistent, goed voor bearish testing
  • Oscillator Wallet — Wisselt koop/verkoop af, goed voor range-bound testing
  • Volatility Wallet — Willekeurige grote transacties voor stresstesting

Testgegevens Resetten

Reset Testgegevens
// Reset alle testaccounts naar initiële staat
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Reset specifieke resource
POST /v1/test/reset?resource=whales
// Reactie
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Sandbox-eindpunten

Basis-URL's

Omgevings-URL's
// Sandbox (testmodus)
https://api-test.smartmoney.io/v1
// Of gebruik queryparameter
https://api.smartmoneyapi.com/v1?environment=sandbox
// Productie (livemodus)
https://api.smartmoneyapi.com/v1

Sandbox-specifieke eindpunten

Eindpunt Doel
POST /test/reset Testgegevens resetten naar initiële staat
POST /test/inject-error Specifieke fout injecteren voor testen
POST /test/simulate-time Verschillende marktomstandigheden simuleren
GET /test/status Sandbox-omgevingsstatus controleren

Responsemocking

Testfouten injecteren

Dwing specifieke foutreacties af voor uitzonderingsafhandelingstesten:

Foutinjectie
// Test afhandeling van snelheidslimiet
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Test service-onbeschikbaarheid
GET /v1/whales?X-Test-Error=service_unavailable
// Test authenticatiefout
GET /v1/whales?X-Test-Error=invalid_key
// Test time-out
GET /v1/whales?X-Test-Error=timeout

Beschikbare testfouten

Foutcode HTTP-status Gebruiksscenario
invalid_key 401 Afhandeling authenticatiefout
rate_limit_exceeded 429 Testen van backoff-logica
not_found 404 Afhandeling ontbrekende bron
service_unavailable 503 Testen van herhalingslogica
timeout 504 Afhandeling time-out

Sandbox-snelheidslimieten

Snelheidslimietniveaus

Omgeving Limiet/Uur Burst Doel
Sandbox 10,000 500/min Ontwikkeling & testen
Productie Gratis 1,000 50/min Hobbyprojecten
Productie Trader 10,000 400/min Professioneel handelen
Productie Pro 50,000 1000/min Hoogfrequente systemen

Testen van snelheidslimietafhandeling

Snelheidslimiet testen
// Activeer snelheidslimietreactie in sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// Respons bevat herhaalheaders
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Teststrategieën

Unittesten met 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())

Integratietesten

Test volledige workflow in sandbox voor productie-implementatie:

  1. Implementeer in staging met sandbox-referenties
  2. Voer volledige testsuite uit tegen sandbox
  3. Test foutafhandeling met foutinjectie
  4. Controleer snelheidslimietgedrag
  5. Controleer responstijd en latentie
  6. Promoveer pas daarna naar productie

Belastingtesten

Belastingtest met Apache Bench
// Sandbox staat hoge belastingtesten toe
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

CI/CD-integratie

GitHub Actions-voorbeeld

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

Omgevingsconfiguratie

Gebruik omgevingsvariabelen om te schakelen tussen sandbox en productie:

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

Probleemoplossing

Veelvoorkomende problemen

Test Key Werkt Niet

Probleem: Krijg 401 Ongeautoriseerd met test key

Oplossingen:

  • Controleer of de key begint met sk_test_ (niet sk_live_)
  • Controleer het Authorization header formaat: "Bearer sk_test_xxx"
  • Zorg ervoor dat je het test endpoint gebruikt: api-test.smartmoney.io
  • Test key heeft mogelijk het tarieflimiet overschreden

Data Reset Niet

Probleem: Test data reset niet na POST /test/reset

Oplossingen:

  • Reset kan tot 30 seconden duren om door te voeren
  • Controleer de sandbox status met GET /test/status
  • Verifieer of je de juiste test API key gebruikt
  • Neem contact op met support als het probleem aanhoudt

Tarieflimieten in Sandbox

Probleem: Tarieflimieten bereikt in sandbox (zou niet moeten gebeuren)

Oplossingen:

  • Verifieer of je sk_test_pro key gebruikt (10.000/uur)
  • Controleer de X-RateLimit-Remaining header
  • Wacht op het uurlimiet of gebruik een ander testaccount
  • Neem contact op met support voor een tijdelijke tarieflimietverhoging

Begin Vandaag met Testen

Gebruik onze uitgebreide sandbox omgeving voor veilige, geïsoleerde ontwikkeling. Deterministische testdata, hoge tarieflimieten en volledige functiepariteit met productie.

Krijg Test Credentials
Alle plannen omvatten sandbox toegang. Geen extra kosten.

Gerelateerde Bronnen

Authenticatiegids →

API authenticatie en key management

REST API Referentie →

Volledige API endpoint documentatie

Foutcodes →

Foutafhandeling en responscodes
Start gratis — 200 calls/dag, geen kaart

Krijg live whale flow, funding, open interest en on-chain data van 3 exchanges vanuit één API. Gratis tier, geen creditcard, upgrade op elk moment.

Start gratis →
Probeer de live API console → (geen account nodig)