تاریخچهٔ ارز و سکه از TGJU#

همهٔ دارایی‌ها با یک تابع گرفته می‌شن:

import oxtapus as ox

frame = ox.tgju.daily_prices("دلار", start="1402/10/11", end="1404/10/08")

دارایی‌های پشتیبانی‌شده#

نام فارسی	کد استاندارد	شناسهٔ داخلی منبع
دلار آزاد	`usd_irr`	`price_dollar_rl`
دلار نیما	`nima_usd_irr`	`nima_sell_usd`
یورو	`eur_irr`	`price_eur`
سکه امامی	`emami_gold_coin`	`sekee`
نیم‌سکه	`half_gold_coin`	`nim`

شناسهٔ داخلی منبع برای شفافیت و lineage در جدول اومده، اما ورودی API عمومی نیست. ورودی عمومی یا نام فارسیه یا کد استاندارد.

نرمال‌سازی نام فارسی#

این ورودی‌ها همگی بدون حساسیت به فاصله و نیم‌فاصله تشخیص داده می‌شن:

ox.tgju.daily_prices("نیم سکه")
ox.tgju.daily_prices("نیم‌سکه")
ox.tgju.daily_prices("  نیم   سکه  ")

ox.tgju.daily_prices("سکه امامی")
ox.tgju.daily_prices("سکه‌امامی")

شکل عربی «ی» و «ک»، فاصلهٔ غیرقابل‌شکستن و فاصله‌های تکراری هم نرمال می‌شن. نام مبهم «سکه» قبول نمی‌شه چون مشخص نمی‌کنه منظور کدوم نوع سکه است.

خروجی خطای قابل‌فهم#

اگر چیزی مثل "طلای آب شده" بدی، درخواست شبکه‌ای زده نمی‌شه. خطا مقدار اصلی واردشده و هر پنج دارایی مجاز رو نمایش می‌ده تا بتونی ورودی رو اصلاح کنی.

مسیر پیشرفته#

from oxtapus import Client

with Client() as client:
    result = client.assets.fetch_history("یورو", start="1402/10/11")

print(result.data)
print(result.retrieved_at)
print(result.source_schema_version)
print(result.quality_summary)

نقطهٔ پایانی فقط برای همین پنج نگاشت تأییدشده در دسترسه و URL یا شناسهٔ دلخواه نمی‌پذیره. شرایط استفاده و بازنشر داده‌ها رو باید جداگانه با مقررات منبع و نوع کاربرد خودت تطبیق بدی.

برای استفاده از خط فرمان هم همین ورودی‌ها معتبرن:

oxtapus fetch tgju daily-prices 'دلار نیما' --start 1403/10/12