مستندات Oxtapus#
Oxtapus یک SDK تایپشده و مبتنی بر Polars برای دادههای بازار مالی ایرانه. دادههای ابزارهای
بورس تهران از TSETMC و تاریخچهٔ ارز و سکه از TGJU بهشکل polars.DataFrame برمیگردن.
مسیر معمول استفاده از نصب و شروع سریع شروع میشه. مرجع API پایتون فهرست کامل توابع و متدهای عمومی رو با امضا، ورودی، خروجی، مثال قابلکپی و نمونهٔ خروجی ارائه میکنه.
یک نمونهٔ کوتاه#
>>> import oxtapus as ox
>>> usd = ox.tgju.daily_prices("دلار", start="1403/10/12")
>>> usd.select("trading_date", "close_price").tail(3)
shape: (3, 2)
┌──────────────┬─────────────┐
│ trading_date ┆ close_price │
│ --- ┆ --- │
│ date ┆ i64 │
╞══════════════╪═════════════╡
│ … ┆ … │
└──────────────┴─────────────┘
Note
مقدارهای نمونه کوتاه شدهان؛ تعداد ردیف و قیمت واقعی به زمان دریافت و بازهٔ انتخابی بستگی داره.
مرجع API پایتون
راهنماها
مرجع داده
Architecture and development (English)
- Architecture
- Providers
- Bronze, Silver, and Gold
- Schema versioning
- Instrument identifiers
- Architecture rules
- Provider development
- Testing
- Current-state audit
- Reference architecture and license review
- TSETMC public API inventory
- Architecture decisions
- ADR 0001: HTTPX2 transport boundary
- ADR 0002: Native sync and async separation
- ADR 0003: Provider and fetcher model
- ADR 0004: Bronze, Silver, and Gold
- ADR 0005: Canonical financial naming
- ADR 0006: Storage abstraction
- ADR 0007: Schema versioning
- ADR 0008: Hard public API replacement
- ADR 0010: Endpoint verification policy
- ADR 0011: Progress event architecture