Tutorial/Alert kursów walut w Pythonie: USD/IDR

Alert kursów walut w Pythonie: USD/IDR

Zbuduj monitor w standardowej bibliotece Pythona, który raz zgłasza przekroczenie progu, bezpiecznie zachowuje stan i respektuje świeżość oraz limity API.

ERexchangerate.dev·Sep 8, 2026·8 min czytania

Alert porównuje nowe skuteczne obserwacje USD/IDR z poprzednią obserwacją, a nie czas odpytywania. Pierwsza obserwacja tworzy bazę, a stare dane i błędy nie zmieniają stanu.

Key points
Do oceny IDR użyj sources["IDR"] i effective_at["IDR"]; globalne source jest konserwatywnym podsumowaniem.
Pierwsza poprawna obserwacja to tylko baza. Po przekroczeniu wyślij jeden alert i uzbrój go ponownie dopiero po powrocie poniżej progu.
Zapisz JSON w pliku tymczasowym, ustaw 0600 i zamień go przez os.replace, aby przerwanie nie uszkodziło stanu.
Użyj timeoutu 10 sekund, klucza z EXCHANGERATE_API_KEY i odstępu co najmniej 60 sekund. Przy429 zachowaj stan i respektuj Retry-After.
Pobierz pełny skrypt, a próg i ścieżkę stanu ustaw poza repozytorium. Wynik trafia tylko do konsoli.

Modeluj obserwację waluty

Do oceny IDR użyj sources["IDR"] i effective_at["IDR"]; globalne source jest konserwatywnym podsumowaniem.

python · observation modelcopy
from decimal import Decimal

def idr_observation(payload: dict) -> dict:
    return {
        "rate": Decimal(str(payload["rates"]["IDR"])),
        "source": payload["sources"]["IDR"],
        "effective_at": payload["effective_at"]["IDR"],
        "market_session": payload["market_session"],
    }

Zdefiniuj przekroczenie

Pierwsza poprawna obserwacja to tylko baza. Po przekroczeniu wyślij jeden alert i uzbrój go ponownie dopiero po powrocie poniżej progu.

SytuacjaZmiana stanuAlert
Pierwsza poprawna obserwacjaZapisz bazęNie
Ruch poniżej proguarmed=trueNie
Przekroczenie przy uzbrojeniuarmed=falseJeden
Powtórka/stare dane lub błądZachowaj stanNie

Bezpiecznie zapisz stan

Zapisz JSON w pliku tymczasowym, ustaw 0600 i zamień go przez os.replace, aby przerwanie nie uszkodziło stanu.

python · atomic state writecopy
import json
import os
import tempfile
from pathlib import Path

def save_state(path: Path, state: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    fd, temporary = tempfile.mkstemp(prefix=f".{path.name}.", dir=path.parent, text=True)
    try:
        os.fchmod(fd, 0o600)
        with os.fdopen(fd, "w") as handle:
            json.dump(state, handle, sort_keys=True)
            handle.write("\n")
        os.replace(temporary, path)
    except Exception:
        try:
            os.unlink(temporary)
        except OSError:
            pass
        raise

Ogranicz sieć i limit

Użyj timeoutu 10 sekund, klucza z EXCHANGERATE_API_KEY i odstępu co najmniej 60 sekund. Przy429 zachowaj stan i respektuj Retry-After. Domyślny interwał pięciu minut to około 8 640 wywołań w 30 dni; 60 sekund to około 43 200 i może przekroczyć wspólny limit.

Błędy nie mogą tworzyć fałszywych alertów
Użyj timeoutu 10 sekund, klucza z EXCHANGERATE_API_KEY i odstępu co najmniej 60 sekund. Przy429 zachowaj stan i respektuj Retry-After.

Uruchom monitor

Pobierz pełny skrypt, a próg i ścieżkę stanu ustaw poza repozytorium. Wynik trafia tylko do konsoli. Domyślny maksymalny wiek danych to godzina. Ustaw FX_ALERT_MAX_AGE_SECONDS dla kursu dziennego lub zamkniętego rynku. python-exchange-rate-alerts.py

shell · run itcopy
chmod 700 python-exchange-rate-alerts.py
export EXCHANGERATE_API_KEY="your-key"
export FX_ALERT_THRESHOLD_PCT="1.0"
export FX_ALERT_POLL_SECONDS="300"
export FX_ALERT_STATE_PATH="$HOME/.local/state/fx-alert.json"
python3 python-exchange-rate-alerts.py

Przetestuj politykę bez czekania na rynek

Przetestuj bazę, próg, powtórzony timestamp, stare dane, ponowne uzbrojenie i drugi alert przez mock sieci.

ER
exchangerate.dev
Poradniki integracyjne dla programistów.

Czytaj dalej

TutorialKursy walut w PythonieCzytaj ReferenceOdczyt source i market_sessionCzytaj GuideHistoria FX w jednym żądaniuCzytaj
Więcej porównańFixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
PoradnikiReading source and market_session in your pipelineIndicative vs executable FX rates: what a rates API actually gives youECB reference rates, explained
Kursy na żywoEUR/USDGBP/USDUSD/JPY