DANE DLA TWOICH NARZĘDZI
HOSTuvo Data API v1: integruj dane wraz z kontekstem
Buduj widoki na danych HOSTuvo tylko do odczytu, zachowując instrument, źródło, horyzont i świeżość.
API udostępnia wybrane wyniki analityczne, nie wykonanie giełdowe ani prywatne wnętrze modeli. Sukces HTTP oznacza obsłużenie zapytania; nie czyni każdej zagnieżdżonej miary aktualną ani wykonalną. Pokazuj jawnie brak wartości i opóźnione obserwacje.
Autoryzacja
Każde zapytanie wysyłasz z nagłówkiem Authorization: Bearer. Klucz ma prefiks hst_v1_ i można go natychmiast unieważnić w panelu klienta.
- Do 3 aktywnych kluczy na konto.
- Pełny sekret widzisz tylko raz.
- Wygaśnięcie PRO blokuje klucz bez zmiany aplikacji klienta.
Limity i bezpieczeństwo
Pierwsza wersja ma limit 60 zapytań na minutę i 10 000 na dobę. Serwer zwraca nagłówki z pozostałym limitem i czasem resetu.
- 429 po przekroczeniu limitu.
- 401 dla brakującego lub błędnego klucza.
- 403 gdy konto nie ma uprawnienia PRO.
Endpointy v1
API obejmuje katalog rynków, snapshot, historię, Top 10, Accumulation, PRE-MOVE, kontekst i status systemu. Wszystkie endpointy są tylko do odczytu.
- /api/v1/markets
- /api/v1/market/INJUSDC/snapshot
- /api/v1/opportunities/top10
- /api/v1/accumulation/top10
- /api/v1/premove/INJUSDC
Czego API nie robi
Data API nie składa zleceń, nie przyjmuje kluczy giełdowych i nie udostępnia prywatnych wag modeli. To warstwa danych do własnego workflow analitycznego.
- auto_orders pozostaje OFF.
- Brak endpointów BUY/SELL/ORDER.
- Brak dostępu do sekretów infrastruktury i modeli.
Zbuduj odporną pętlę odświeżania
Pobieraj tylko potrzebne endpointy i współdziel odpowiedzi między elementami widoku. Nie ponawiaj całej serii natychmiast po awarii. Przy limicie respektuj podaną przez serwer instrukcję ponowienia, a w przeciwnym razie stosuj ograniczone wydłużanie odstępów. Wyjaśnij błąd uwierzytelnienia lub uprawnień zamiast powtarzać nieprawidłowe żądanie. Brakujące pole pozostaje niedostępne, a nie zamienia się w zero.
- Ustaw timeout i anulowanie zapytania.
- Unikaj duplikatów po ponownym połączeniu.
- Przy danych z pamięci pokazuj czas obserwacji.
Zachowaj znaczenie analizy przy eksporcie
Przy każdym wierszu PRE-MOVE zachowaj symbol, giełdę referencyjną lub wykonania, horyzont, czas obserwacji i status diagnostyczny. Miejsce w Top 10 to ranking w konkretnym skanie, nie prawdopodobieństwo ani zlecenie. Jeśli arkusz łączy obrazy rynku z różnych chwil, pokaż tę niezgodność. Przy własnych podsumowaniach porównuj tę samą definicję prognozy.
- Przenoś pochodzenie danych do CSV i bazy.
- Rozróżniaj null, zero i niedostępność.
- Oddziel wyniki symulowane od wykonanych.
Nie umieszczaj kluczy API na publicznej stronie
Wygeneruj klucz w autoryzowanym panelu konta i przechowuj go poza publicznym kodem, zrzutami ekranu i współdzielonymi arkuszami. Publiczny dashboard wymagający sekretu obsługuj przez własny serwer. Unieważniaj nieużywane klucze i świadomie aktualizuj korzystającą z nich usługę. Utratę uprawnień pokaż jako stan dostępu zamiast zastępować odpowiedź PRO wymyślonymi danymi.
- Nie wklejaj pełnego klucza do wiadomości pomocy.
- Korzystaj z udokumentowanych endpointów tylko do odczytu.
- Testuj błędy bez transakcji finansowych.
curl https://app.hostuvo.com/api/v1/opportunities/top10 \
-H "Authorization: Bearer hst_v1_TWÓJ_KLUCZ"Klucz tworzysz w panelu konta. Pełny sekret jest widoczny raz; przechowuj go po stronie serwera.
Czytaj dalej