Trenutno, Bitpanda nudi 2 različita API rješenja. Možeš se povezati putem API-ja na:
API Ključ
Uz našu API Key opciju, možeš generirati privatne API ključeve na Bitpandi kako bi tvojim aplikacijama omogućio pristup tvojim Bitpanda podacima. Više o Bitpanda API ključevima možeš pročitati u našoj API dokumentaciji za Bitpanda.
Kreiraj API ključ
Da bi kreirao API ključ na Bitpandi, slijedi ove korake:
- Klikni na svoju korisničku ikonu
- Klikni na API Ključ
- Pod Ime aplikacije daj ključu jedinstveno ime
- Dodaj datum isteka (opcionalno)
- Definiraj opseg API ključa
- Klikni na Generiraj novi API ključ
- Klikni na Kopiraj i obavezno spremi novokreirani privatni API ključ, jer mu kasnije nećeš moći pristupiti
- Tvoj novokreirani API ključ će se pojaviti pod Aktivni API ključevi
- API ključ možeš opozvati u bilo kojem trenutku klikom na crveni gumb Opozovi. Tvoj API ključ tada više neće biti prikazan pod Aktivni API ključevi
Opseg API ključa može biti definiran kao sljedeće:
-
Trgovanje
Ovo omogućava čitanje podataka o tvojim prethodnim trgovinama -
Transakcija
Ovo omogućava čitanje tvojih transakcijskih podataka -
Stanje
Ovo omogućava čitanje tvog stanja
Napomena: Sve ove dozvole su samo za čitanje, što znači da ne možeš kreirati, ažurirati ili brisati bilo kakve podatke, niti izvoditi bilo kakve radnje poput trgovanja putem API-ja.
Price Ticker API
Price Ticker API vraća paginirani popis tokena s trenutnim cijenama za prikaz.
Endpoint
Autentikacija
- Zaglavlje (Header): X-Api-Key: <tvoj_api_ključ>
- Potreban opseg API ključa (scope): trading (API ključevi bez ovog opsega vratit će grešku 401 Unauthorized)
Parametri upita (filtriranje + paginacija)
-
type (query): Vrste tokena za uključivanje, odvojene zarezom.
Primjer: commodity,cryptocoin,equity_security,index -
group (query): Grupe tokena za uključivanje, odvojene zarezom.
Primjeri: coin, metal, index, token, leveraged_token, equity_etf, equity_stock, equity_etc, equity_right, equity_complex_etf, equity_complex_etc, security_token -
symbol (query): Simboli imovine koje treba uključiti, odvojeni zarezom (ne razlikuje velika i mala slova).
Primjeri: AAPL, msft - page_size (query): Stavki po stranici (1–500). Zadano: 100
- cursor (query): Neprozirni kursor za paginaciju. Za dohvaćanje sljedeće stranice, pozovi endpoint s kursorom postavljenim na `next_cursor` iz prethodnog odgovora.
Odgovor
Vraća JSON s:
- data: popis stavki tikera
- self_cursor: prisutan ako je kursor naveden u zahtjevu
- next_cursor: kursor za sljedeću stranicu
- has_next_page: označava je li dostupna sljedeća stranica
Svaka stavka tikera uključuje sljedeća polja:
- id: UUID tokena
- symbol: simbol tokena (npr. BTC, AAPL)
- name: naziv imovine (npr. Apple)
- type: vrsta tokena
- currency: (npr. EUR)
- price: trenutna cijena
- price_change_day: 24-satna promjena cijene u postocima
Primjer zahtjeva
GET
https://developer.bitpanda.com/v1/ticker?page_size=2&type=equity_security,cryptocoin
X-Api-Key: <api_ključ_s_opsegom_trgovanja>
Primjer odgovora
{
"data": [
{
"id": "11111111-1111-1111-1111-111111111111",
"symbol": "AAA",
"name": "Asset A",
"type": "equity_security",
"currency": "EUR",
"price": "5.72300000",
"price_change_day": "-0.62"
},
{
"id": "22222222-2222-2222-2222-222222222222",
"symbol": "BBB",
"name": "Asset B",
"type": "cryptocoin",
"currency": "EUR",
"price": "6.72000000",
"price_change_day": "1.33"
}
],
"next_cursor": "<opaque_cursor_for_next_page>",
"has_next_page": true
}