Bitsgap API: Voer uw eigen handelsalgoritme uit op 17 beurzen

Het opzetten van je eigen trading-automatisering betekende vroeger een week werk. Je moest de API-documentatie van één exchange doornemen, het ondertekeningsschema implementeren, omgaan met de eigenaardigheden ervan, en dat vervolgens herhalen voor de volgende exchange. Dan nog een server toevoegen, reconnect-logica inbouwen en een manier vinden om te testen zonder geld te verliezen.

De Bitsgap API haalt die week weg. Eén key pair dekt 17 exchanges, de demo-omgevingen zijn al beschikbaar, en de verbinding met jouw exchange is dezelfde die je bots nu al gebruiken. Bij accounts die het hebben ingesteld, is de mediane tijd van het aanmaken van een key tot het eerste succesvolle ondertekende verzoek 13 minuten. De API is inbegrepen bij elk plan, ook bij de Free.

Wat een trading API eigenlijk is

Een API is een vaste lijst met commando’s die het ene programma naar het andere kan sturen. Een trading API is die lijst voor een market: een prijs opvragen, een saldo opvragen, een order plaatsen, een order annuleren, een positie sluiten. Jouw programma stuurt een commando, de server voert het uit en stuurt een antwoord terug. Alles wat je handmatig kunt doen door te klikken in Bitsgap, kan jouw code zelfstandig en op eigen tijdstip uitvoeren.

De versie van Bitsgap is opgebouwd rond één idee, namelijk een topic — een benoemd iets dat je wilt. price, balance, orders, order_place. Je geeft de topic een naam, voert de parameters in en ontvangt vervolgens ofwel een enkele momentopname of een live stream met updates.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

De rest van het protocol bestaat uit welke topics er zijn en welke parameters elk topic accepteert. Er is geen aparte endpoint per actie en er is geen tweede formaat dat je moet leren zodra je dieper gaat.

Waarom niet direct naar de exchange gaan

Dat kan, en voor één handelsplatform is dat een logische keuze. Maar zodra het aantal boven de één uitkomt, veranderen er drie dingen.

Elke exchange hanteert een eigen ondertekeningsschema, dus een tweede platform betekent een tweede implementatie vanaf nul. Elke exchange vereist een eigen sleutel, die apart moet worden opgeslagen en periodiek vervangen. En de meeste bieden geen realistische testomgeving, waardoor nieuwe code direct met echt geld wordt uitgevoerd bij de eerste run.

Via Bitsgap is er één key pair, één ondertekeningsschema en een demo-omgeving die zich gedraagt als de live-omgeving. Je algoritme bevindt zich bovendien in hetzelfde Account als je GRID-, DCA- en COMBO-bots, zodat al je posities op één plek zichtbaar zijn in plaats van verdeeld over twee systemen die elk maar de helft laten zien.

Dertien minuten, stap voor stap

1. Maak een Account aan. Free plan, geen kaart nodig. De API is inbegrepen bij elk plan, dus hier hoeft niets geüpgraded te worden.

2. Genereer een sleutel. Account-menu → API keys → Nieuwe sleutel aanmaken. Geef het een naam en een vervaldatum, en klik vervolgens op Genereer. De standaard geldigheidsduur is drie jaar.

3. Sla de private key op. Deze verschijnt één keer, als een PEM-bestand. Download het en bewaar het op dezelfde manier als een exchange key. Als je het kwijtraakt, kan het niet worden hersteld, alleen vervangen.

4. Controleer of je ondertekening offline werkt. De officiële voorbeelden bevatten een signing_offline-test waarvoor geen sleutel en geen netwerk nodig is. Voer deze test als eerste uit. De meeste integratieproblemen zijn ondertekeningsproblemen, en hiermee spoor je die op voordat er iets anders in de weg zit.

5. Voer de walkthrough uit op demo. De voorbeelden zijn beschikbaar voor Go, Rust, Python en TypeScript, en gebruiken standaard demo-exchanges. Met één opdracht doorloop je verbinding maken, market data, balansen, een spot order, een futures order en ordergeschiedenis. Er komt op geen enkel moment echt geld aan te pas.

6. Koppel het aan een echte exchange. Verander één getal — de em exchange-ID — en dezelfde code draait live.

Hoe je het instelt zonder zelf de code te schrijven

Je hoeft de integratie niet zelf handmatig te bouwen.

De volledige protocolreferentie is openbaar en machineleesbaar, en vier complete referentie-implementaties staan ernaast. Geef die documentatie aan een AI-coding-assistent en beschrijf in gewone taal wat je wilt: houd het financieringstarief in de gaten op drie paren, en zodra het op alle drie negatief wordt, sluit mijn longposities. Je krijgt een werkend script terug dat is gekoppeld aan de demoversie, zodat je het kunt uitvoeren en aanpassen voordat het je echte saldo raakt.

Die mediane van 13 minuten blijft staan omdat de lastige onderdelen al in vier talen beschikbaar zijn, waaronder Ed25519-signing, canonieke request strings en reconnect-logica. Daardoor hoef je alleen nog de trading rule te schrijven en verder niets.

De Market blijft sneller groeien dan welke handmatige werkwijze dan ook kan bijhouden, waardoor de tijd die aan het ‘plumbing’-werk wordt besteed het duurste onderdeel van de setup is geworden.

Twee kanalen, één onderwerpenlijst

Beide kanalen behandelen dezelfde onderwerpen met dezelfde parameters. REST is bedoeld voor een programma dat wakker wordt, één vraag stelt en daarna weer in slaap valt. WebSocket is voor een programma dat actief blijft en direct reageert.

Via REST bevestigt de reactie op een opdracht dat de taak is geaccepteerd, niet dat deze is voltooid. Het uitvoeringsresultaat komt binnen via een WebSocket-abonnement op orders, positions of balance, of door deze onderwerpen opnieuw op te vragen. De rate-limit teller wordt gedeeld tussen beide kanalen, dus van transport wisselen levert geen extra budget op.

Waar je toegang toe krijgt

Roep eerst conf_enums aan. Deze geeft de referentietabellen terug die exchangenamen omzetten naar de numerieke em-ID’s die elk ander topic verwacht — Binance is 2, Binance demo is 101. Het manual-topic geeft de livecatalogus van elk topic met de huidige rate limits, zodat je code de limieten kan uitlezen in plaats van ze hard te coderen.

Eén veld dat je vanaf dag één zou moeten gebruiken: apiid. Dit is jouw eigen tag op een Order, tot maximaal 250 tekens, en deze komt terug in elk toekomstig rapport van die Order. Zet er een strategienaam en versie in. Wanneer twee van jouw programma’s op hetzelfde paar Handelen, is die tag het enige wat aangeeft welke welke Order heeft geplaatst.

Is het veilig om de Bitsgap API te koppelen?

De verbinding van Bitsgap met jouw exchange blijft ongewijzigd. Deze is uitsluitend bedoeld voor handelen en heeft nooit rechten gehad om opnames te doen. De API voegt een aparte verbinding toe tussen jouw programma en Bitsgap, ondertekend met een Ed25519-sleutelpaar dat je zelf genereert en beheert. Ed25519 is een handtekeningmechanisme en geen wachtwoord: jij bezit de privésleutel, Bitsgap bewaart alleen de publieke sleutel, en het geheim verlaat het netwerk nooit. Verzoeken kunnen niet worden herhaald, omdat elk verzoek een unieke nonce en een tijdstempel bevat die na tien seconden verloopt. Trek je de sleutel in, dan worden alle open sessies direct beëindigd.

De limieten, in cijfers

Twee hiervan bepalen hoe je bouwt. Rate-counters worden per topic gedeeld tussen REST en WebSocket, dus een polling-LOOP verbruikt het budget dat een live Abonnement nodig heeft. En als je de berichtlimiet per verbinding overschrijdt, wordt de socket gesloten in plaats van dat het bericht wordt geweigerd, dus reconnect-logica vereist backoff, een nieuw auth-frame en een hernieuwde Abonnement-aanvraag.

Drie dingen zorgen ervoor dat eerste pogingen mislukken, in deze volgorde: een niet-gesynchroniseerde klok, een hergebruikte nonce en het opnieuw serialiseren van de request body nadat je deze hebt ondertekend. De payload wordt byte voor byte ondertekend, dus een andere volgorde van sleutels of een extra spatie levert een andere handtekening op. Verstuur exact dezelfde string die je hebt ondertekend.

Test het zonder iets uit te geven

Demo-exchanges gedragen zich als de echte. Orders, fills, posities, saldi — allemaal zonder dat er echt geld aan te pas komt. demo_market_reset zet het Account terug naar de oorspronkelijke staat, zodat je een strategie volledig kunt uitproberen en met één commando opnieuw kunt beginnen.

De API is gratis bij elk plan, inclusief het $0 Free plan. Geen creditcard, geen upgrade, geen proefperiode. Maak een Account aan, genereer een sleutel en begin vandaag nog met het ondertekenen van verzoeken.

Veelgestelde vragen

Wat is de Bitsgap API? Een publieke API waarmee je eigen programma marktgegevens kan uitlezen en trades kan plaatsen op elke exchange die aan je Bitsgap account is gekoppeld. REST- en WebSocket-kanalen delen één onderwerpenlijst, geauthenticeerd met een Ed25519-sleutelpaar dat je zelf genereert en beheert.

Is de Bitsgap API Free? Ja. Deze is inbegrepen bij elk plan, ook bij de Free variant, zonder extra kosten.

Moet ik kunnen programmeren? Je moet in staat zijn om een script uit te voeren. Het schrijven ervan is grotendeels optioneel: de protocolreferentie en vier volledige referentie-implementaties zijn openbaar, dus een AI-coding-assistent kan op basis van een beschrijving in gewone taal een werkende integratie genereren.

Welke programmeertalen worden ondersteund? Elke taal die een HTTPS-verzoek kan doen en een Ed25519-handtekening kan berekenen. Officiële uitvoerbare voorbeelden zijn beschikbaar in Go, Rust, Python en TypeScript.

Kan de API mijn fondsen opnemen? Nee. Bitsgap maakt verbinding met je exchange via een sleutel die alleen voor handelen is en nooit opname-rechten heeft gehad, en de API verandert dat niet. Het voegt een apart, ondertekend kanaal toe tussen jouw programma en Bitsgap, dat op elk moment kan worden ingetrokken.

REST of WebSocket — welke moet ik gebruiken? REST voor eenmalige vragen en geplande scripts. WebSocket voor alles wat direct moet reageren op prijsbewegingen of de status van een Order live moet volgen.

Kan ik testen zonder echt geld? Ja. De officiële voorbeelden gebruiken standaard demo-exchanges, en het demo-Account kan op elk moment worden teruggezet naar de beginbalansen.

Hoe lang duurt de installatie? De mediane tijd vanaf het aanmaken van een API-sleutel tot het eerste succesvolle ondertekende verzoek is 13 minuten, gemeten over Bitsgap-accounts die er een hebben gekoppeld. [Meetvenster toevoegen vóór publicatie]