1. Bitpanda Helpdesk
  2. Różne
  3. Więcej

Klucz API Bitpanda i ticker cenowy API

Na chwilę obecną, Bitpanda oferuje 2 różne rozwiązania API. Możesz połączyć się przez API z:

Klucz API

Dzięki funkcji Klucza API możesz generować prywatne klucze API na Bitpandzie, aby dać swoim aplikacjom dostęp do danych z Bitpandy. Więcej o kluczach API Bitpandy znajdziesz w naszej dokumentacji API dla Bitpandy.

Jak stworzyć klucz API

Aby stworzyć klucz API na Bitpandzie, wykonaj te kroki:

Komputer Aplikacja mobilna (Android)
  1. Kliknij swoją Ikonę użytkownika
  2. Kliknij Klucz API
  3. W polu Nazwa aplikacji nadaj kluczowi unikalną nazwę
  4. Dodaj datę wygaśnięcia (opcjonalnie)
  5. Zdefiniuj zakres klucza API
  6. Kliknij Generuj nowy klucz API
  7. Kliknij Kopiuj i upewnij się, że zapiszesz nowo utworzony prywatny klucz API, ponieważ nie będziesz mógł go ponownie zobaczyć
  8. Twój nowo utworzony klucz API pojawi się w sekcji Aktywne klucze API
  9. Możesz cofnąć klucz API w dowolnym momencie, klikając na czerwony przycisk Cofnij. Twój klucz API nie będzie już wtedy widoczny w sekcji Aktywne klucze API

Zakres klucza API można zdefiniować w następujący sposób:

  • Handel
    Umożliwia odczyt danych z Twoich poprzednich transakcji
  • Transakcje
    Umożliwia odczyt danych z Twoich transakcji
  • Saldo
    Umożliwia odczyt Twojego salda

Uwaga: Wszystkie te uprawnienia są tylko do odczytu, co oznacza, że nie możesz tworzyć, aktualizować ani usuwać żadnych danych, ani wykonywać żadnych działań, takich jak handel przez API.

 

API Tickera Cen

API Tickera Cen zwraca paginowaną listę aktywów z aktualnymi cenami do wyświetlania na tickerze.

Endpoint

Uwierzytelnianie

  • Nagłówek (Header): X-Api-Key: <twój_klucz_api>
  • Wymagany zakres (scope) klucza API: trading (Klucze API bez tego zakresu zwrócą błąd 401 Unauthorized)

Parametry zapytania (filtrowanie + paginacja)

  • type (query): Typy aktywów do uwzględnienia, oddzielone przecinkami.
    Przykład: commodity,cryptocoin,equity_security,index
  • group (query): Grupy aktywów do uwzględnienia, oddzielone przecinkami.
    Przykłady: coin, metal, index, token, leveraged_token, equity_etf, equity_stock, equity_etc, equity_right, equity_complex_etf, equity_complex_etc, security_token
  • symbol (query): Symbole aktywów do uwzględnienia, rozdzielone przecinkami (wielkość liter nie ma znaczenia).
    Przykłady: AAPL, msft
  • page_size (query): Elementów na stronę (1–500). Domyślnie: 100
  • cursor (query): Nieprzezroczysty kursor paginacji. Aby pobrać następną stronę, wywołaj endpoint z kursorem ustawionym na wartość `next_cursor` z poprzedniej odpowiedzi.

Odpowiedź

Zwraca JSON z:

  • data: lista elementów tickera
  • self_cursor: obecny, jeśli kursor został podany w żądaniu
  • next_cursor: kursor do następnej strony
  • has_next_page: informuje, czy dostępna jest następna strona

Każdy element tickera zawiera następujące pola:

  • id: UUID aktywa
  • symbol: symbol aktywa (np. BTC, AAPL)
  • name: nazwa aktywa (np. Apple)
  • type: typ aktywa
  • currency: (np. EUR)
  • price: aktualna cena
  • price_change_day: 24-godzinna zmiana ceny w procentach

Przykładowe żądanie

GET
https://developer.bitpanda.com/v1/ticker?page_size=2&type=equity_security,cryptocoin 

X-Api-Key: <klucz_api_z_zakresem_trading>

Przykładowa odpowiedź

{
  "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
}