test: add VCR cassette-based integration tests for quotation API

Record real Upbit API responses as VCR cassettes and add structural
validation tests for all 11 quotation endpoints.

Closes #37

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gylim

tests/__init__.py

@@ -0,0 +1,182 @@
+from __future__ import annotations
+
+from tests.conftest import upbeat_vcr
+from upbeat import Upbeat
+from upbeat.types.quotation import (
+    CandleDay,
+    CandleMinute,
+    CandlePeriod,
+    CandleSecond,
+    Orderbook,
+    OrderbookInstrument,
+    Ticker,
+    Trade,
+)
+
+
+def _client() -> Upbeat:
+    return Upbeat(max_retries=0, auto_throttle=False)
+
+
+# ── Tickers ─────────────────────────────────────────────────────────────
+
+
+class TestGetTickers:
+    @upbeat_vcr.use_cassette("quotation/get_tickers.yaml")
+    def test_returns_valid_tickers(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_tickers("KRW-BTC")
+
+        assert len(result) >= 1
+        ticker = result[0]
+        assert isinstance(ticker, Ticker)
+        assert ticker.market == "KRW-BTC"
+        assert ticker.change in ("EVEN", "RISE", "FALL")
+        assert isinstance(ticker.trade_price, float)
+        assert isinstance(ticker.timestamp, int)
+
+
+class TestGetTickersByQuote:
+    @upbeat_vcr.use_cassette("quotation/get_tickers_by_quote.yaml")
+    def test_returns_valid_tickers(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_tickers_by_quote("KRW")
+
+        assert len(result) >= 1
+        for ticker in result:
+            assert isinstance(ticker, Ticker)
+            assert ticker.market.startswith("KRW-")
+
+
+# ── Candles ─────────────────────────────────────────────────────────────
+
+
+class TestGetCandlesMinutes:
+    @upbeat_vcr.use_cassette("quotation/get_candles_minutes.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_minutes(market="KRW-BTC", unit=1)
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandleMinute)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.unit, int)
+        assert isinstance(candle.opening_price, float)
+
+
+class TestGetCandlesSeconds:
+    @upbeat_vcr.use_cassette("quotation/get_candles_seconds.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_seconds(market="KRW-BTC")
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandleSecond)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.opening_price, float)
+
+
+class TestGetCandlesDays:
+    @upbeat_vcr.use_cassette("quotation/get_candles_days.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_days(market="KRW-BTC")
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandleDay)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.prev_closing_price, float)
+        assert isinstance(candle.change_price, float)
+        assert isinstance(candle.change_rate, float)
+
+
+class TestGetCandlesWeeks:
+    @upbeat_vcr.use_cassette("quotation/get_candles_weeks.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_weeks(market="KRW-BTC")
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandlePeriod)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.first_day_of_period, str)
+
+
+class TestGetCandlesMonths:
+    @upbeat_vcr.use_cassette("quotation/get_candles_months.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_months(market="KRW-BTC")
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandlePeriod)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.first_day_of_period, str)
+
+
+class TestGetCandlesYears:
+    @upbeat_vcr.use_cassette("quotation/get_candles_years.yaml")
+    def test_returns_valid_candles(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_candles_years(market="KRW-BTC")
+
+        assert len(result) >= 1
+        candle = result[0]
+        assert isinstance(candle, CandlePeriod)
+        assert candle.market == "KRW-BTC"
+        assert isinstance(candle.first_day_of_period, str)
+
+
+# ── Orderbooks ──────────────────────────────────────────────────────────
+
+
+class TestGetOrderbooks:
+    @upbeat_vcr.use_cassette("quotation/get_orderbooks.yaml")
+    def test_returns_valid_orderbooks(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_orderbooks("KRW-BTC")
+
+        assert len(result) >= 1
+        ob = result[0]
+        assert isinstance(ob, Orderbook)
+        assert ob.market == "KRW-BTC"
+        assert len(ob.orderbook_units) >= 1
+        unit = ob.orderbook_units[0]
+        assert isinstance(unit.ask_price, float)
+        assert isinstance(unit.bid_price, float)
+
+
+class TestGetOrderbookInstruments:
+    @upbeat_vcr.use_cassette("quotation/get_orderbook_instruments.yaml")
+    def test_returns_valid_instruments(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_orderbook_instruments("KRW-BTC")
+
+        assert len(result) >= 1
+        inst = result[0]
+        assert isinstance(inst, OrderbookInstrument)
+        assert inst.market == "KRW-BTC"
+        assert isinstance(inst.supported_levels, list)
+
+
+# ── Trades ──────────────────────────────────────────────────────────────
+
+
+class TestGetTrades:
+    @upbeat_vcr.use_cassette("quotation/get_trades.yaml")
+    def test_returns_valid_trades(self) -> None:
+        with _client() as client:
+            result = client.quotation.get_trades("KRW-BTC")
+
+        assert len(result) >= 1
+        trade = result[0]
+        assert isinstance(trade, Trade)
+        assert trade.market == "KRW-BTC"
+        assert trade.ask_bid in ("ASK", "BID")
+        assert isinstance(trade.trade_price, float)
+        assert isinstance(trade.sequential_id, int)

tests/api/test_quotation_vcr.py

@@ -0,0 +1,48 @@
+interactions:
+- request:
+    body: ''
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+      Host:
+      - api.upbit.com
+      User-Agent:
+      - python-httpx/0.28.1
+    method: GET
+    uri: https://api.upbit.com/v1/candles/days?market=KRW-BTC
+  response:
+    body:
+      string: '[{"market":"KRW-BTC","candle_date_time_utc":"2026-03-11T00:00:00","candle_date_time_kst":"2026-03-11T09:00:00","opening_price":102417000.00000000,"high_price":103988000.00000000,"low_price":101150000.00000000,"trade_price":103266000.00000000,"timestamp":1773239757526,"candle_acc_trade_price":102978167919.53824000,"candle_acc_trade_volume":1005.84581426,"prev_closing_price":102417000.00000000,"change_price":849000.00000000,"change_rate":0.0082896394}]'
+    headers:
+      Cache-Control:
+      - no-cache, no-store, max-age=0, must-revalidate
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Wed, 11 Mar 2026 14:36:01 GMT
+      ETag:
+      - W/"029ecccae2a72fbe19b9758cb7a721f93"
+      Expires:
+      - '0'
+      Limit-By-Ip:
+      - 'Yes'
+      Pragma:
+      - no-cache
+      Remaining-Req:
+      - group=candles; min=600; sec=7
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - origin,access-control-request-method,access-control-request-headers,accept-encoding
+      content-length:
+      - '454'
+    status:
+      code: 200
+      message: ''
+version: 1

tests/cassettes/quotation/get_candles_days.yaml

@@ -0,0 +1,48 @@
+interactions:
+- request:
+    body: ''
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+      Host:
+      - api.upbit.com
+      User-Agent:
+      - python-httpx/0.28.1
+    method: GET
+    uri: https://api.upbit.com/v1/candles/minutes/1?market=KRW-BTC
+  response:
+    body:
+      string: '[{"market":"KRW-BTC","candle_date_time_utc":"2026-03-11T14:35:00","candle_date_time_kst":"2026-03-11T23:35:00","opening_price":103159000.00000000,"high_price":103400000.00000000,"low_price":103159000.00000000,"trade_price":103266000.00000000,"timestamp":1773239757526,"candle_acc_trade_price":158764957.73950000,"candle_acc_trade_volume":1.53670146,"unit":1}]'
+    headers:
+      Cache-Control:
+      - no-cache, no-store, max-age=0, must-revalidate
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Wed, 11 Mar 2026 14:36:01 GMT
+      ETag:
+      - W/"06032a2d9289f11a2b389a3b11da2d28b"
+      Expires:
+      - '0'
+      Limit-By-Ip:
+      - 'Yes'
+      Pragma:
+      - no-cache
+      Remaining-Req:
+      - group=candles; min=600; sec=9
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - origin,access-control-request-method,access-control-request-headers,accept-encoding
+      content-length:
+      - '359'
+    status:
+      code: 200
+      message: ''
+version: 1

tests/cassettes/quotation/get_candles_minutes.yaml

@@ -0,0 +1,48 @@
+interactions:
+- request:
+    body: ''
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+      Host:
+      - api.upbit.com
+      User-Agent:
+      - python-httpx/0.28.1
+    method: GET
+    uri: https://api.upbit.com/v1/candles/months?market=KRW-BTC
+  response:
+    body:
+      string: '[{"market":"KRW-BTC","candle_date_time_utc":"2026-03-01T00:00:00","candle_date_time_kst":"2026-03-01T09:00:00","opening_price":97626000.00000000,"high_price":107547000.00000000,"low_price":95100000.00000000,"trade_price":103266000.00000000,"timestamp":1773239757526,"candle_acc_trade_price":2509214356853.28538000,"candle_acc_trade_volume":24765.03530608,"first_day_of_period":"2026-03-01"}]'
+    headers:
+      Cache-Control:
+      - no-cache, no-store, max-age=0, must-revalidate
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Wed, 11 Mar 2026 14:36:01 GMT
+      ETag:
+      - W/"0013f0168900e9f44dabecee514a7df8b"
+      Expires:
+      - '0'
+      Limit-By-Ip:
+      - 'Yes'
+      Pragma:
+      - no-cache
+      Remaining-Req:
+      - group=candles; min=600; sec=5
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - origin,access-control-request-method,access-control-request-headers,accept-encoding
+      content-length:
+      - '391'
+    status:
+      code: 200
+      message: ''
+version: 1

tests/cassettes/quotation/get_candles_months.yaml

@@ -0,0 +1,48 @@
+interactions:
+- request:
+    body: ''
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+      Host:
+      - api.upbit.com
+      User-Agent:
+      - python-httpx/0.28.1
+    method: GET
+    uri: https://api.upbit.com/v1/candles/seconds?market=KRW-BTC
+  response:
+    body:
+      string: '[{"market":"KRW-BTC","candle_date_time_utc":"2026-03-11T14:35:57","candle_date_time_kst":"2026-03-11T23:35:57","opening_price":103264000.00000000,"high_price":103266000.00000000,"low_price":103264000.00000000,"trade_price":103266000.00000000,"timestamp":1773239757526,"candle_acc_trade_price":29806.31824000,"candle_acc_trade_volume":0.00028864}]'
+    headers:
+      Cache-Control:
+      - no-cache, no-store, max-age=0, must-revalidate
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json;charset=UTF-8
+      Date:
+      - Wed, 11 Mar 2026 14:36:01 GMT
+      ETag:
+      - W/"0c176e8f744f73300f7b966cb289bc998"
+      Expires:
+      - '0'
+      Limit-By-Ip:
+      - 'Yes'
+      Pragma:
+      - no-cache
+      Remaining-Req:
+      - group=candles; min=600; sec=8
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - origin,access-control-request-method,access-control-request-headers,accept-encoding
+      content-length:
+      - '346'
+    status:
+      code: 200
+      message: ''
+version: 1