Inhoudsopgave

Overzicht Versiebeleid Achterwaartse Compatibiliteit Migratie van V1 naar V2 Endpoint Wijzigingen Response Formaat Updates Afschaffingstijdlijn Breaking Changes Stapsgewijze Migratie Ondersteuning & Middelen

API Documentatie

API Migratiehandleiding — Upgraden tussen versies

Plan en voer soepele API-versie-upgrades uit. Begrijp breaking changes, afschaffingstijdlijnen en best practices voor migratie tussen Smart Money API-versies.

Gepubliceerd op 21 maart 2026 • 16 minuten leestijd • Geavanceerd

Migratie Overzicht

Smart Money API wordt actief ontwikkeld met regelmatige updates. Deze handleiding behandelt versiebeheer, breaking changes en hoe je je integratie kunt migreren zonder downtime.

Belangrijke migratieprincipes:

Semantisch Versioneren — MAJOR.MINOR.PATCH-formaat strikt gevolgd
Langdurige Ondersteuning — Vorige major versie ondersteund voor 24+ maanden
Afschaffingswaarschuwingen — 6 maanden voorafgaande kennisgeving van alle breaking changes
Parallelle Versies — Draai v1 en v2 gelijktijdig tijdens migratie
Geautomatiseerd Testen — Compatibiliteitstesttools beschikbaar gesteld

Huidige Status: v1 (huidig), v2 (bèta, algemene beschikbaarheid Q2 2026). v1 ondersteund tot Q1 2028.

Versiebeleid

Semantisch Versioneren

Versieformaat
API Versie: MAJOR.MINOR.PATCH
Voorbeeld: 2.1.3
MAJOR (2) - Breaking changes, nieuwe architectuur
MINOR (1) - Achterwaarts compatibele features
PATCH (3) - Bugfixes, beveiligingsupdates

Versie Release Cyclus

Fase	Duur	Kenmerken
Alpha	2-4 weken	Grote breaking changes, alleen voor testen
Beta	4-8 weken	Meestal stabiel, community feedback
Release Candidate	2-4 weken	Productieklaar, laatste aanpassingen
Algemene Beschikbaarheid	24+ maanden	Volledige productieondersteuning

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

Vraag je API-sleutel aan →

Achterwaartse Compatibiliteit

Versiecompatibiliteit

Binnen een major versie kun je altijd veilig upgraden naar nieuwere minor/patch versies:

Endpoint URLs — Blijven ongewijzigd
Verplichte Velden — Worden nooit verwijderd (alleen nieuwe optionele velden toegevoegd)
HTTP Statuscodes — Behouden voor bestaande scenario's
Responsestructuur — Kernvelden blijven identiek
Authenticatie — Geen wijzigingen in authenticatiemechanismen

Geleidelijke Afschaffing

Afschaffingstijdlijn
// Maand 1: Kondig afschaffing aan
// Feature gemarkeerd met Deprecation header
Deprecation: version="2.2", sunset="2026-09-01"
// Maand 3-6: Actieve afschaffingsperiode
// API geeft waarschuwingen maar werkt nog
X-Deprecation-Warning: Dit endpoint wordt verwijderd op 2026-09-01
// Maand 6: Definitieve verwijdering
// Endpoint retourneert 410 Gone
HTTP/1.1 410 Gone

Migratie van V1 naar V2

Belangrijke Wijzigingen

REST API Herontwerp — Schonere resource endpoints
Response Formaat — Consistente wrapping, betere foutafhandeling
Authenticatie — OAuth 2.0-ondersteuning toegevoegd (API-sleutels werken nog)
Rate Limiting — Verbeterde granulariteit en duidelijkheid
Webhooks — Herontworpen gebeurtenisformaat en ondertekening

Endpoint Mapping

v1 Endpoint	v2 Endpoint	Wijzigingen
GET /whales	GET /v2/whales/tracking	Herorganiseerd, filtering toegevoegd
GET /funding	GET /v2/derivatives/funding-heatmap	Exchange parameter verplicht
GET /positions	GET /v2/derivatives/positions	Nieuwe aggregatieopties

Endpoint Wijzigingen

Request Parameter Wijzigingen

V1 Request
// V1: Funding rates
GET /v1/funding?symbol=BTCUSDT&exchange=binance

V2 Request
// V2: Zelfde data, duidelijkere structuur
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

Response Formaat Updates

V1 Response Structure

V1 Formaat
{
 "status": "success",
 "data": {
 "symbol": "BTCUSDT",
 "funding": 0.0001
  }
}

V2 Response Structure

V2 Formaat
{
 "data": {
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001
  },
 "_meta": {
 "request_id": "req_abc123",
 "timestamp": 1709980800000
  }
}

Belangrijke verschillen: Geen status wrapper, duidelijkere veldnamen, gestandaardiseerde metadata.

Afschaffingstijdlijn

Geplande afschaffingen

Functie	Aangekondigd	Einddatum	Vervanging
/v1/whales	Jan 2026	Jan 2028	/v2/whales/tracking
/v1/funding	Jan 2026	Jan 2028	/v2/derivatives/funding-heatmap
Alleen API-sleutel authenticatie	Mrt 2026	Mrt 2027	OAuth 2.0 (sleutels blijven werken)
Webhook v1 formaat	Q2 2026	Q2 2027	Webhook v2 formaat

Details over breaking changes

Verwijderde endpoints

/v1/stats — Vervangen door /v2/metrics
/v1/historical — Vervangen door /v2/historical met nieuwe parameters
/v1/alerts/create — Vervangen door POST /v2/alerts

Parameterwijzigingen

limit — Standaard gewijzigd van 100 naar 20 (wees expliciet!)
timeframe — Nu verplicht bij historische queries
sort — Formaat gewijzigd van "field asc" naar "field:asc"

Response veldwijzigingen

funding → funding_rate
price → mark_price
vol → volume_quote

Stapsgewijze migratie

Fase 1: Planning (Week 1-2)

Controleer bestaande integratie op afgeschafte functies
Koppel v1 endpoints aan v2 equivalenten
Identificeer breaking changes die uw code beïnvloeden
Plan teststrategie en tijdlijn

Fase 2: Ontwikkeling (Week 3-4)

Maak een v2 branch in versiebeheer
Update alle API endpoints naar v2 URLs
Update request/response handling
Voer unit tests uit tegen sandbox

Fase 3: Testen (Week 5-6)

Voer volledige integratietest suite uit
Test foutscenario's en edge cases
Load testing met v2 endpoints
Security audit van bijgewerkte code

Fase 4: Staging (Week 7)

Implementeer v2 code in staging omgeving
Voer volledige acceptatietests uit
Krijg goedkeuring van stakeholders
Bereid terugdraaiplan voor

Fase 5: Productie (Week 8)

Blue-green deploy naar productie
Monitor metrics en foutpercentages
Blijf stand-by voor support issues
Schakel v1 code geleidelijk uit

Ondersteuning & Hulpmiddelen

Beschikbare tools

Migration Validator — Controleer code op afgeschafte gebruik
API Upgrade Checker — Vergelijk v1 en v2 compatibiliteit
Migration Checklist — PDF met taken en tijdlijn
Codevoorbeelden — Voor/na migratie voorbeelden

Hulp krijgen

Email: [email protected]
Documentatie: Zie changelog-versioning.html
Discord: Community support kanaal
Enterprise: Toegewezen migratie engineer

Start vandaag met uw migratie

Upgrade naar API v2 met uitgebreide migratietools, documentatie en ondersteuning. Gebouwd voor zero-downtime migratie.

Verken V2

V1 ondersteund t/m Jan 2028. Plan uw migratie vandaag.