Introducerar Bitculator Data-API

Varje diagram, tabell och gauge på Bitculator drivs av en enda datamotor: live-priser uppdateras ungefär varje minut, tusentals marknader över olika börser, sentimentindikatorer, tekniska indikatorer, likvidationer, global marknadshistorik.

Idag öppnar vi upp den motorn. Den Bitculator Data API är live - en Bearer-autentiserad JSON-API med 85 ändpunkter över 15 grupper, en fri nivå, och dokumentation på 19 språk.

Ditt första anrop är en rad:

curl "https://bitculator.com/api/v1/coins?per_page=5" \\ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : "..."} }

Skapa en nyckel i din utvecklarkonsolen och det anropet fungerar just nu. 

API:et är organiserat i 15 resursgrupper, och allt som plattformen visar finns där:

• Kryptovalutor & priser - den fullständiga tillgångskatalogen, live kursuppgifter, historiska priser, OHLC, utbuddata.
• Marknader & börser - par, tickers, volymer och börsdetaljer över de handelsplatserna vi följer.
• Plånböcker - plånbokskatalogen med specifikationer och stödda tillgångar.
• Global marknad - totalt marknadsvärde, handelsvolym och dominans, inklusive historiska serier.
• Sentiment & indikatorer - rädsla & girighet, tjur/björn-regimsignaler, och tekniska indikatorer (RSI, glidande medelvärden och övriga indikatorer) per tillgång.
• Likvidationer - lång- och kortlikvidationsdata.
• Omvandling & kalkylatorer - omvandling kryptovaluta↔fiat i realtid och plattformens kalkylatorändpunkter.
• Editorial - artiklar och ordlista-innehåll.
• Alarm & webbhooks - skapa prisalarm via API:et och ta emot signerade webbhook-leveranser när de aktiveras.
• Meta - användning, planer och den maskinläsbara specifikationen.

Den fullständiga referensen, med körbara exempel för varje slutpunkt, finns i API-dokumentationen.

Några designbeslut som vi vägrade kompromissa med:

• Decimalsträngsprecision. Priser, räntor och tillgångar returneras som strängar, aldrig flyttal. Ett flyttal kan inte exakt representera 0.00000001842, så vi ber det inte om det. Din parser behåller varje siffra som marknaden producerade.
• Ett svarspanne, överallt. Framgångsrika svar är { data, meta }; varje fel-4xx eller 5xx är { "error": { "code", "message", "details" } }. Matcha på error.code: meddelanden kan omformuleras, koderna är stabila.
• Din kvot vilar på varje svar. X-Quota-Limit, X-Quota-Used och X-Quota-Reset-rubriker följer med vid varje anrop, så du behöver aldrig gissa var du står—dock kan du också bara fråga GET /usage. 
• Förutsägbara gränser. per_page-begränsningar är planbaserade, och om du överskrider en gräns returneras en riktig 422. API:et klipper aldrig din begäran tyst och returnerar inte mindre än vad du bad om.
• Signerade webbhooks. Alarmleveranser bär en Stripe-liknande X-Bitculator-Signature-header så att du kan verifiera äktheten innan du litar på ett payload.
• En offentlig specifikation. Hela ytan beskrivs i OpenAPI-specifikationen, och dokumentationen erbjuder en färdig Postman-samling.

Data-API:et har sin egen månadsgräns, separerat från Bitculators inbäddbara widgets. Den fria nivån kräver inget kort - hämta en nyckel och börja bygga. Betalda planer höjer den månatliga anropspoolen och taket för per_page; detaljerna och nuvarande priser finns på Data API-sidan.

Till tillsammans med API:et levererar vi åtta officiella, MIT-licensierade SDK:er - TypeScript, Python, PHP, Go, Rust, Java, C# och C++ - var och en täcker alla 85 ändpunkter med automatisk paginering, typade fel, smarta omförsök och den decimal-strängsgarantin som byggs in. Installationskommandon, logotyper och repository-länkar för alla åtta finns på SDK-sektionen av API-sidan, och källkoden är öppen på github.com/bitculator. Men för tydlighet: du behöver inte ett SDK. Det är vanlig HTTP med en Bearer-header - curl, fetch, requests eller Guzzle fungerar precis som du förväntar dig.

1. Gå igenom Data API-sidan för planer, kvoter och snabbstart.
2. Skapa din nyckel i utvecklarkonsolen
3. Gör ditt första anrop - och kontrollera X-Quota-*-rubrikerna som följer med.

Vi byggde detta API eftersom vi ville att det skulle existera. Om du bygger något på det vill vi verkligen höra om det.