{"id":27808,"library":"gheymat","title":"Gheymat","description":"Gheymat is a Python library for fetching currency, gold, and coin prices from Iranian markets. Version 0.3.8 requires Python >=3.7 and is actively maintained on GitHub.","status":"active","version":"0.3.8","language":"python","source_language":"en","source_url":"https://github.com/imrrobat/gheymat","tags":["currency","gold","coin","Iran","price","finance"],"install":[{"cmd":"pip install gheymat","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"HTTP requests to price APIs","package":"requests","optional":false},{"reason":"HTML parsing for some sources","package":"beautifulsoup4","optional":false}],"imports":[{"wrong":"from gheymat import get_price","symbol":"get_price","correct":"import gheymat"}],"quickstart":{"code":"from gheymat import get_price\n\nprice = get_price('USD')\nprint(price)  # e.g., 420000","lang":"python","description":"Fetch the price of USD (Iranian toman) using default settings."},"warnings":[{"fix":"Upgrade to >=0.3.0 and use from gheymat import get_price.","message":"In version 0.3.0, the API changed from class-based to function-based. get_price replaced Gheymat().get_price().","severity":"breaking","affected_versions":"<0.3.0"},{"fix":"Wrap calls in try/except and consider caching results.","message":"The library may fail or return stale data if the source website changes its structure. Always handle exceptions.","severity":"gotcha","affected_versions":"*"},{"fix":"Use symbol='USD' instead of currency='USD'.","message":"The 'currency' parameter in older versions is replaced by 'symbol' in 0.3.0+. Check your calls.","severity":"deprecated","affected_versions":"<0.3.0"}],"env_vars":null,"search_vec":"'0.3.8':18 '3.7':21 'activ':24 'coin':12,30 'currenc':9,28 'fetch':8 'financ':33 'gheymat':1,2 'github':27 'gold':10,29 'iran':31 'iranian':15 'librari':6 'maintain':25 'market':16 'price':13,32 'python':5,20 'requir':19 'version':17","created_at":"2026-05-09T05:52:11.992093+00:00","updated_at":"2026-05-09T05:52:11.992093+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/imrrobat/gheymat","docs":null,"changelog":null,"pypi":"https://pypi.org/project/gheymat/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}